Guide de démarrage rapide

Cette page explique comment activer Cloud Tools for PowerShell, s'authentifier avec la CLI gcloud et exécuter des applets de commande PowerShell.

Avant de commencer

Procédez comme suit :

1. Connectez-vous à votre compte Google Cloud. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.

2. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

   Remarque : Si vous ne comptez pas conserver les ressources créées dans cette procédure, créez un projet au lieu de sélectionner un projet existant. Après avoir suivi ces étapes, vous pouvez supprimer le projet. Cela entraîne la suppression de toutes les ressources qui lui sont associées.

   Accéder au sélecteur de projet

3. Assurez-vous que la facturation est activée pour votre projet Cloud. Découvrez comment vérifier si la facturation est activée sur un projet.

4. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

   Remarque : Si vous ne comptez pas conserver les ressources créées dans cette procédure, créez un projet au lieu de sélectionner un projet existant. Après avoir suivi ces étapes, vous pouvez supprimer le projet. Cela entraîne la suppression de toutes les ressources qui lui sont associées.

   Accéder au sélecteur de projet

5. Assurez-vous que la facturation est activée pour votre projet Cloud. Découvrez comment vérifier si la facturation est activée sur un projet.

6. Installez la CLI gcloud à partir de la ligne de commande PowerShell en exécutant la commande suivante en tant qu'administrateur:

Install-Module GoogleCloud

S'authentifier avec la CLI gcloud

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

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.

Étapes suivantes

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