Udostępnij za pośrednictwem


New-AzureSSHKey

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
wartość domyślna:None
Wymagane:True
Accept pipeline input:False
Accept wildcard characters: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
Aliases:infa
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Określa zmienną informacyjną.

Typ:String
Aliases:iv
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-KeyPair

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

Typ:SwitchParameter
Position:0
wartość domyślna:None
Wymagane:True
Accept pipeline input:False
Accept wildcard characters:False

-Path

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

Typ:String
Position:2
wartość domyślna:None
Wymagane:True
Accept pipeline input:False
Accept wildcard characters:False

-PublicKey

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

Typ:SwitchParameter
Position:0
wartość domyślna:None
Wymagane:True
Accept pipeline input:False
Accept wildcard characters:False