Enter-AzVM

  • Wersja Preview
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 Azure (na przykład maszyn wirtualnych 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 Microsoft Entra identyfikatora logowania do konta, 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

Uruchom interaktywną sesję SSH do zasobu Azure (obecnie obsługuje maszyny wirtualne Azure i serwery Arc). Użytkownicy mogą logować się przy użyciu Microsoft Entra wystawionych certyfikatów lub przy użyciu poświadczeń użytkownika lokalnego. Zalecamy logowanie przy użyciu Microsoft Entra wystawionych certyfikatów, jeśli jest to możliwe. Ważna uwaga: podczas nawiązywania połączenia z zasobami 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 Galeria 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 Azure przy użyciu Microsoft Entra wystawionych certyfikatów

Enter-AzVM -ResourceGroupName myRg -Name myMachine

Gdy nie podano -LocalUser, polecenie cmdlet podejmie próbę zalogowania się przy użyciu Microsoft Entra ID. 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 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 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 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 Azure przy użyciu Microsoft Entra wystawionych certyfikatów

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 Azure przy użyciu certyfikatu Microsoft Entra wystawionych certyfikatów i plików 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ązkowy: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 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ązkowy: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 Galeria programu PowerShell w razie potrzeby.

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ązkowy: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 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ązkowy: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ązkowy: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 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ązkowy: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ązkowy: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ązkowy: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ązkowy: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ązkowy: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ązkowy: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ązkowy: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ązkowy: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ązkowy: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ązkowy: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ą 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ązkowy: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ązkowy: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