New-AzureSSHKey
Cria um objeto de chave SSH para inserir um certificado existente em novas máquinas virtuais do Azure baseadas em Linux.
Observação
Os cmdlets referenciados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo herdado do PowerShell não é recomendado ao criar novos recursos, pois o ASM está agendado para desativação. Para obter mais informações, confira a desativação do Azure Service Manager.
O módulo do Az PowerShell é o módulo recomendado do PowerShell para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.
Sintaxe
New-AzureSSHKey
[-KeyPair]
[-Fingerprint] <String>
[-Path] <String>
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] New-AzureSSHKey
[-PublicKey]
[-Fingerprint] <String>
[-Path] <String>
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Description
O cmdlet New-AzureSSHKey cria um objeto de chave SSH para um certificado que já foi adicionado ao Azure. Esse objeto de chave SSH pode ser usado por New-AzureProvisioningConfig ao criar o objeto de configuração para uma nova máquina virtual usando New-AzureVM ou ao criar uma nova máquina virtual com New-AzureQuickVM. Quando incluído como parte de um script de criação de máquina virtual, isso adiciona a chave pública SSH ou o par de chaves especificado à nova máquina virtual.
Exemplos
Exemplo 1: Criar um objeto de configuração de certificado
PS C:\> $myLxCert = New-AzureSSHKey -Fingerprint "D7BECD4D63EBAF86023BB4F1A5FBF5C2C924902A" -Path "/home/username/.ssh/authorized_keys"Esse comando cria um objeto de configuração de certificado para um certificado existente e, em seguida, armazena o objeto em uma variável para uso posterior.
Exemplo 2: Adicionar um certificado a um serviço
PS C:\> Add-AzureCertificate -ServiceName "MySvc" -CertToDeploy "C:\temp\MyLxCert.cer"
$myLxCert = New-AzureSSHKey ?Fingerprint "D7BECD4D63EBAF86023BB4F1A5FBF5C2C924902A" -Path "/home/username/.ssh/authorized_keys"
New-AzureVMConfig -Name "MyVM2" -InstanceSize Small -ImageName $LxImage `
| Add-AzureProvisioningConfig -Linux -LinuxUser $lxUser -SSHPublicKeys $myLxCert -Password 'pass@word1' `
| New-AzureVM -ServiceName "MySvc"Esse comando adiciona um certificado a um serviço do Azure e, em seguida, cria uma nova máquina virtual Linux que usa o certificado.
Parâmetros
-Fingerprint
Especifica a impressão digital do certificado.
| Tipo: | String |
| Cargo: | 1 |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-InformationAction
Especifica como esse cmdlet responde a um evento de informação.
Os valores aceitáveis para esse parâmetro são:
- Continuar
- Ignorar
- Perguntar
- SilentlyContinue
- Stop
- Suspend
| Tipo: | ActionPreference |
| Aliases: | infa |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-InformationVariable
Especifica uma variável de informação.
| Tipo: | String |
| Aliases: | iv |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-KeyPair
Especifica que esse cmdlet cria um objeto para inserir um par de chaves SSH na nova configuração da máquina virtual.
| Tipo: | SwitchParameter |
| Cargo: | 0 |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Path
Especifica o caminho para armazenar a chave pública SSH ou o par de chaves.
| Tipo: | String |
| Cargo: | 2 |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-PublicKey
Especifica que esse cmdlet cria um objeto para inserir uma chave pública SSH na nova configuração da máquina virtual.
| Tipo: | SwitchParameter |
| Cargo: | 0 |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |