Enter-AzVM

Modul:

Az.Ssh

Startet eine interaktive SSH-Sitzung mit einer Azure-Ressource (z. B. Azure-VMs oder Arc-Server). Benutzer können sich mit Microsoft Entra-Konten oder lokalen Benutzerkonten über die standardmäßige SSH-Authentifizierung anmelden. Verwenden Sie die Microsoft Entra-Kontoanmeldung für optimale Sicherheit und Komfort.

Syntax

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>]

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

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

Beschreibung

Starten Sie eine interaktive SSH-Sitzung mit einer Azure-Ressource (unterstützt derzeit Azure-VMs und Arc-Server). Benutzer können sich mit von Microsoft Entra ausgestellten Zertifikaten oder mit lokalen Benutzeranmeldeinformationen anmelden. Wir empfehlen, sich mit Microsoft Entra ausgestellten Zertifikaten anzumelden, wenn möglich. Wichtiger Hinweis: Beim Herstellen einer Verbindung mit Azure Arc-Ressourcen muss dieses Cmdlet das Az.Ssh.ArcProxy-Modul auch auf dem Clientcomputer installiert werden. Das Cmdlet versucht, das Modul aus dem PowerShell-Katalog zu installieren, aber der Benutzer hat auch die Möglichkeit, es selbst zu installieren. Es ist wichtig, dass der Benutzer auch über die Berechtigung zum Ausführen der Proxydateien im Az.Ssh.ArcProxy-Modul verfügt oder die Verbindung fehlschlägt. Sie finden das Az.Ssh.ArcServer-Modul im PowerShell-Katalog: https://aka.ms/PowerShellGallery-Az.Ssh.ArcProxy.

Beispiele

Beispiel 1: Herstellen einer Verbindung mit Azure-Ressource mit von Microsoft Entra ausgestellten Zertifikaten

Enter-AzVM -ResourceGroupName myRg -Name myMachine

Wenn kein -LocalUser angegeben wird, versucht das Cmdlet, sich mit der Microsoft Entra-ID anzumelden. Dies wird derzeit nur für Ressourcen unterstützt, die das Linux-Betriebssystem ausführen.

Beispiel 2: Herstellen einer Verbindung mit lokalem Benutzer in Azure-Ressource mithilfe von SSH-Zertifikaten für die Authentifizierung

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

Beispiel 3: Herstellen einer Verbindung mit lokalem Benutzer in Azure-Ressource mithilfe eines privaten SSH-Schlüssels für die Authentifizierung

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

Beispiel 4: Herstellen einer Verbindung mit lokalem Benutzer in Azure-Ressource mithilfe der interaktiven Benutzernamen- und Kennwortauthentifizierung

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

Beispiel 5: Herstellen einer Verbindung mit der öffentlichen IP eines virtuellen Azure-Computers mithilfe von Von Microsoft Entra ausgestellten Zertifikaten

Enter-AzVM -Ip 1.2.3.4

Beispiel 6: Bereitstellen des Ressourcentyps des Ziels.

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

Dieser Parameter ist nützlich, wenn mehr als eine unterstützte Ressource mit demselben Namen in der Ressourcengruppe vorhanden ist.

Beispiel 7: Herstellen einer Verbindung mit Azure-Ressource mithilfe von von Microsoft Entra ausgestellten Zertifikaten und benutzerdefinierten Schlüsseldateien

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

Wenn keine benutzerdefinierten Schlüsseldateien bereitgestellt werden, generiert das Cmdlet das Schlüsselpaar.

Beispiel 8: Starten der RDP-Verbindung über SSH-Verbindung.

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

Dieser Parameter eignet sich zum Erstellen einer RDP-Sitzung für eine Arc-Ressource über arc Connectivity Platform.

Parameter

-CertificateFile

SSH-Zertifikat, das für die Authentifizierung bei einem lokalen Benutzerkonto verwendet werden soll.

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

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:	IAzureContextContainer
Aliase:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Force

Wenn Sie eine Verbindung mit Arc-Ressourcen herstellen, werden Sie nicht zur Bestätigung aufgefordert, bevor Sie den zulässigen Port für die SSH-Verbindung im Verbindungsendpunkt aktualisieren, um dem Zielport zu entsprechen, oder wenn erforderlich Az.Ssh.ArcProxy-Modul aus dem PowerShell-Katalog zu installieren.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Ip

IP-Adresse des Azure-Zielcomputers.

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

-LocalUser

Benutzername für einen lokalen Benutzer in der Zielressource.

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

-Name

Name der Azure-Zielressource.

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

-PassThru

Gibt true zurück, wenn die Verbindung erfolgreich ist.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Port

Portieren, mit dem eine Verbindung auf dem Remotehost hergestellt werden soll.

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

-PrivateKeyFile

Pfad zur Privaten Schlüsseldatei.

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

-PublicKeyFile

Pfad zur Datei mit öffentlichem Schlüssel.

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

-Rdp

Starten Sie eine RDP-Verbindung über SSH-Verbindung. Nur unter Windows-Betriebssystem unterstützt.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ResourceGroupName

Ressourcengruppenname.

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

-ResourceId

Ressourcen-ID der Zielressource.

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

-ResourceType

Ressourcentyp der Zielressource.

Typ:	String
Zulässige Werte:	Microsoft.HybridCompute/machines, Microsoft.Compute/virtualMachines, Microsoft.ConnectedVMwarevSphere/virtualMachines, Microsoft.ScVmm/virtualMachines, Microsoft.AzureStackHCI/virtualMachines
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-SshArgument

Zusätzliche SSH-Argumente, die an OpenSSH übergeben werden.

Typ:	String[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-UsePrivateIp

Beim Herstellen einer Verbindung mit einem virtuellen Azure-Computer gibt dieses Flag an, dass eine Verbindung mit einem der privaten IP-Adressen der VM hergestellt werden soll. Es ist eine Verbindung mit der privaten IP erforderlich.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Eingaben

String

String[]

Ausgaben

Boolean

Ähnliche Themen

• SSH-Zugriff auf Arzure Arc-fähige Server
• Problembehandlung beim SSH-Zugriff auf Azure Arc-fähige Server
• Anmelden bei einer Linux-VM mithilfe der Microsoft Entra-ID
• Installieren von OpenSSH für Windows