Enter-AzVM

Módulo:
Az.Ssh Module

Inicia una sesión SSH interactiva en un recurso de Azure (como Azure máquinas virtuales o servidores de Arc). Los usuarios pueden iniciar sesión con cuentas de Microsoft Entra o cuentas de usuario locales a través de la autenticación SSH estándar. Use Microsoft Entra inicio de sesión de cuenta para obtener la mejor seguridad y comodidad.

Sintaxis

Interactive (valor predeterminado) 

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

Inicie una sesión SSH interactiva en un recurso de Azure (actualmente admite Azure máquinas virtuales y servidores de Arc). Los usuarios pueden iniciar sesión con certificados emitidos Microsoft Entra o mediante credenciales de usuario local. Se recomienda iniciar sesión con Microsoft Entra certificados emitidos siempre que sea posible. Nota importante: Al conectarse a recursos de Azure Arc, este cmdlet requiere que el módulo Az.Ssh.ArcProxy también esté instalado en el equipo cliente. El cmdlet intentará instalar el módulo desde el Galería de PowerShell, pero el usuario también tiene la opción de instalarlo por sí mismos. Es importante que el usuario también tenga permiso para ejecutar los archivos proxy en el módulo Az.Ssh.ArcProxy o se producirá un error en la conexión. Puede encontrar el módulo Az.Ssh.ArcServer en el Galería de PowerShell: https://aka.ms/PowerShellGallery-Az.Ssh.ArcProxy.

Ejemplos

Ejemplo 1: Conexión a Azure recurso mediante certificados emitidos Microsoft Entra

Enter-AzVM -ResourceGroupName myRg -Name myMachine

Cuando no se proporciona un -LocalUser, el cmdlet intentará iniciar sesión con Microsoft Entra ID. Actualmente solo se admite para los recursos que ejecutan el sistema operativo Linux.

Ejemplo 2: Conexión al usuario local en Azure recurso mediante certificados SSH para la autenticación

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

Ejemplo 3: Conexión al usuario local en Azure recurso mediante la clave privada SSH para la autenticación

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

Ejemplo 4: Conectarse al usuario local en Azure recurso mediante la autenticación interactiva de nombre de usuario y contraseña

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

Ejemplo 5: Conexión a la dirección IP pública de una máquina virtual de Azure mediante certificados emitidos Microsoft Entra

Enter-AzVM -Ip 1.2.3.4

Ejemplo 6: Proporcione el tipo de recurso del destino.

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

Este parámetro es útil cuando hay más de un recurso admitido con el mismo nombre en el grupo de recursos.

Ejemplo 7: Conexión a Azure recurso mediante Microsoft Entra certificado emitido y archivos de clave personalizados

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

Si no se proporcionan archivos de clave personalizados, el cmdlet generará el par de claves.

Ejemplo 8: Iniciar la conexión RDP a través de la conexión SSH.

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

Este parámetro es útil para crear una sesión RDP en un recurso de Arc a través de arc Connectivity Platform.

Parámetros

-CertificateFile

Certificado SSH que se usará para autenticarse en la cuenta de usuario local.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Propiedades de parámetro

Tipo:IAzureContextContainer
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Force

Al conectarse a los recursos de Arc, no solicite confirmación antes de actualizar el puerto permitido para la conexión SSH en el punto de conexión para que coincida con el puerto de destino o para instalar el módulo Az.Ssh.ArcProxy desde el Galería de PowerShell, si es necesario.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Ip

Dirección IP de la máquina virtual de Azure de destino.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

IpAddress
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-LocalUser

Nombre de usuario de un usuario local en el recurso de destino.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Name

Nombre del Azure recurso de destino.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Interactive
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-PassThru

Devuelve true si la conexión se realiza correctamente.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Port

Puerto al que conectarse en el host remoto.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-PrivateKeyFile

Ruta de acceso al archivo de clave privada.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-PublicKeyFile

Ruta de acceso al archivo de clave pública.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Rdp

Inicie una conexión RDP a través de la conexión SSH. Solo se admite en Windows sistema operativo.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ResourceGroupName

Nombre del grupo de recursos.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Interactive
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ResourceId

Identificador de recurso del recurso de destino.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ResourceId
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ResourceType

Tipo de recurso del recurso de destino.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Valores aceptados:Microsoft.HybridCompute/machines, Microsoft.Compute/virtualMachines, Microsoft.ConnectedVMwarevSphere/virtualMachines, Microsoft.ScVmm/virtualMachines, Microsoft.AzureStackHCI/virtualMachines
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Interactive
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SshArgument

Argumentos SSH adicionales pasados a OpenSSH.

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-UsePrivateIp

Al conectarse a una máquina virtual de Azure, esta marca especifica que debe conectarse a una de las direcciones IP privadas de la máquina virtual. Requiere conectividad con la dirección IP privada.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Interactive
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ResourceId
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

String

String

Salidas

Boolean