New-AzureSSHKey

  • Referência
Módulo:
Azure

Cria um objeto SSH Key para inserir um certificado existente em uma nova máquina virtual do Azure baseada em Linux.

Observação

Os cmdlets mencionados 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, já que o ASM está programado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.

O módulo Az PowerShell é o módulo do PowerShell recomendado 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 especificada ou o Par de Chaves à 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 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ções.

Os valores aceitáveis para esse parâmetro são:

  • Continuar
  • Ignorar
  • Perguntar
  • SilentlyContinue
  • Parar
  • 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 de 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 de máquina virtual.

Tipo:SwitchParameter
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False