New-AzureSSHKey
Crée un objet ssh Key pour insérer un certificat existant dans une nouvelle machine virtuelle Azure basée sur Linux.
Remarque
Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Azure Service Manager (ASM). Ce module PowerShell hérité n’est pas recommandé lors de la création de ressources, car ASM est planifié pour la mise hors service. Pour plus d’informations, consultez la mise hors service d’Azure Service Manager.
Le module Az PowerShell est le module PowerShell recommandé pour la gestion des ressources Azure Resource Manager (ARM) avec PowerShell.
Syntaxe
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 |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | 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
- Demander
- SilentlyContinue
- Stop
- Suspendre
Type: | ActionPreference |
Alias: | infa |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-InformationVariable
Spécifie une variable d’informations.
Type: | String |
Alias: | iv |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | 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 |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | 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 |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | 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 |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |