Enter-AzVM
Inicia uma sessão SSH interativa para um recurso de Azure (como VMs Azure ou Servidores Arc).
Os usuários podem fazer logon usando contas Microsoft Entra ou contas de usuário local por meio da autenticação SSH padrão. Use Microsoft Entra logon de conta para obter a melhor segurança e conveniência.
Sintaxe
Interactive (Default)
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 a sessão SSH interativa em um recurso de Azure (atualmente dá suporte a VMs Azure e servidores Arc).
Os usuários podem fazer logon usando Microsoft Entra certificados emitidos ou usando credenciais de usuário local. É recomendável fazer logon usando Microsoft Entra certificados emitidos quando possível.
Observação importante: ao se conectar a Azure Arc recursos, esse cmdlet requer que o módulo Az.Ssh.ArcProxy também seja instalado no computador cliente. O cmdlet tentará instalar o módulo do Galeria do PowerShell, mas o usuário também tem a opção de instalá-lo por conta própria. É importante que o usuário também tenha permissão para executar os arquivos Proxy no módulo Az.Ssh.ArcProxy ou a conexão falhará. Você pode encontrar o módulo Az.Ssh.ArcServer no Galeria do PowerShell: https://aka.ms/PowerShellGallery-Az.Ssh.ArcProxy .
Exemplos
Exemplo 1: Conectar-se ao recurso Azure usando certificados emitidos Microsoft Entra
Enter-AzVM -ResourceGroupName myRg -Name myMachine
Quando um -LocalUser não for fornecido, o cmdlet tentará fazer logon usando Microsoft Entra ID. Atualmente, só há suporte para recursos que executam o sistema operacional Linux.
Exemplo 2: Conectar-se ao usuário local no recurso Azure usando certificados SSH para autenticação
Enter-AzVM -ResourceGroupName myRg -Name myMachine -LocalUser azureuser -PrivateKeyFile ./id_rsa -CertificateFile ./cert
Exemplo 3: Conectar-se ao usuário local no recurso Azure usando a chave privada SSH para autenticação
Enter-AzVM -ResourceGroupName myRg -Name myMachine -LocalUser azureuser -PrivateKeyFile ./id_rsa
Exemplo 4: Conectar-se ao usuário local no recurso Azure usando autenticação interativa de nome de usuário e senha
Enter-AzVM -ResourceGroupName myRg -Name myMachine -LocalUser azureuser
Exemplo 5: Conectar-se ao IP público de uma máquina virtual Azure usando Microsoft Entra certificados emitidos
Exemplo 6: forneça o tipo de recurso do destino.
Enter-AzVM -ResourceGroupName myRg -Name myMachine -ResourceType Microsoft.HybridCompute/machines
Esse parâmetro é útil quando há mais de um recurso com suporte com o mesmo nome no Grupo de Recursos.
Exemplo 7: Conectar-se ao recurso Azure usando certificados emitidos Microsoft Entra certificado e arquivos de chave personalizados
Enter-AzVM -ResourceGroupName myRg -Name myMachine -PrivateKeyFile ./id_rsa -PublicKeyFile ./id_rsa.pub
Se os arquivos de chave personalizados não forem fornecidos, o cmdlet gerará o par de chaves.
Exemplo 8: iniciar a conexão RDP pela conexão SSH.
Enter-AzVM -ResourceGroupName myRg -Name myMachine -LocalUser username -Rdp
Esse parâmetro é útil para criar uma sessão RDP para um recurso do Arc por meio da Plataforma de Conectividade do Arc.
Parâmetros
-CertificateFile
Certificado SSH a ser usado para autenticar na conta de usuário local.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usadas para comunicação com Azure.
Propriedades do parâmetro
Tipo: IAzureContextContainer
Valor padrão: None Dá suporte a curingas: False DontShow: False Aliases: AzContext, AzureRmContext, AzureCredential
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-Force
Ao se conectar aos recursos do Arc, não solicite confirmação antes de atualizar a porta permitida para conexão SSH no Ponto de Extremidade de Conexão para corresponder à porta de destino ou instalar o módulo Az.Ssh.ArcProxy do Galeria do PowerShell, se necessário.
Propriedades do parâmetro
Tipo: SwitchParameter
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-Ip
Endereço IP da VM de Azure de destino.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
IpAddress
Cargo: Named Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-LocalUser
Nome de usuário para um usuário local no recurso de destino.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-Name
Nome do recurso de Azure de destino.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
Interactive
Cargo: Named Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
-PassThru
Retorna true se a conexão for bem-sucedida.
Propriedades do parâmetro
Tipo: SwitchParameter
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-Port
Porta à qual se conectar no host remoto.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-PrivateKeyFile
Caminho para o arquivo de chave privada.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-PublicKeyFile
Caminho para o arquivo de chave pública.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-Rdp
Inicie uma conexão RDP pela conexão SSH. Só há suporte no sistema operacional Windows.
Propriedades do parâmetro
Tipo: SwitchParameter
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-ResourceGroupName
Nome do grupo de recursos.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
Interactive
Cargo: Named Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
-ResourceId
ID do recurso de destino.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
ResourceId
Cargo: Named Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
-ResourceType
Tipo de recurso do recurso de destino.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Valores aceitos: Microsoft.HybridCompute/machines, Microsoft.Compute/virtualMachines, Microsoft.ConnectedVMwarevSphere/virtualMachines, Microsoft.ScVmm/virtualMachines, Microsoft.AzureStackHCI/virtualMachines Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
Interactive
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-SshArgument
Argumentos SSH adicionais passados para o OpenSSH.
Propriedades do parâmetro
Tipo: String [ ]
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-UsePrivateIp
Ao se conectar a uma VM Azure, esse sinalizador especifica que ele deve se conectar a um dos IPs privados da VM. Ele requer conectividade com o IP privado.
Propriedades do parâmetro
Tipo: SwitchParameter
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
Interactive
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
ResourceId
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters .
Saídas
