Udostępnij przez

Enter-AzVM

  • Wersja zapoznawcza
Moduł:
Az.Ssh Module

To polecenie cmdlet jest częścią modułu w wersji zapoznawczej . Wersje zapoznawcze nie są zalecane do użycia w środowiskach produkcyjnych. Aby uzyskać więcej informacji, zobacz https://aka.ms/azps-refstatus.

Uruchamia interakcyjną sesję SSH do zasobu platformy Azure (na przykład maszyn wirtualnych platformy Azure lub serwerów Arc). Użytkownicy mogą logować się przy użyciu kont Microsoft Entra lub kont użytkowników lokalnych za pośrednictwem standardowego uwierzytelniania SSH. Użyj nazwy logowania do konta Microsoft Entra, aby uzyskać najlepsze zabezpieczenia i wygodę.

Składnia

Interactive (domyślnie) 

Enter-AzVM
    -ResourceGroupName <String>
    -Name <String>
    [-PublicKeyFile <String>]
    [-PrivateKeyFile <String>]
    [-UsePrivateIp]
    [-LocalUser <String>]
    [-Port <String>]
    [-ResourceType <String>]
    [-CertificateFile <String>]
    [-SshArgument <String[]>]
    [-Rdp]
    [-PassThru]
    [-Force]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

IpAddress 

Enter-AzVM
    -Ip <String>
    [-PublicKeyFile <String>]
    [-PrivateKeyFile <String>]
    [-LocalUser <String>]
    [-Port <String>]
    [-CertificateFile <String>]
    [-SshArgument <String[]>]
    [-Rdp]
    [-PassThru]
    [-Force]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

ResourceId 

Enter-AzVM
    -ResourceId <String>
    [-PublicKeyFile <String>]
    [-PrivateKeyFile <String>]
    [-UsePrivateIp]
    [-LocalUser <String>]
    [-Port <String>]
    [-CertificateFile <String>]
    [-SshArgument <String[]>]
    [-Rdp]
    [-PassThru]
    [-Force]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Opis

Rozpocznij interaktywną sesję SSH do zasobu platformy Azure (obecnie obsługuje maszyny wirtualne platformy Azure i serwery Arc). Użytkownicy mogą logować się przy użyciu certyfikatów wystawionych przez firmę Microsoft lub przy użyciu poświadczeń użytkownika lokalnego. Jeśli to możliwe, zalecamy logowanie przy użyciu certyfikatów wystawionych przez firmę Microsoft Entra. Ważna uwaga: podczas nawiązywania połączenia z zasobami usługi Azure Arc to polecenie cmdlet wymaga również zainstalowania modułu Az.Ssh.ArcProxy na komputerze klienckim. Polecenie cmdlet podejmie próbę zainstalowania modułu z galerii programu PowerShell, ale użytkownik ma również możliwość samodzielnego zainstalowania modułu. Ważne jest, aby użytkownik miał również uprawnienia do wykonywania plików proxy w module Az.Ssh.ArcProxy lub połączenie zakończy się niepowodzeniem. Moduł Az.Ssh.ArcServer można znaleźć w Galeria programu PowerShell: https://aka.ms/PowerShellGallery-Az.Ssh.ArcProxy.

Przykłady

Przykład 1. Nawiązywanie połączenia z zasobem platformy Azure przy użyciu certyfikatów wystawionych przez firmę Microsoft

Enter-AzVM -ResourceGroupName myRg -Name myMachine

Jeśli nie podano -LocalUser, polecenie cmdlet podejmie próbę zalogowania się przy użyciu identyfikatora Entra firmy Microsoft. Jest to obecnie obsługiwane tylko w przypadku zasobów z systemem operacyjnym Linux.

Przykład 2. Nawiązywanie połączenia z użytkownikiem lokalnym w zasobie platformy Azure przy użyciu certyfikatów SSH na potrzeby uwierzytelniania

Enter-AzVM -ResourceGroupName myRg -Name myMachine -LocalUser azureuser -PrivateKeyFile ./id_rsa -CertificateFile ./cert

Przykład 3. Nawiązywanie połączenia z użytkownikiem lokalnym w zasobie platformy Azure przy użyciu klucza prywatnego SSH na potrzeby uwierzytelniania

