Enter-AzVM

  • Préversion
Module:
Az.Ssh Module

Cette applet de commande fait partie d’un module en préversion . Les versions en préversion ne sont pas recommandées pour une utilisation dans les environnements de production. Pour plus d’informations, consultez https://aka.ms/azps-refstatus.

Démarre une session SSH interactive vers une ressource Azure (par exemple, des machines virtuelles Azure ou des serveurs Arc). Les utilisateurs peuvent se connecter à l’aide de comptes Microsoft Entra ou de comptes d’utilisateurs locaux via l’authentification SSH standard. Utilisez Microsoft Entra connexion de compte pour une sécurité et une commodité optimales.

Syntaxe

Interactive (Par défaut) 

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

Démarrez une session SSH interactive vers une ressource Azure (prend actuellement en charge Azure machines virtuelles et serveurs Arc). Les utilisateurs peuvent se connecter à l’aide de Microsoft Entra certificats émis ou à l’aide d’informations d’identification utilisateur locales. Nous vous recommandons de vous connecter à l’aide de Microsoft Entra certificats émis lorsque cela est possible. Remarque importante : lors de la connexion à Azure Arc ressources, cette applet de commande nécessite que le module Az.Ssh.ArcProxy soit également installé sur l’ordinateur client. L’applet de commande tente d’installer le module à partir du PowerShell Gallery, mais l’utilisateur a également la possibilité de l’installer lui-même. Il est important que l’utilisateur dispose également de l’autorisation d’exécuter les fichiers proxy dans le module Az.Ssh.ArcProxy, ou que la connexion échoue. Vous trouverez le module Az.Ssh.ArcServer dans la PowerShell Gallery : https://aka.ms/PowerShellGallery-Az.Ssh.ArcProxy.

Exemples

Exemple 1 : Se connecter à Azure ressource à l’aide de certificats émis par Microsoft Entra

Enter-AzVM -ResourceGroupName myRg -Name myMachine

Lorsqu’une -LocalUser n’est pas fournie, l’applet de commande tente de se connecter à l’aide de Microsoft Entra ID. Cela est actuellement uniquement pris en charge pour les ressources exécutant le système d’exploitation Linux.

Exemple 2 : Se connecter à un utilisateur local sur Azure ressource à l’aide de certificats SSH pour l’authentification

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

Exemple 3 : Se connecter à un utilisateur local sur Azure ressource à l’aide de la clé privée SSH pour l’authentification

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

Exemple 4 : Se connecter à un utilisateur local sur Azure Ressource à l’aide d’une authentification interactive par nom d’utilisateur et mot de passe

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

Exemple 5 : Se connecter à l’adresse IP publique d’une machine virtuelle Azure à l’aide de certificats émis par Microsoft Entra

Enter-AzVM -Ip 1.2.3.4

Exemple 6 : Indiquez le type de ressource de la cible.

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

Ce paramètre est utile lorsqu’il existe plusieurs ressources prises en charge portant le même nom dans le groupe de ressources.

Exemple 7 : Se connecter à Azure ressource à l’aide de certificats émis par Microsoft Entra certificat et de fichiers de clés personnalisés

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

Si les fichiers de clés personnalisés ne sont pas fournis, l’applet de commande génère la paire de clés.

Exemple 8 : Démarrer la connexion RDP via une connexion SSH.

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

Ce paramètre est utile pour créer une session RDP sur une ressource Arc via Arc Connectivity Platform.

Paramètres

-CertificateFile

Certificat SSH à utiliser pour s’authentifier auprès du compte d’utilisateur local.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Propriétés du paramètre

Type:IAzureContextContainer
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Force

Lors de la connexion aux ressources Arc, n’invitez pas à confirmer avant de mettre à jour le port autorisé pour la connexion SSH dans le point de terminaison de connexion afin de correspondre au port cible ou d’installer le module Az.Ssh.ArcProxy à partir du PowerShell Gallery, si nécessaire.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Ip

Adresse IP de la machine virtuelle Azure cible.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

IpAddress
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-LocalUser

Nom d’utilisateur d’un utilisateur local dans la ressource cible.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Name

Nom de la ressource Azure cible.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

Interactive
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-PassThru

Retourne true si la connexion réussit.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Port

Port vers lequel se connecter sur l’hôte distant.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-PrivateKeyFile

Chemin d’accès au fichier de clé privée.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-PublicKeyFile

Chemin d’accès au fichier de clé publique.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Rdp

Démarrez une connexion RDP via une connexion SSH. Uniquement pris en charge sur Windows système d’exploitation.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ResourceGroupName

Nom du groupe de ressources.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

Interactive
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-ResourceId

ID de ressource de la ressource cible.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ResourceId
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-ResourceType

Type de ressource de la ressource cible.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Valeurs acceptées:Microsoft.HybridCompute/machines, Microsoft.Compute/virtualMachines, Microsoft.ConnectedVMwarevSphere/virtualMachines, Microsoft.ScVmm/virtualMachines, Microsoft.AzureStackHCI/virtualMachines
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

Interactive
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SshArgument

Arguments SSH supplémentaires passés à OpenSSH.

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-UsePrivateIp

Lors de la connexion à une machine virtuelle Azure, cet indicateur spécifie qu’il doit se connecter à l’une des adresses IP privées de la machine virtuelle. Elle nécessite une connectivité à l’adresse IP privée.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

Interactive
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
ResourceId
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

String

String

Sorties

Boolean