Condividi tramite

Enter-AzVM

  • Anteprima
Modulo:
Az.Ssh Module

Questo cmdlet fa parte di un modulo di anteprima . Le versioni di anteprima non sono consigliate per l'uso negli ambienti di produzione. Per altre informazioni, vedere .

Avvia una sessione SSH interattiva a una risorsa Azure, ad esempio Azure macchine virtuali o arc server. Gli utenti possono accedere usando account Microsoft Entra o account utente locali tramite l'autenticazione SSH standard. Usare Microsoft Entra account di accesso per la sicurezza e la comodità migliori.

Sintassi

Interactive (Impostazione predefinita) 

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

Descrizione

Avviare una sessione SSH interattiva su una risorsa Azure (attualmente supporta Azure macchine virtuali e server Arc). Gli utenti possono accedere usando Microsoft Entra certificati rilasciati o usando le credenziali utente locali. È consigliabile usare Microsoft Entra certificati rilasciati quando possibile. Nota importante: quando ci si connette alle risorse di Azure Arc, questo cmdlet richiede l'installazione anche del modulo Az.Ssh.ArcProxy nel computer client. Il cmdlet tenterà di installare il modulo dal PowerShell Gallery, ma l'utente ha anche la possibilità di installarlo autonomamente. È importante che l'utente disponga anche dell'autorizzazione per eseguire i file proxy nel modulo Az.Ssh.ArcProxy oppure la connessione avrà esito negativo. Il modulo Az.Ssh.ArcServer è disponibile nel PowerShell Gallery: https://aka.ms/PowerShellGallery-Az.Ssh.ArcProxy.

Esempio

Esempio 1: Connettersi alla risorsa Azure usando Microsoft Entra certificati rilasciati

Enter-AzVM -ResourceGroupName myRg -Name myMachine

Quando non viene specificata una -LocalUser, il cmdlet tenterà di eseguire l'accesso usando Microsoft Entra ID. Questa opzione è attualmente supportata solo per le risorse che eseguono il sistema operativo Linux.

Esempio 2: Connettersi all'utente locale in Azure risorsa usando i certificati SSH per l'autenticazione

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

Esempio 3: Connettersi all'utente locale in Azure risorsa usando la chiave privata SSH per l'autenticazione

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

Esempio 4: Connettersi all'utente locale in Azure risorsa usando l'autenticazione interattiva di nome utente e password

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

Esempio 5: Connettersi all'indirizzo IP pubblico di una macchina virtuale Azure usando Microsoft Entra certificati rilasciati

Enter-AzVM -Ip 1.2.3.4

Esempio 6: specificare il tipo di risorsa della destinazione.

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

Questo parametro è utile quando nel gruppo di risorse sono presenti più risorse supportate con lo stesso nome.

Esempio 7: Connettersi a Azure risorsa usando i certificati rilasciati Microsoft Entra certificato e i file di chiave personalizzati

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

Se i file di chiave personalizzati non vengono forniti, il cmdlet genererà la coppia di chiavi.

Esempio 8: avviare la connessione RDP tramite connessione SSH.

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

Questo parametro è utile per creare una sessione RDP in una risorsa Arc tramite Arc Connectivity Platform.

Parametri

-CertificateFile

Certificato SSH da usare per l'autenticazione all'account utente locale.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Proprietà dei parametri

Tipo:IAzureContextContainer
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Force

Quando ci si connette alle risorse arc, non richiedere conferma prima di aggiornare la porta consentita per la connessione SSH nell'endpoint di connessione in modo che corrisponda alla porta di destinazione o installare il modulo Az.Ssh.ArcProxy dal PowerShell Gallery, se necessario.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Ip

Indirizzo IP della macchina virtuale Azure di destinazione.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

IpAddress
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-LocalUser

Nome utente per un utente locale nella risorsa di destinazione.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Name

Nome del Azure risorsa di destinazione.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Interactive
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-PassThru

Restituisce true se la connessione ha esito positivo.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Port

Porta a cui connettersi nell'host remoto.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-PrivateKeyFile

Percorso del file di chiave privata.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-PublicKeyFile

Percorso del file di chiave pubblica.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Rdp

Avviare una connessione RDP tramite connessione SSH. Supportato solo nel sistema operativo Windows.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ResourceGroupName

Nome del gruppo di risorse.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Interactive
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-ResourceId

ID risorsa della risorsa di destinazione.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

ResourceId
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-ResourceType

Tipo di risorsa della risorsa di destinazione.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Valori accettati:Microsoft.HybridCompute/machines, Microsoft.Compute/virtualMachines, Microsoft.ConnectedVMwarevSphere/virtualMachines, Microsoft.ScVmm/virtualMachines, Microsoft.AzureStackHCI/virtualMachines
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Interactive
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-SshArgument

Argomenti SSH aggiuntivi passati a OpenSSH.

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-UsePrivateIp

Quando ci si connette a una macchina virtuale Azure, questo flag specifica che deve connettersi a uno degli indirizzi IP privati della macchina virtuale. Richiede la connettività all'INDIRIZZO IP privato.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Interactive
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
ResourceId
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

String

String

Output

Boolean