Freigeben über


New-AzureSSHKey

Erstellt ein SSH Key -Objekt, um ein vorhandenes Zertifikat in einen neuen virtuellen Azure-Basierten Azure-Computer einzufügen.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Azure Dienst-Manager (ASM) APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.

Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit 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>]

Beschreibung

Das Cmdlet New-AzureSSHKey erstellt ein SSH-Schlüsselobjekt für ein Zertifikat, das azure bereits hinzugefügt wurde. Dieses SSH-Schlüsselobjekt kann dann von New-AzureProvisioningConfig verwendet werden, wenn das Konfigurationsobjekt für einen neuen virtuellen Computer mithilfe von New-AzureVM oder beim Erstellen eines neuen virtuellen Computers mit New-AzureQuickVM erstellt wird. Wenn sie als Teil eines Skripts für die Erstellung eines virtuellen Computers enthalten ist, wird dadurch der angegebene öffentliche SSH-Schlüssel oder das Schlüsselpaar dem neuen virtuellen Computer hinzugefügt.

Beispiele

Beispiel 1: Erstellen eines Zertifikateinstellungsobjekts

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

Mit diesem Befehl wird ein Zertifikateinstellungsobjekt für ein vorhandenes Zertifikat erstellt und anschließend das Objekt zur späteren Verwendung in einer Variablen gespeichert.

Beispiel 2: Hinzufügen eines Zertifikats zu einem Dienst

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"

Dieser Befehl fügt einem Azure-Dienst ein Zertifikat hinzu und erstellt dann einen neuen virtuellen Linux-Computer, der das Zertifikat verwendet.

Parameter

-Fingerprint

Gibt den Fingerabdruck des Zertifikats an.

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InformationAction

Gibt an, wie dieses Cmdlet auf ein Informationsereignis reagiert.

Zulässige Werte für diesen Parameter:

  • Fortsetzen
  • Ignorieren
  • Inquire
  • SilentlyContinue
  • Beenden
  • Angehalten
Typ:ActionPreference
Aliase:infa
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InformationVariable

Gibt eine Informationsvariable an.

Typ:String
Aliase:iv
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-KeyPair

Gibt an, dass dieses Cmdlet ein Objekt zum Einfügen eines SSH-Schlüsselpaars in die konfiguration des neuen virtuellen Computers erstellt.

Typ:SwitchParameter
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Path

Gibt den Pfad zum Speichern des öffentlichen SSH-Schlüssel- oder Schlüsselpaars an.

Typ:String
Position:2
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PublicKey

Gibt an, dass dieses Cmdlet ein Objekt zum Einfügen eines öffentlichen SSH-Schlüssels in die konfiguration des neuen virtuellen Computers erstellt.

Typ:SwitchParameter
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False