Este documento descreve como se conectar a instâncias de máquina virtual (VM) do Windows usando SSH. Para outras maneiras de se conectar a VMs do Windows, consulte Conectar-se a VMs do Windows usando RDP e Conectar-se a VMs do Windows usando o PowerShell . Para saber como o SSH funciona no Compute Engine, consulte Sobre conexões SSH .
Antes de começar
- Se ainda não o fez, configure a autenticação. Autenticação é o processo pelo qual sua identidade é verificada para acesso a Google Cloud serviços e APIs. Para executar códigos ou amostras em um ambiente de desenvolvimento local, você pode se autenticar no Compute Engine selecionando uma das seguintes opções:
Select the tab for how you plan to use the samples on this page:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
- Set a default region and zone.
Especifique as seguintes propriedades do disco de inicialização :
- Sistema operacional: Windows Server
- Versão: Qualquer versão
Na seção Opções avançadas , expanda a seção Gerenciamento .
Na seção Metadados , clique em Adicionar item . Adicione um script de inicialização que instale o pacote
google-compute-engine-ssh
inserindo o seguinte par de valores-chave de metadados:- Chave:
sysprep-specialize-script-cmd
- Valor:
googet -noconfirm=true install google-compute-engine-ssh
- Chave:
Na seção Metadados , clique em Adicionar item . Defina
enable-windows-ssh
comoTRUE
inserindo o seguinte par de valores-chave de metadados:- Chave:
enable-windows-ssh
- Valor:
TRUE
- Chave:
Clique em Criar para criar e iniciar a VM.
-
VM_NAME
: o nome da nova VM. -
IMAGE_FAMILY
: uma família de imagens do Windows Server . Isso cria a VM a partir da imagem mais recente do Windows Server não obsoleta. - Acesso RDP necessário : Conecte-se à VM usando RDP e instale o pacote SSH
Reinicialização necessária : use um script de inicialização para instalar o pacote SSH
Abra uma sessão de prompt de comando do administrador fazendo o seguinte:
Abra o menu Iniciar .
Navegue até o prompt de comando .
Clique com o botão direito em Prompt de Comando e selecione Executar como administrador .
Se você for solicitado a permitir que o prompt de comando faça alterações em seu dispositivo, selecione Sim .
Baixe e instale o pacote
google-compute-engine-ssh
executando o seguinte comando:googet -noconfirm=true install google-compute-engine-windows && googet -noconfirm=true install google-compute-engine-ssh
Feche a sessão RDP.
Habilite o SSH do Windows nos metadados definindo a chave
enable-windows-ssh
comoTRUE
. Para obter mais informações sobre como configurar metadados, consulte Definir metadados personalizados .Defina os seguintes pares de valores-chave de metadados na VM para ativar o SSH. Para obter mais informações sobre como configurar metadados, consulte Definir metadados personalizados .
Metadados de instalação do pacote SSH:
- Chave :
windows-startup-script-cmd
- Valor :
googet -noconfirm=true update && googet -noconfirm=true install google-compute-engine-ssh
- Chave :
Metadados de ativação SSH:
- Chave :
enable-windows-ssh
- Valor :
TRUE
- Chave :
Inicie a VM . A VM pode levar alguns minutos para reinicializar.
-
DOMAIN
: seu domínio do AD. Por exemplo, o domínio do ADad.example.com
éexample
. -
USERNAME
: seu nome de usuário do AD. Por exemplo,cloudysanfrancisco
. -
VM_NAME
: o nome da VM do Windows à qual você deseja se conectar. - Aprenda como solucionar problemas de conexões SSH .
- Aprenda como adicionar chaves SSH a VMs
- Aprenda como restringir chaves SSH de VMs .
Imagens suportadas
O SSH para Windows é compatível com imagens do Windows Server que executam o agente convidado (
GCEGuestAgent
) versão20220527.00
ou posterior e o OpenSSH versão8.6
ou posterior.Habilitar SSH para VMs do Windows
Para ativar conexões SSH com VMs do Windows, instale o pacote
google-compute-engine-ssh
e defina a chaveenable-windows-ssh
comoTRUE
nos metadados do projeto ou da instância. Habilitar o SSH para Windows nos metadados do projeto habilita o SSH para todas as VMs do Windows no seu projeto. Habilitar o SSH para Windows nos metadados da instância habilita o SSH para uma única VM e substitui o valor definido nos metadados do projeto.Habilite o SSH para Windows ao criar uma VM
Ative o SSH para Windows ao criar uma VM usando o console do Google Cloud ou a CLI do Google Cloud.
Console
Crie uma VM a partir de uma imagem pública que instale o pacote
google-compute-engine-ssh
e ative o SSH na inicialização:gcloud
Execute o seguinte comando
gcloud compute instances create
para criar uma VM do Windows Server que instale o pacotegoogle-compute-engine-ssh
e habilite o SSH na inicialização:gcloud compute instances create VM_NAME \ --image-family=IMAGE_FAMILY \ --image-project=windows-cloud \ --metadata sysprep-specialize-script-cmd="googet -noconfirm=true install google-compute-engine-ssh",enable-windows-ssh=TRUE
Substitua o seguinte:
Habilitar SSH para Windows em uma VM em execução
Para habilitar o SSH em uma VM do Windows em execução, siga um destes procedimentos, dependendo se você pode usar RDP para acessar sua VM ou se sua carga de trabalho pode tolerar uma reinicialização:
PDR
Se você puder acessar sua VM usando RDP, habilite o SSH fazendo o seguinte:
Roteiro de inicialização
Se você não conseguir acessar sua VM usando RDP, habilite o SSH fazendo o seguinte:
Conecte-se a VMs usando SSH
Conecte-se às VMs usando o comando
gcloud compute ssh
:gcloud compute ssh VM_NAME
Substitua
VM_NAME
pelo nome da VM do Windows à qual você deseja se conectar.Conecte-se a VMs que usam AD
Se a VM à qual você está se conectando usar o Active Directory (AD), conecte-se usando o seguinte comando:
gcloud compute ssh DOMAIN\USERNAME@VM_NAME
Substitua o seguinte:
O que vem a seguir?
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-04-21 UTC.
-