Démarrage rapide

Cette page explique comment activer Cloud Tools for PowerShell, s'authentifier avec le SDK Cloud et exécuter les cmdlets PowerShell.

Avant de commencer

Procédez comme suit :

Connectez-vous à votre compte Google.
Si vous n'en possédez pas déjà un, vous devez en créer un.

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 à la page de sélection du projet

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

Installez le SDK Cloud à partir de la ligne de commande PowerShell en exécutant la commande suivante en tant qu'administrateur :

Install-Module GoogleCloud

S'authentifier avec le SDK Cloud

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

Dans l'invite de commande, exécutez la commande suivante :
```
gcloud init
```
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
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.
Dans l'invite de commande, sélectionnez un projet Cloud Platform dans lequel vous disposez du rôle Propriétaire, Éditeur ou 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