Guia de início rápido

Nesta página, mostramos como ativar o Cloud Tools for PowerShell, autenticar com a CLI do gcloud e executar cmdlets do PowerShell.

Antes de começar

Siga estas etapas:

1. 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.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   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.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   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.

   Go to project selector

5. Make sure that billing is enabled for your Google Cloud project.

6. Instale a CLI gcloud pela linha de comando do PowerShell executando o seguinte comando como administrador:

Install-Module GoogleCloud

Autenticar com a CLI gcloud

O Cloud Tools for PowerShell usa credenciais e configurações armazenadas na CLI da gcloud para ativar os cmdlets. Para usar os cmdlets, faça login primeiro usando a CLI gcloud:

1. No prompt de comando, execute o seguinte comando:

   gcloud init

2. 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

3. 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.

4. 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:

$currentProjBuckets = Get-GcsBucket
$specificProjBuckets = Get-GcsBucket -Project my-project-1
$bucket = Get-GcsBucket -Name my-bucket-name

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:

Get-Help New-GcsBucket