Guide de démarrage rapide

Cette page explique comment activer Cloud Tools for PowerShell, authentifier avec la gcloud CLI et exécuter des cmdlets PowerShell.

Avant de commencer

Procédez comme suit :

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. Installez la gcloud CLI à partir de la ligne de commande PowerShell en procédant comme suit : en exécutant la commande suivante en tant qu'administrateur:

Install-Module GoogleCloud

S'authentifier avec gcloud CLI

Cloud Tools for PowerShell utilise vos identifiants et les paramètres stockés dans le gcloud CLI pour activer les cmdlets. Pour utiliser les cmdlets, connectez-vous d'abord à l'aide de la gcloud CLI :

1. Dans l'invite de commande, exécutez la commande suivante :

   gcloud init

2. Acceptez l'option de connexion avec votre compte utilisateur Google :

   To continue, you must log in. Would you like to log in (Y/n)? Y

3. Dans votre navigateur, connectez-vous à votre compte utilisateur Google lorsque vous y êtes invité, puis cliquez sur Autoriser pour autoriser l'accès aux ressources de Google Cloud.

4. Dans l'invite de commande, sélectionnez un projet Google Cloud dans lequel vous disposez d'autorisations de Propriétaire, d'Éditeur ou de Lecteur :

   Pick a cloud project to use:
   [1] [my-project-1]
   [2] [my-project-2]
   ...
   Please enter your numeric choice:

Exécuter des cmdlets PowerShell

Après vous être authentifié, vous pouvez commencer à utiliser Cloud Tools for PowerShell. Ouvrez une fenêtre PowerShell et essayez d'exécuter les commandes suivantes.

Obtenez tous les buckets du projet en cours, d'un projet spécifique ou d'un bucket spécifique :

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

Répertoriez toutes les instances de Compute Engine associées à un projet :

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

Parcourir Cloud Storage avec le fournisseur PowerShell

Cloud Tools for PowerShell inclut un fournisseur PowerShell pour Cloud Storage. Ce fournisseur vous permet d'utiliser des commandes telles que cd, dir, copy et del pour parcourir et manipuler vos données dans Cloud Storage comme si elles se trouvaient sur un système de fichiers local.

Pour utiliser le fournisseur directement, vous pouvez lancer Cloud Tools for PowerShell à l'aide du raccourci situé dans le menu Démarrer. Cela lancera une console PowerShell dans laquelle le fournisseur est chargé :

# Navigate to Cloud Storage
cd gs:\
# Show the available buckets
ls
# Create a new bucket
mkdir my-new-bucket

Vous pouvez également rendre le fournisseur Cloud Storage disponible dans toutes les sessions PowerShell en important le module Cloud Tools for PowerShell à l'aide du cmdlet Import-Module GoogleCloud.

Étape suivante

Pour en savoir plus sur des cmdlets spécifiques, consultez la référence relative aux cmdlets Cloud Tools for PowerShell ou utilisez le système d'aide intégré à partir de PowerShell :

Get-Help New-GcsBucket