Delen via

Enter-AzVM

  • Preview
Module:
Az.Ssh Module

Deze cmdlet maakt deel uit van een preview-module . Preview-versies worden niet aanbevolen voor gebruik in productieomgevingen. Zie https://aka.ms/azps-refstatus voor meer informatie.

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.

Syntax

Interactive (Standaard) 

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

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.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DefaultProfile

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

Parametereigenschappen

Type:IAzureContextContainer
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:AzContext, AzureRmContext, AzureCredential

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Ip

IP-adres van azure-doel-VM.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

IpAddress
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-LocalUser

Gebruikersnaam voor een lokale gebruiker in de doelresource.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Name

Naam van de Azure-doelresource.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

Interactive
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-PassThru

Retourneert waar als de verbinding is geslaagd.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Port

Poort om verbinding mee te maken op de externe host.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-PrivateKeyFile

Pad naar het bestand met de persoonlijke sleutel.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-PublicKeyFile

Pad naar bestand met openbare sleutels.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Rdp

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

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ResourceGroupName

Naam van de resourcegroep.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

Interactive
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-ResourceId

Resource-id van de doelresource.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

ResourceId
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-ResourceType

Resourcetype van de doelresource.

Parametereigenschappen

Type:String
Default value:None
Geaccepteerde waarden:Microsoft.HybridCompute/machines, Microsoft.Compute/virtualMachines, Microsoft.ConnectedVMwarevSphere/virtualMachines, Microsoft.ScVmm/virtualMachines, Microsoft.AzureStackHCI/virtualMachines
Ondersteunt jokertekens:False
DontShow:False

Parametersets

Interactive
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-SshArgument

Aanvullende SSH-argumenten die zijn doorgegeven aan OpenSSH.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

Interactive
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False
ResourceId
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

String

String

Uitvoerwaarden

Boolean