Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Esta página mostra como ativar as Cloud Tools for PowerShell, autenticar
com a CLI gcloud e executar cmdlets do PowerShell.
Antes de começar
Conclua os seguintes passos:
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 a partir da linha de comandos do PowerShell executando o seguinte comando como administrador:
Install-Module GoogleCloud
Autentique com a CLI gcloud
O Cloud Tools for PowerShell usa as suas credenciais e definições armazenadas na CLI gcloud para ativar os cmdlets. Para usar os cmdlets, inicie sessão primeiro
com a CLI gcloud:
Na linha de comandos, execute o seguinte comando:
gcloud init
Aceite a opção para iniciar sessão com a sua conta de utilizador Google:
To continue, you must log in. Would you like to log in (Y/n)? Y
No navegador, inicie sessão na sua conta de utilizador Google quando lhe for pedido e clique em
Permitir para conceder autorização de acesso aos recursos Google Cloud .
Na linha de comandos, selecione um Google Cloud projeto no qual tem
autorizaçõ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:
Execute cmdlets do PowerShell
Após a autenticação, pode começar a usar o Cloud Tools for PowerShell. Abra uma janela do PowerShell e experimente executar os seguintes comandos.
Obter todos os contentores para o projeto atual, para um projeto específico ou para um contentor específico:
Apresenta todas as instâncias do 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
Navegue no Cloud Storage com o fornecedor do PowerShell
O Cloud Tools for PowerShell inclui um fornecedor do PowerShell para o
Cloud Storage. Este fornecedor permite-lhe usar comandos como cd, dir, copy e del para navegar e manipular os seus dados no
Cloud Storage como se os dados estivessem num sistema de ficheiros local.
Para usar diretamente o fornecedor, pode iniciar o Cloud Tools for PowerShell através do atalho no menu Iniciar. Esta ação inicia uma consola do PowerShell com o fornecedor carregado:
# Navigate to Cloud Storage
cd gs:\
# Show the available buckets
ls
# Create a new bucket
mkdir my-new-bucket
Também pode disponibilizar o fornecedor do Cloud Storage em qualquer sessão do PowerShell importando o módulo Cloud Tools for PowerShell através de Import-Module GoogleCloud.
O que se segue?
Pode saber mais acerca dos cmdlets específicos consultando a referência
de cmdlets das ferramentas Cloud para PowerShell ou
usando o sistema de ajuda integrado no 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-21 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```"]]
