Enter-AzVM
Esse cmdlet faz parte de um módulo de versão prévia . Versões prévias não são recomendadas para uso em ambientes de produção. Para obter mais informações, consulte https://aka.ms/azps-refstatus .
Inicia uma sessão SSH interativa para um recurso do Azure (como VMs do Azure ou servidores Arc).
Os usuários podem fazer logon usando contas do Microsoft Entra ou contas de usuário locais por meio da autenticação SSH padrão. Use o login da conta do Microsoft Entra 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 uma sessão interativa de SSH em um Recurso do Azure (atualmente dá suporte a VMs do Azure e Servidores Arc).
Os usuários podem fazer logon usando certificados emitidos pelo Microsoft Entra ou usando credenciais de usuário local. É recomendável fazer logon usando certificados emitidos pelo Microsoft Entra quando possível.
Observação importante: ao se conectar aos recursos do Azure Arc, esse cmdlet exige que o módulo Az.Ssh.ArcProxy também seja instalado no computador cliente. O cmdlet tentará instalar o módulo por meio da 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 na Galeria do PowerShell: https://aka.ms/PowerShellGallery-Az.Ssh.ArcProxy .
Exemplos
Exemplo 1: Conectar-se ao Recurso do Azure usando certificados emitidos pelo Microsoft Entra
Enter-AzVM -ResourceGroupName myRg -Name myMachine
Quando um -LocalUser não for fornecido, o cmdlet tentará fazer logon usando a ID do Microsoft Entra. Atualmente, só há suporte para recursos que executam o sistema operacional Linux.
Exemplo 2: Conectar-se ao usuário local no Recurso do 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 do 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 do 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 do Azure usando certificados emitidos pelo Microsoft Entra
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 do Azure usando certificados emitidos pelo Certificado do Microsoft Entra 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 usados para a comunicação com o 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 da 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 do 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 do 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 do 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