New-AzSftpCertificate

New-AzSftpCertificate
    [-CertificatePath <String>]
    [-PrivateKeyFile <String>]
    [-SshClientFolder <String>]
    [-Force]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

New-AzSftpCertificate
    -PublicKeyFile <String>
    [-CertificatePath <String>]
    [-SshClientFolder <String>]
    [-Force]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

New-AzSftpCertificate
    -PrivateKeyFile <String>
    [-CertificatePath <String>]
    [-SshClientFolder <String>]
    [-Force]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

New-AzSftpCertificate
    -LocalUser <String>
    [-CertificatePath <String>]
    [-PrivateKeyFile <String>]
    [-SshClientFolder <String>]
    [-Force]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

O New-AzSftpCertificate cmdlet gera certificados SSH para autenticação SFTP usando as suas credenciais Microsoft Entra atuais. Este cmdlet fornece os mesmos métodos de autenticação e conjuntos de parâmetros que o módulo Az.Ssh, garantindo consistência entre os módulos Azure PowerShell.

O cmdlet oferece suporte a quatro modos de autenticação que se alinham com o módulo SSH:

Modo Padrão (Autenticação Microsoft Entra): Quando não são fornecidos ficheiros de chave específicos, o cmdlet gera automaticamente um novo par de chaves SSH e cria um certificado assinado pela CA de confiança da Microsoft Entra. Esta é a abordagem mais simples para começar a usar a autenticação SFTP.

FromPublicKey Mode: Quando é fornecido um ficheiro de chave pública, o cmdlet gera um certificado para essa chave específica usando Microsoft Entra credenciais. Isto é útil quando já tens chaves públicas SSH e queres usá-las para acesso SFTP ao Armazenamento do Azure.

FromPrivateKey Mode: Quando é fornecido um ficheiro de chave privada, o cmdlet gera a chave pública correspondente e cria um certificado usando Microsoft Entra credenciais. Isso é útil quando você tem chaves privadas existentes e deseja criar certificados para elas.

Modo LocalUser: Quando um usuário local é especificado, o cmdlet gera um certificado adequado para autenticação de usuário local em contas de armazenamento. Isso pode ser combinado com chaves privadas existentes ou gerar novas, correspondendo aos recursos de certificado de usuário local do módulo SSH.

Os certificados gerados são normalmente válidos por 1 hora e podem ser usados com qualquer cliente SFTP que suporte autenticação de certificado SSH. Os certificados são assinados pela CA de confiança da Microsoft Entra e serão aceites por contas do Armazenamento do Azure onde a sua identidade Microsoft Entra tiver as permissões apropriadas.

Deve estar iniciado no Azure com uma conta que tenha permissões RBAC apropriadas (como Contribuidor de Dados de Blob de Armazenamento ou Proprietário de Dados de Blob de Armazenamento) nas contas de armazenamento de destino.

New-AzSftpCertificate

Este comando gera um novo par de chaves SSH e cria um certificado assinado pela Microsoft Entra. O par de chaves e o certificado são salvos no diretório temp do sistema com nomes de arquivos gerados automaticamente. Esta é a maneira mais simples de começar a usar a autenticação SFTP.

New-AzSftpCertificate -CertificatePath "C:\certs\azure-sftp.cert"

Este comando gera um novo par de chaves SSH e cria um certificado, salvando o certificado no caminho especificado. As chaves pública e privada serão salvas no mesmo diretório com os nomes correspondentes (azure-sftp e azure-sftp.pub).

New-AzSftpCertificate -PrivateKeyFile "C:\keys\id_rsa" -CertificatePath "C:\certs\id_rsa.cert"

Este comando gera um certificado a partir de uma chave privada SSH existente. O cmdlet irá automaticamente derivar a chave pública a partir da chave privada e criar um certificado assinado pela Microsoft Entra. Isso é útil quando você tem chaves privadas existentes e deseja criar certificados para elas.

New-AzSftpCertificate -PublicKeyFile "C:\keys\id_rsa.pub" -CertificatePath "C:\certs\id_rsa.cert"

Este comando gera um certificado a partir de uma chave pública SSH existente. Isso é útil quando você deseja criar certificados para chaves públicas existentes que já estão configuradas em contas de armazenamento.

New-AzSftpCertificate -LocalUser "sftpuser" -CertificatePath "C:\certs\localuser.cert"

Este comando gera um certificado adequado para autenticação de usuário local em contas de armazenamento. Um novo par de chaves é gerado e o certificado é configurado para o usuário local especificado. Isso se alinha com os recursos de autenticação de usuário local do módulo SSH.

New-AzSftpCertificate -LocalUser "sftpuser" -PrivateKeyFile "C:\keys\existing_key" -CertificatePath "C:\certs\localuser.cert"

Este comando gera um certificado para autenticação de usuário local usando uma chave privada existente. Isso é útil quando você deseja usar chaves específicas para autenticação de usuário local em contas de armazenamento.

$cert = New-AzSftpCertificate
Write-Host "Certificate: $($cert.CertificatePath)"
Write-Host "Private Key: $($cert.PrivateKeyPath)"
Write-Host "Valid Until: $($cert.ValidUntil)"

Este comando gera um certificado com geração automática de chaves e caminhos de arquivo temporários. O objeto retornado contém todos os caminhos de arquivo e informações de certificado, facilitando o uso programático.

# Generate certificate for local user
$cert = New-AzSftpCertificate -LocalUser "sftpuser" -CertificatePath "C:\certs\sftp-auth.cert"

# Use the certificate to connect to storage account
$process = Connect-AzSftp -StorageAccount "mystorageaccount" -LocalUser "sftpuser" -PrivateKeyFile $cert.PrivateKeyPath

# Display connection info
Write-Host "SFTP connection established using certificate: $($cert.CertificatePath)"
Write-Host "Process ID: $($process.Id)"

Este exemplo demonstra o fluxo de trabalho completo de gerar um certificado e usá-lo imediatamente para conexão SFTP, mostrando a integração entre os dois cmdlets.

New-AzSftpCertificate -CertificatePath "C:\certs\custom-cert.pub" -SshClientFolder "C:\Program Files\OpenSSH"

Este comando gera um certificado usando executáveis SSH de um local específico. Isso é útil quando você tem várias implementações SSH instaladas ou quando ssh-keygen não está no PATH padrão.

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.