Início rápido

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.

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

Verify that billing is enabled for your Google Cloud project.

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

Verify that billing is enabled for your Google Cloud project.

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

1. Na linha de comandos, execute o seguinte comando:

   gcloud init

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

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

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

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

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:

Get-Help New-GcsBucket