New-AzureSSHKey

  • Odwołanie
Moduł:
Azure

Tworzy obiekt klucza SSH w celu wstawienia istniejącego certyfikatu do nowych maszyn wirtualnych platformy Azure opartych na systemie Linux.

Uwaga

Polecenia cmdlet, do których odwołuje się ta dokumentacja, służą do zarządzania starszymi zasobami platformy Azure korzystającymi z interfejsów API programu Azure Service Manager (ASM). Ten starszy moduł programu PowerShell nie jest zalecany podczas tworzenia nowych zasobów, ponieważ usługa ASM ma zostać wycofana. Aby uzyskać więcej informacji, zobacz Wycofywanie programu Azure Service Manager.

Moduł Az programu PowerShell jest zalecanym modułem programu PowerShell do zarządzania zasobami usługi Azure Resource Manager (ARM) przy użyciu programu PowerShell.

Składnia

New-AzureSSHKey
   [-KeyPair]
   [-Fingerprint] <String>
   [-Path] <String>
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
New-AzureSSHKey
   [-PublicKey]
   [-Fingerprint] <String>
   [-Path] <String>
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Opis

Polecenie cmdlet New-AzureSSHKey tworzy obiekt klucza SSH dla certyfikatu, który został już dodany do platformy Azure. Ten obiekt klucza SSH może być następnie używany przez polecenie New-AzureProvisioningConfig podczas tworzenia obiektu konfiguracji dla nowej maszyny wirtualnej przy użyciu maszyny wirtualnej New-AzureVM lub podczas tworzenia nowej maszyny wirtualnej za pomocą polecenia New-AzureQuickVM. W przypadku dołączenia jako części skryptu tworzenia maszyny wirtualnej spowoduje to dodanie określonego klucza publicznego lub pary kluczy SSH do nowej maszyny wirtualnej.

Przykłady

Przykład 1. Tworzenie obiektu ustawienia certyfikatu

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

To polecenie tworzy obiekt ustawienia certyfikatu dla istniejącego certyfikatu, a następnie przechowuje obiekt w zmiennej do późniejszego użycia.

Przykład 2. Dodawanie certyfikatu do usługi

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"

To polecenie dodaje certyfikat do usługi platformy Azure, a następnie tworzy nową maszynę wirtualną z systemem Linux, która używa certyfikatu.

Parametry

-Fingerprint

Określa odcisk palca certyfikatu.

Typ:String
Position:1
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-InformationAction

Określa, jak to polecenie cmdlet reaguje na zdarzenie informacyjne.

Dopuszczalne wartości tego parametru to:

  • Kontynuuj
  • Ignoruj
  • Zapytać
  • SilentlyContinue
  • Zatrzymaj
  • Wstrzymanie
Typ:ActionPreference
Aliasy:infa
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-InformationVariable

Określa zmienną informacyjną.

Typ:String
Aliasy:iv
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-KeyPair

Określa, że to polecenie cmdlet tworzy obiekt do wstawiania pary kluczy SSH do nowej konfiguracji maszyny wirtualnej.

Typ:SwitchParameter
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Path

Określa ścieżkę do przechowywania klucza publicznego lub pary kluczy SSH.

Typ:String
Position:2
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PublicKey

Określa, że to polecenie cmdlet tworzy obiekt do wstawiania klucza publicznego SSH do nowej konfiguracji maszyny wirtualnej.

Typ:SwitchParameter
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False