Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Nesta página, mostramos como habilitar o Cloud Tools for PowerShell, autenticar com a CLI gcloud e executar cmdlets do PowerShell.
Antes de começar
Siga estas etapas:
Sign in to your Google Cloud account. If you're new to
Google Cloud,
create an account to evaluate how our products perform in
real-world scenarios. New customers also get $300 in free credits to
run, test, and deploy workloads.
In the Google Cloud console, on the project selector page,
select or create a Google Cloud project.
Instale a CLI gcloud da linha de comando do PowerShell executando o seguinte comando como administrador:
Install-Module GoogleCloud
Fazer a autenticação com a CLI gcloud
O Cloud Tools for PowerShell usa credenciais e configurações armazenadas na
CLI gcloud para ativar os cmdlets. Para usar os cmdlets, primeiro faça login usando a CLI gcloud:
No prompt de comando, execute o seguinte comando:
gcloud init
Aceite a opção de fazer login com sua conta de usuário do Google:
To continue, you must log in. Would you like to log in (Y/n)? Y
No seu navegador, faça login na sua conta de usuário do Google quando solicitado e clique em Permitir para permitir acesso aos recursos do Google Cloud .
No prompt de comando, selecione um projeto do Google Cloud em que você tenha permissões de Proprietário, Editor ou Leitor:
Pick a cloud project to use:
[1] [my-project-1]
[2] [my-project-2]
...
Please enter your numeric choice:
Executar cmdlets do PowerShell
Após a autenticação, você poderá começar a usar o Cloud Tools for PowerShell. Abra uma janela do PowerShell e tente executar os seguintes comandos.
Consulte todos os buckets do projeto atual, todos de um projeto específico ou um bucket específico:
Liste todas as instâncias do Google Compute Engine associadas a um projeto:
Get-GceInstance -Project my-project-1 |
Sort Status |
Format-Table Name, Status -GroupBy Status
Status: RUNNING
Name Status
---- ------
my-vm-2 RUNNING
my-vm-3 RUNNING
Status: TERMINATED
Name Status
---- ------
my-vm-1 TERMINATED
Navegar pelo Cloud Storage com o provedor do PowerShell
O Cloud Tools for PowerShell inclui um provedor do PowerShell para o Google Cloud Storage. Esse provedor permite que você use comandos como cd, dir, copy e del para navegar e manipular dados no Cloud Storage como se eles estivessem em um sistema de arquivos local.
Para usar diretamente o provedor, você pode iniciar o Cloud Tools for PowerShell por meio do atalho no menu Iniciar. Isso iniciará o console do PowerShell com o provedor carregado:
# Navigate to Cloud Storage
cd gs:\
# Show the available buckets
ls
# Create a new bucket
mkdir my-new-bucket
Também é possível disponibilizar o provedor do Cloud Storage em qualquer sessão do PowerShell importando o módulo do Cloud Tools for PowerShell por meio do Import-Module GoogleCloud.
A seguir
Saiba mais sobre cmdlets específicos na referência de cmdlets do Cloud Tools for PowerShell ou com o sistema de ajuda integrado do Windows PowerShell:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-17 UTC."],[],[],null,["# Quickstart\n\nThis page shows how to enable Cloud Tools for PowerShell, authenticate\nwith the gcloud CLI, and run PowerShell cmdlets.\n\nBefore you begin\n----------------\n\nComplete the following steps:\n\n- Sign in to your Google Cloud account. If you're new to Google Cloud, [create an account](https://console.cloud.google.com/freetrial) to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.\n- In the Google Cloud console, on the project selector page,\n select or create a Google Cloud project.\n\n | **Note**: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.\n\n [Go to project selector](https://console.cloud.google.com/projectselector2/home/dashboard)\n-\n [Verify that billing is enabled for your Google Cloud project](/billing/docs/how-to/verify-billing-enabled#confirm_billing_is_enabled_on_a_project).\n\n- In the Google Cloud console, on the project selector page,\n select or create a Google Cloud project.\n\n | **Note**: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.\n\n [Go to project selector](https://console.cloud.google.com/projectselector2/home/dashboard)\n-\n [Verify that billing is enabled for your Google Cloud project](/billing/docs/how-to/verify-billing-enabled#confirm_billing_is_enabled_on_a_project).\n\n1. Install the gcloud CLI from the PowerShell command line by running the following command as an administrator: \n\n```\nInstall-Module GoogleCloud\n```\n\n\u003cbr /\u003e\n\nAuthenticate with gcloud CLI\n----------------------------\n\nCloud Tools for PowerShell uses your credentials and settings stored in the\ngcloud CLI to enable the cmdlets. To use the cmdlets, first log in\nusing the gcloud CLI:\n\n1. At the command prompt, run the following command:\n\n ```\n gcloud init\n ```\n2. Accept the option to log in using your Google user account:\n\n `To continue, you must log in. Would you like to log in (Y/n)? Y`\n3. In your browser, log in to your Google user account when prompted and click\n **Allow** to grant permission to access Google Cloud resources.\n\n4. At the command prompt, select a Google Cloud project in which you\n have Owner, Editor, or Viewer permissions:\n\n ```\n Pick a cloud project to use:\n [1] [my-project-1]\n [2] [my-project-2]\n ...\n Please enter your numeric choice:\n ```\n\nRun PowerShell cmdlets\n----------------------\n\nAfter authenticating, you can start using Cloud Tools for PowerShell. Open a\nPowerShell window and try running the following commands.\n\nGet all buckets for the current project, for a specific project, or a specific\nbucket: \n\n```\n$currentProjBuckets = Get-GcsBucket\n$specificProjBuckets = Get-GcsBucket -Project my-project-1\n$bucket = Get-GcsBucket -Name my-bucket-name\n```\n\nList all Compute Engine instances associated with a project: \n\n```\nGet-GceInstance -Project my-project-1 |\n Sort Status |\n Format-Table Name, Status -GroupBy Status\n\n Status: RUNNING\n\nName Status\n---- ------\nmy-vm-2 RUNNING\nmy-vm-3 RUNNING\n\n Status: TERMINATED\n\nName Status\n---- ------\nmy-vm-1 TERMINATED\n```\n\nNavigate Cloud Storage with PowerShell provider\n-----------------------------------------------\n\nCloud Tools for PowerShell includes a PowerShell provider for\nCloud Storage. This provider allows you to use commands like\n`cd`, `dir`, `copy` and `del` to navigate and manipulate your data in\nCloud Storage as if the data were on a local file system.\n\nTo directly use the provider, you can start Cloud Tools for PowerShell using\nthe shortcut from the start menu. This will launch a PowerShell console with the\nprovider loaded: \n\n```\n# Navigate to Cloud Storage\ncd gs:\\\n# Show the available buckets\nls\n# Create a new bucket\nmkdir my-new-bucket\n```\n\nYou can also make the Cloud Storage provider available in any\nPowerShell session by importing the Cloud Tools for PowerShell module via\n`Import-Module GoogleCloud`.\n\nWhat's next\n-----------\n\nYou can learn more about specific cmdlets by referring to the\nCloud Tools for PowerShell [cmdlet\nreference](https://googlecloudplatform.github.io/google-cloud-powershell), or by\nusing the built-in help system from within PowerShell: \n\n```\nGet-Help New-GcsBucket\n```"]]
