Delen via

New-AzureSSHKey

  • Referentie
Module:
Azure

Hiermee maakt u een SSH-sleutelobject om een bestaand certificaat in te voegen in een nieuwe virtuele Azure-machines op basis van Linux.

Notitie

De cmdlets waarnaar in deze documentatie wordt verwezen, zijn bedoeld voor het beheren van verouderde Azure-resources die gebruikmaken van Service Management-API's. Zie de Az PowerShell-module voor cmdlets voor het beheren van Azure Resource Manager-resources.

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

De cmdlet New-AzureSSHKey maakt een SSH-sleutelobject voor een certificaat dat al is toegevoegd aan Azure. Dit SSH-sleutelobject kan vervolgens worden gebruikt door New-AzureProvisioningConfig bij het maken van het configuratieobject voor een nieuwe virtuele machine met behulp van New-AzureVM of bij het maken van een nieuwe virtuele machine met New-AzureQuickVM. Wanneer deze wordt opgenomen als onderdeel van een script voor het maken van een virtuele machine, wordt hiermee de opgegeven openbare SSH-sleutel of sleutelpaar toegevoegd aan de nieuwe virtuele machine.

Voorbeelden

Voorbeeld 1: Een certificaatinstellingsobject maken

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

Met deze opdracht maakt u een certificaatinstellingsobject voor een bestaand certificaat en slaat u het object vervolgens op in een variabele voor later gebruik.

Voorbeeld 2: Een certificaat toevoegen aan een 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"

Met deze opdracht wordt een certificaat toegevoegd aan een Azure-service en wordt vervolgens een nieuwe virtuele Linux-machine gemaakt die gebruikmaakt van het certificaat.

Parameters

-Fingerprint

Hiermee geeft u de vingerafdruk van het certificaat.

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

-InformationAction

Hiermee geeft u op hoe deze cmdlet reageert op een informatie-gebeurtenis.

De acceptabele waarden voor deze parameter zijn:

  • Doorgaan
  • Negeren
  • Informeren
  • SilentlyContinue
  • Stoppen
  • Onderbreken
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Hiermee geeft u een informatievariabele op.

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

-KeyPair

Hiermee geeft u op dat met deze cmdlet een object wordt gemaakt voor het invoegen van een SSH-sleutelpaar in de nieuwe configuratie van de virtuele machine.

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

-Path

Hiermee geeft u het pad op voor het opslaan van de openbare SSH-sleutel of sleutelpaar.

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

-PublicKey

Hiermee geeft u op dat met deze cmdlet een object wordt gemaakt voor het invoegen van een openbare SSH-sleutel in de nieuwe configuratie van de virtuele machine.

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