Delen via

Enter-AzVM

  • Referentie
Module:
Az.Ssh

Hiermee start u een interactieve SSH-sessie naar een Azure-resource (zoals Azure-VM's of Arc-servers). Gebruikers kunnen zich aanmelden met Behulp van Microsoft Entra-accounts of lokale gebruikersaccounts via standaard SSH-verificatie. Gebruik microsoft Entra-accountaanmelding voor de beste beveiliging en gemak.

Syntaxis

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

Description

Start een interactieve SSH-sessie naar een Azure-resource (ondersteunt momenteel Azure-VM's en Arc-servers). Gebruikers kunnen zich aanmelden met door Microsoft Entra uitgegeven certificaten of met behulp van lokale gebruikersreferenties. We raden u aan om u aan te melden met door Microsoft Entra uitgegeven certificaten, indien mogelijk. Belangrijke opmerking: als u verbinding maakt met Azure Arc-resources, moet de Az.Ssh.ArcProxy-module ook worden geïnstalleerd op de clientcomputer. De cmdlet probeert de module te installeren vanuit de PowerShell Gallery, maar de gebruiker heeft ook de mogelijkheid om deze zelf te installeren. Het is belangrijk dat de gebruiker ook gemachtigd is om de proxybestanden uit te voeren in de Az.Ssh.ArcProxy-module, anders mislukt de verbinding. U vindt de Module Az.Ssh.ArcServer in de PowerShell Gallery: https://aka.ms/PowerShellGallery-Az.Ssh.ArcProxy.

Voorbeelden

Voorbeeld 1: Verbinding maken met Azure-resource met behulp van door Microsoft Entra uitgegeven certificaten

Enter-AzVM -ResourceGroupName myRg -Name myMachine

Wanneer er geen -LocalUser wordt opgegeven, probeert de cmdlet zich aan te melden met behulp van Microsoft Entra-id. Dit wordt momenteel alleen ondersteund voor resources waarop het Linux-besturingssysteem wordt uitgevoerd.

Voorbeeld 2: Verbinding maken met lokale gebruiker in Azure-resource met behulp van SSH-certificaten voor verificatie

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

Voorbeeld 3: Verbinding maken met lokale gebruiker in Azure-resource met behulp van een persoonlijke SSH-sleutel voor verificatie

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

Voorbeeld 4: Verbinding maken met lokale gebruiker in Azure-resource met behulp van interactieve gebruikersnaam- en wachtwoordverificatie

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

Voorbeeld 5: Verbinding maken met het openbare IP-adres van een virtuele Azure-machine met behulp van door Microsoft Entra uitgegeven certificaten

Enter-AzVM -Ip 1.2.3.4

Voorbeeld 6: Geef het resourcetype van het doel op.

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

Deze parameter is handig wanneer er meer dan één ondersteunde resource is met dezelfde naam in de resourcegroep.

Voorbeeld 7: Verbinding maken met Azure-resource met behulp van door Microsoft Entra uitgegeven certificaten en aangepaste sleutelbestanden

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

Als er geen aangepaste sleutelbestanden worden opgegeven, genereert de cmdlet het sleutelpaar.

Voorbeeld 8: RDP-verbinding via SSH-verbinding starten.

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

Deze parameter is handig voor het maken van een RDP-sessie naar een Arc-resource via Arc Connectivity Platform.

Parameters

-CertificateFile

SSH-certificaat dat moet worden gebruikt voor verificatie bij het lokale gebruikersaccount.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Force

Wanneer u verbinding maakt met Arc-resources, vraagt u niet om bevestiging voordat u de toegestane poort voor de SSH-verbinding in het verbindingseindpunt bijwerkt, zodat deze overeenkomt met de doelpoort of om de Az.Ssh.ArcProxy-module te installeren vanuit de PowerShell Gallery, indien nodig.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Ip

IP-adres van azure-doel-VM.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-LocalUser

Gebruikersnaam voor een lokale gebruiker in de doelresource.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Naam van de Azure-doelresource.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-PassThru

Retourneert waar als de verbinding is geslaagd.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Port

Poort om verbinding mee te maken op de externe host.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PrivateKeyFile

Pad naar het bestand met de persoonlijke sleutel.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PublicKeyFile

Pad naar bestand met openbare sleutels.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Rdp

Een RDP-verbinding starten via een SSH-verbinding. Alleen ondersteund in het Windows-besturingssysteem.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ResourceGroupName

Naam van resourcegroep.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ResourceId

Resource-id van de doelresource.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ResourceType

Resourcetype van de doelresource.

Type:String
Geaccepteerde waarden:Microsoft.HybridCompute/machines, Microsoft.Compute/virtualMachines, Microsoft.ConnectedVMwarevSphere/virtualMachines, Microsoft.ScVmm/virtualMachines, Microsoft.AzureStackHCI/virtualMachines
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SshArgument

Aanvullende SSH-argumenten die zijn doorgegeven aan OpenSSH.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-UsePrivateIp

Wanneer u verbinding maakt met een Azure-VM, geeft deze vlag aan dat deze verbinding moet maken met een van de privé-IP-adressen van de virtuele machine. Hiervoor is verbinding met het privé-IP-adres vereist.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

String[]

Uitvoerwaarden