Este documento descreve como estabelecer ligação a instâncias de máquinas virtuais (VM) do Windows através de SSH. Para outras formas de estabelecer ligação a VMs do Windows, consulte os artigos Estabeleça ligação a VMs do Windows através do RDP e Estabeleça ligação a VMs do Windows através do PowerShell. Para saber como funciona o SSH no Compute Engine, consulte o artigo Acerca das ligações SSH.
Antes de começar
- 
  
  Se ainda não o tiver feito, configure a autenticação.
  A autenticação valida a sua identidade para aceder a Google Cloud serviços e APIs. Para executar código ou exemplos a partir de um ambiente de desenvolvimento local, pode autenticar-se no Compute Engine selecionando uma das seguintes opções:
  
   
   
     
   
  
   
   
     
   
  
   
   
     
   
  
 
 
 
  
    
      Select the tab for how you plan to use the samples on this page: ConsoleWhen you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication. gcloud- 
 
 
  
  
   
   
  
   
   
  
   
   
     
   
  
  
   
   
  
   
   
  
   
   
  
 
 
   
   
      Instale a CLI Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando: gcloud initSe estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada. 
- Set a default region and zone.
 Imagens suportadasO SSH para Windows é suportado em imagens do Windows Server com a versão 20220527.00ou posterior do agente convidado (GCEGuestAgent) e a versão8.6ou posterior do OpenSSH.Ative o SSH para VMs do WindowsPara ativar as ligações SSH a VMs Windows, instale o pacote google-compute-engine-sshe defina a chaveenable-windows-sshcomoTRUEnos metadados do projeto ou da instância. A ativação do SSH para o Windows nos metadados do projeto ativa o SSH para todas as VMs do Windows no seu projeto. A ativação do SSH para Windows nos metadados da instância ativa o SSH para uma única VM e substitui o valor definido nos metadados do projeto.Ative o SSH para Windows durante a criação de uma VMAtive o SSH para o Windows ao criar uma VM através da Google Cloud consola ou da Google Cloud CLI. ConsolaCrie uma VM a partir de uma imagem pública que instala o pacote google-compute-engine-sshe ativa o SSH no arranque:- Especifique as seguintes propriedades do disco de arranque: - Sistema operativo: Windows Server
- Versão: qualquer versão
 
- Na secção Opções avançadas, expanda a secção Gestão. 
- Na secção Metadados, clique em Adicionar item. Adicione um script de arranque que instale o pacote - google-compute-engine-sshintroduzindo o seguinte par de chave-valor de metadados:- Chave: sysprep-specialize-script-cmd
- Valor: googet -noconfirm=true install google-compute-engine-ssh
 
- Chave: 
- Na secção Metadados, clique em Adicionar item. Defina - enable-windows-sshcomo- TRUEintroduzindo o seguinte par de chave-valor de metadados:- Chave: enable-windows-ssh
- Valor: TRUE
 
- Chave: 
- Clique em Criar para criar e iniciar a VM. 
 gcloudExecute o seguinte gcloud compute instances createcomando para criar uma VM do Windows Server que instala o pacotegoogle-compute-engine-sshe ativa o SSH no arranque: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=TRUESubstitua o seguinte: - VM_NAME: o nome da nova VM.
- IMAGE_FAMILY: a família de imagens do Windows Server. Isto cria a VM a partir da imagem do Windows Server não descontinuada mais recente.
 Ative o SSH para Windows numa VM em execuçãoPara ativar o SSH numa VM do Windows em execução, faça uma das seguintes ações, consoante possa usar o RDP para aceder à sua VM ou se a sua carga de trabalho tolerar um reinício: - Acesso RDP necessário: estabeleça ligação à VM através do RDP e instale o pacote SSH
- Reinício necessário: use um script de arranque para instalar o pacote SSH 
 RDPSe conseguir aceder à VM através do RDP, ative o SSH da seguinte forma: 
- Abra uma sessão da linha de comandos do administrador da seguinte forma: - Abra o menu Iniciar. 
- Navegue até Linha de comandos. 
- Clique com o botão direito do rato em Linha de comandos e selecione Executar como administrador. - Se lhe for pedido que permita que a Linha de comandos faça alterações ao seu dispositivo, selecione Sim. 
 
- Transfira e instale o pacote - google-compute-engine-sshexecutando o seguinte comando:- googet -noconfirm=true install google-compute-engine-windows && googet -noconfirm=true install google-compute-engine-ssh 
- Feche a sessão RDP. 
- Ative o SSH do Windows nos metadados definindo a chave - enable-windows-sshcomo- TRUE. Para mais informações sobre a definição de metadados, consulte o artigo Defina metadados personalizados.
 Script de arranqueSe não conseguir aceder à VM através do RDP, ative o SSH fazendo o seguinte: 
- Defina os seguintes pares de chave-valor de metadados na VM para ativar o SSH. Para mais informações sobre a definição de metadados, consulte o artigo Defina 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 do SSH: - Chave: enable-windows-ssh
- Valor: TRUE
 
- Chave: 
 
- Inicie a VM. O reinício da VM pode demorar alguns minutos. 
 Estabeleça ligação a VMs através de SSHEstabeleça ligação a VMs através do comando gcloud compute ssh:gcloud compute ssh VM_NAME Substitua VM_NAMEpelo nome da VM do Windows à qual quer estabelecer ligação.Estabeleça ligação a VMs que usam o ADSe a VM à qual se está a ligar usar o Active Directory (AD), ligue-se através do seguinte comando: gcloud compute ssh DOMAIN\USERNAME@VM_NAME Substitua o seguinte: - DOMAIN: o seu domínio AD. Por exemplo, o domínio do anúncio- ad.example.comé- example.
- USERNAME: o seu nome de utilizador do AD. Por exemplo,- cloudysanfrancisco.
- VM_NAME: o nome da VM do Windows à qual quer estabelecer ligação.
 O que se segue?- Saiba como resolver problemas de ligações SSH.
- Saiba como adicionar chaves SSH a VMs
- Saiba como restringir chaves SSH de VMs.
 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-10-19 UTC. -