Compartir a través de

New-AzureSSHKey

  • Referencia
Módulo:
Azure

Crea un objeto de clave SSH para insertar un certificado existente en una nueva máquina virtual de Azure basada en Linux.

Nota:

Los cmdlets a los que se hace referencia en esta documentación son para administrar recursos de Azure heredados que usan las API de Azure Service Management (ASM). Este módulo heredado de PowerShell no se recomienda al crear nuevos recursos, ya que ASM está programado para la retirada. Para más información, consulte Retirada de Azure Service Manager.

El módulo Az de PowerShell es el módulo de PowerShell recomendado para administrar recursos de Azure Resource Manager (ARM) con PowerShell.

Sintaxis

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

El cmdlet New-AzureSSHKey crea un objeto de clave SSH para un certificado que ya se ha agregado a Azure. A continuación, New-AzureProvisioningConfig puede usar este objeto de clave SSH al crear el objeto de configuración para una nueva máquina virtual mediante New-AzureVM o al crear una nueva máquina virtual con New-AzureQuickVM. Cuando se incluye como parte de un script de creación de máquinas virtuales, esto agrega la clave pública o el par de claves SSH especificados a la nueva máquina virtual.

Ejemplos

Ejemplo 1: Crear un objeto de configuración de certificado

PS C:\> $myLxCert = New-AzureSSHKey -Fingerprint "D7BECD4D63EBAF86023BB4F1A5FBF5C2C924902A" -Path "/home/username/.ssh/authorized_keys"

Este comando crea un objeto de configuración de certificado para un certificado existente y, a continuación, almacena el objeto en una variable para su uso posterior.

Ejemplo 2: Agregar un certificado a un servicio

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 agrega un certificado a un servicio de Azure y, a continuación, crea una nueva máquina virtual Linux que usa el certificado.

Parámetros

-Fingerprint

Especifica la huella digital del certificado.

Tipo:String
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InformationAction

Especifica cómo responde este cmdlet a un evento de información.

Los valores permitidos para este parámetro son los siguientes:

  • Continuar
  • Ignore
  • Inquire
  • SilentlyContinue
  • Detención
  • Suspender
Tipo:ActionPreference
Alias:infa
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InformationVariable

Especifica una variable de información.

Tipo:String
Alias:iv
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-KeyPair

Especifica que este cmdlet crea un objeto para insertar un par de claves SSH en la nueva configuración de máquina virtual.

Tipo:SwitchParameter
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Path

Especifica la ruta de acceso para almacenar la clave pública SSH o el par de claves.

Tipo:String
Posición:2
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PublicKey

Especifica que este cmdlet crea un objeto para insertar una clave pública SSH en la nueva configuración de máquina virtual.

Tipo:SwitchParameter
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False