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 cmdlet New-AzSftpCertificate gera certificados SSH para autenticação SFTP usando suas credenciais de Microsoft Entra atuais. Esse cmdlet fornece os mesmos métodos de autenticação e conjuntos de parâmetros que o módulo Az.Ssh, garantindo a consistência entre Azure PowerShell módulos.

O cmdlet dá suporte a quatro modos de autenticação que se alinham ao módulo SSH:

Default Mode (Microsoft Entra Authentication): quando nenhum arquivo de chave específico é fornecido, o cmdlet gera automaticamente um novo par de chaves SSH e cria um certificado assinado pela AC confiável do Microsoft Entra. Essa é a abordagem mais simples para começar a usar a autenticação SFTP.

FromPublicKey Mode: quando um arquivo de chave pública é fornecido, o cmdlet gera um certificado para essa chave específica usando credenciais Microsoft Entra. Isso é útil quando você já tem chaves públicas SSH e deseja usá-las para Armazenamento do Azure acesso SFTP.

FromPrivateKey Mode: quando um arquivo de chave privada é fornecido, o cmdlet gera a chave pública correspondente e cria um certificado usando credenciais Microsoft Entra. 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 normalmente são válidos por 1 hora e podem ser usados com qualquer cliente SFTP que dê suporte à autenticação de certificado SSH. Os certificados são assinados pela AC confiável do Microsoft Entra e serão aceitos por Armazenamento do Azure contas em que sua identidade Microsoft Entra tiver permissões apropriadas.

Você deve estar conectado ao Azure com uma conta que tenha permissões RBAC apropriadas (como Colaborador de Dados de Blobs de Armazenamento ou Proprietário de Dados de Blobs de Armazenamento) nas contas de armazenamento de destino.

New-AzSftpCertificate

Esse comando gera um novo par de chaves SSH e cria um certificado assinado por Microsoft Entra. O par de chaves e o certificado são salvos no diretório temporário do sistema com nomes de arquivo gerados automaticamente. Essa é a maneira mais simples de começar a usar a autenticação SFTP.

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

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

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

Esse comando gera um certificado de uma chave privada SSH existente. O cmdlet derivará automaticamente a chave pública da chave privada e criará um certificado assinado por 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"

Esse comando gera um certificado 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"

Esse 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 aos 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"

Esse 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)"

Esse 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 programaticamente.

# 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"

Esse comando gera um certificado usando executáveis SSH de um local específico. Isso é útil quando você tem várias implementações de 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.