Partilhar via

Enter-AzVM

Módulo:
Az.Ssh Module

Inicia uma sessão SSH interativa para um Recurso Azure (como VMs Azure ou Servidores Arc). Os utilizadores podem iniciar sessão usando contas Microsoft Entra, ou contas de utilizador locais através da autenticação SSH padrão. Use o login da conta Microsoft Entra para a melhor segurança e conveniência.

Sintaxe

Interactive (Predefinição) 

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

Iniciar sessão SSH interativa para um Recurso Azure (atualmente suporta VMs e servidores Arc do Azure). Os utilizadores podem iniciar sessão usando certificados emitidos pela Microsoft Entra ou usando credenciais locais. Recomendamos iniciar sessão utilizando certificados emitidos pela Microsoft Entra sempre que possível. Nota importante: Ao ligar-se aos recursos do Azure Arc, este cmdlet requer que o módulo Az.Ssh.ArcProxy também esteja instalado na máquina cliente. O cmdlet tentará instalar o módulo a partir da Galeria do PowerShell, mas o utilizador também tem a opção de o instalar ele próprio. É 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á. Pode encontrar o módulo Az.Ssh.ArcServer na Galeria do PowerShell: https://aka.ms/PowerShellGallery-Az.Ssh.ArcProxy.

Exemplos

Exemplo 1: Ligue-se ao Azure Resource usando certificados emitidos pela Microsoft Entra

Enter-AzVM -ResourceGroupName myRg -Name myMachine

Quando não é fornecido um -LocalUser, o cmdlet tenta iniciar sessão usando Microsoft Entra ID. Atualmente, isso só é suportado para recursos que executam o sistema operacional Linux.

Exemplo 2: Ligue-se ao Utilizador 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: Ligue-se ao Utilizador Local no Recurso Azure usando chave privada SSH para autenticação

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

Exemplo 4: Ligue-se ao Utilizador Local no Azure Resource usando autenticação interativa de nomes de utilizador e palavra-passe

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

Exemplo 5: Ligue-se ao IP Público de uma Máquina Virtual Azure usando certificados emitidos pela Microsoft Entra

Enter-AzVM -Ip 1.2.3.4

Exemplo 6: Forneça o Tipo de Recurso do destino.

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

Este parâmetro é útil quando há mais de um recurso suportado com o mesmo nome no Grupo de Recursos.

Exemplo 7: Liga-te ao Azure Resource usando certificados emitidos pela Microsoft Entra e ficheiros de chave personalizadas

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

Se os arquivos de chave personalizada não forem fornecidos, o cmdlet gerará o par de chaves.

Exemplo 8: Inicie a conexão RDP pela conexão SSH.

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

Este parâmetro é útil para criar uma sessão RDP para um recurso Arc via Arc Connectivity Platform.

Parâmetros

-CertificateFile

Certificado SSH a ser usado para autenticar na conta de usuário local.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DefaultProfile

As credenciais, conta, inquilino e subscrição usados para comunicação com o Azure.

Propriedades dos parâmetros

Tipo:IAzureContextContainer
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Force

Ao ligar a recursos Arc, não peça confirmação antes de atualizar a porta permitida para ligação SSH no Connection Endpoint para corresponder à porta alvo ou instalar o módulo Az.Ssh.ArcProxy a partir da Galeria do PowerShell, se necessário.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Ip

Endereço IP da VM Azure alvo.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

IpAddress
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-LocalUser

Nome de usuário para um usuário local no recurso de destino.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Name

Nome do recurso Azure alvo.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

Interactive
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-PassThru

Retorna true se a conexão for bem-sucedida.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Port

Porta para se conectar no host remoto.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-PrivateKeyFile

Caminho para o arquivo de chave privada.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-PublicKeyFile

Caminho para o arquivo de chave pública.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Rdp

Inicie uma ligação RDP através de uma ligação SSH. Só é suportado no sistema operativo Windows.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ResourceGroupName

Nome do grupo de recursos.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

Interactive
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-ResourceId

ID do recurso de destino.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ResourceId
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-ResourceType

Tipo de recurso do recurso de destino.

Propriedades dos parâmetros

Tipo:String
Default value:None
Valores aceites:Microsoft.HybridCompute/machines, Microsoft.Compute/virtualMachines, Microsoft.ConnectedVMwarevSphere/virtualMachines, Microsoft.ScVmm/virtualMachines, Microsoft.AzureStackHCI/virtualMachines
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

Interactive
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-SshArgument

Argumentos SSH adicionais passados para OpenSSH.

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-UsePrivateIp

Ao ligar-se a uma VM Azure, esta bandeira especifica que deve ligar-se a um dos IPs privados da VM. Requer conectividade com o IP privado.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

Interactive
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ResourceId
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Entradas

String

String

Saídas

Boolean