New-AzureSSHKey

Crée un objet ssh Key pour insérer un certificat existant dans une nouvelle machine virtuelle Azure basée sur Linux.

Notes

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Gestion des services. Pour ce qui est des cmdlets permettant de gérer des ressources Azure Resource Manager, consultez le Module Az PowerShell.

Syntax

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

L’applet de commande New-AzureSSHKey crée un objet SSH Key pour un certificat qui a déjà été ajouté à Azure. Cet objet de clé SSH peut ensuite être utilisé par New-AzureProvisioningConfig lors de la création de l’objet de configuration d’une nouvelle machine virtuelle à l’aide de New-AzureVM ou lors de la création d’une machine virtuelle avec New-AzureQuickVM. Lorsqu’il est inclus dans le cadre d’un script de création de machine virtuelle, cela ajoute la clé publique SSH ou la paire de clés spécifiée à la nouvelle machine virtuelle.

Exemples

Exemple 1 : Créer un objet de paramètre de certificat

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

Cette commande crée un objet de paramètre de certificat pour un certificat existant, puis stocke l’objet dans une variable pour une utilisation ultérieure.

Exemple 2 : Ajouter un certificat à un service

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"

Cette commande ajoute un certificat à un service Azure, puis crée une machine virtuelle Linux qui utilise le certificat.

Paramètres

-Fingerprint

Spécifie l’empreinte digitale du certificat.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InformationAction

Spécifie la façon dont cette applet de commande répond à un événement d’information.

Les valeurs valides pour ce paramètre sont :

  • Continuer
  • Ignorer
  • Renseignez-vous
  • SilentlyContinue
  • Arrêter
  • Suspendre
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Spécifie une variable d’informations.

Type:String
Aliases:iv
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-KeyPair

Spécifie que cette applet de commande crée un objet pour l’insertion d’une paire de clés SSH dans la nouvelle configuration de machine virtuelle.

Type:SwitchParameter
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Path

Spécifie le chemin d’accès pour stocker la clé publique SSH ou la paire de clés.

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PublicKey

Spécifie que cette applet de commande crée un objet pour l’insertion d’une clé publique SSH dans la nouvelle configuration de machine virtuelle.

Type:SwitchParameter
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False