Enter-AzVM -ResourceGroupName myRg -Name myMachine -LocalUser azureuser -PrivateKeyFile ./id_rsa

Przykład 4. Nawiązywanie połączenia z użytkownikiem lokalnym w zasobie platformy Azure przy użyciu interakcyjnej nazwy użytkownika i uwierzytelniania haseł

Enter-AzVM -ResourceGroupName myRg -Name myMachine -LocalUser azureuser

Przykład 5. Nawiązywanie połączenia z publicznym adresem IP maszyny wirtualnej platformy Azure przy użyciu certyfikatów wystawionych przez firmę Microsoft Entra

Enter-AzVM -Ip 1.2.3.4

Przykład 6. Podaj typ zasobu obiektu docelowego.

Enter-AzVM -ResourceGroupName myRg -Name myMachine -ResourceType Microsoft.HybridCompute/machines

Ten parametr jest przydatny, gdy istnieje więcej niż jeden obsługiwany zasób o tej samej nazwie w grupie zasobów.

Przykład 7. Nawiązywanie połączenia z zasobem platformy Azure przy użyciu certyfikatu firmy Microsoft Entra wystawiane certyfikaty i pliki kluczy niestandardowych

Enter-AzVM -ResourceGroupName myRg -Name myMachine -PrivateKeyFile ./id_rsa -PublicKeyFile ./id_rsa.pub

Jeśli nie podano niestandardowych plików kluczy, polecenie cmdlet wygeneruje parę kluczy.

Przykład 8. Uruchom połączenie RDP za pośrednictwem połączenia SSH.

Enter-AzVM -ResourceGroupName myRg -Name myMachine -LocalUser username -Rdp

Ten parametr jest przydatny do tworzenia sesji RDP dla zasobu usługi Arc za pośrednictwem platformy łączności arc.

Parametry

-CertificateFile

Certyfikat SSH używany do uwierzytelniania na koncie użytkownika lokalnego.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Właściwości parametru

Typ:IAzureContextContainer
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:AzContext, AzureRmContext, AzureCredential

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Force

Podczas nawiązywania połączenia z zasobami usługi Arc nie monituj o potwierdzenie przed zaktualizowaniem dozwolonego portu dla połączenia SSH w punkcie końcowym połączenia, aby dopasować port docelowy lub zainstalować moduł Az.Ssh.ArcProxy z galerii programu PowerShell, jeśli jest to konieczne.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Ip

Adres IP docelowej maszyny wirtualnej platformy Azure.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

IpAddress
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-LocalUser

Nazwa użytkownika lokalnego w zasobie docelowym.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Name

Nazwa docelowego zasobu platformy Azure.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

Interactive
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-PassThru

Zwraca wartość true, jeśli połączenie zakończy się pomyślnie.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Port

Port do nawiązania połączenia na hoście zdalnym.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-PrivateKeyFile

Ścieżka do pliku klucza prywatnego.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-PublicKeyFile

Ścieżka do pliku klucza publicznego.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Rdp

Uruchom połączenie RDP za pośrednictwem połączenia SSH. Obsługiwane tylko w systemie operacyjnym Windows.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ResourceGroupName

Nazwa grupy zasobów.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

Interactive
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-ResourceId

Identyfikator zasobu docelowego.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

ResourceId
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-ResourceType

Typ zasobu docelowego.

Właściwości parametru

Typ:String
Domyślna wartość:None
Dopuszczalne wartości:Microsoft.HybridCompute/machines, Microsoft.Compute/virtualMachines, Microsoft.ConnectedVMwarevSphere/virtualMachines, Microsoft.ScVmm/virtualMachines, Microsoft.AzureStackHCI/virtualMachines
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

Interactive
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-SshArgument

Dodatkowe argumenty SSH przekazane do protokołu OpenSSH.

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-UsePrivateIp

Podczas nawiązywania połączenia z maszyną wirtualną platformy Azure ta flaga określa, że powinna łączyć się z jednym z prywatnych adresów IP maszyny wirtualnej. Wymaga łączności z prywatnym adresem IP.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

Interactive
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False
ResourceId
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

String

String

Dane wyjściowe

Boolean