Compartir a través de

Enter-AzVM

  • Vista previa
Módulo:
Az.Ssh Module

Este cmdlet forma parte de un módulo de versión preliminar . No se recomienda usar versiones preliminares en entornos de producción. Para obtener más información, consulte https://aka.ms/azps-refstatus.

Inicia una sesión SSH interactiva en un recurso de Azure (por ejemplo, máquinas virtuales de Azure 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 el inicio de sesión de la cuenta de Microsoft Entra para mayor 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 máquinas virtuales de Azure y servidores de Arc). Los usuarios pueden iniciar sesión con certificados emitidos por Microsoft Entra o usar credenciales de usuario locales. Se recomienda iniciar sesión con certificados emitidos por Microsoft Entra 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 se instale en la máquina cliente. El cmdlet intentará instalar el módulo desde la Galería de PowerShell, pero el usuario también tiene la opción de instalarlo por sí mismo. 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 la Galería de PowerShell: https://aka.ms/PowerShellGallery-Az.Ssh.ArcProxy.

Ejemplos

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

Enter-AzVM -ResourceGroupName myRg -Name myMachine

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

Ejemplo 2: Conexión al usuario local en el recurso de Azure 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 el recurso de Azure mediante la clave privada SSH para la autenticación

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

Ejemplo 4: Conexión al usuario local en el recurso de Azure 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 por 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 un recurso de Azure mediante certificados emitidos por Microsoft Entra 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

Credenciales, cuenta, inquilino y suscripción usados 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 la 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 recurso de Azure 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 el sistema operativo Windows.

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