New-AzureSSHKey

  • Referência
Módulo:
Azure

Cria um objeto de chave SSH para inserir um certificado existente em novas máquinas virtuais do Azure baseadas em Linux.

Nota

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 do PowerShell herdado não é recomendado ao criar novos recursos, uma vez que o ASM está agendado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.

O módulo Az PowerShell é o módulo 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 SSH Key para um certificado que já foi adicionado ao Azure. Esse objeto SSH Key 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"

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

Este 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
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-InformationAction

Especifica como esse cmdlet responde a um evento de informação.

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

  • Continuar
  • Ignorar
  • Informe-se
  • SilenciosamenteContinue
  • Parar
  • Suspender
Tipo:ActionPreference
Aliases:infa
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-InformationVariable

Especifica uma variável de informação.

Tipo:String
Aliases:iv
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Path

Especifica o caminho para armazenar a Chave Pública SSH ou o Par de Chaves.

Tipo:String
Position:2
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False