Créer et gérer des instances Compute Engine

Cette page montre comment créer et gérer des instances Compute Engine à partir de Cloud Tools for PowerShell. Consultez la documentation de référence des cmdlets Cloud Tools for PowerShell pour en savoir plus sur les cmdlets Compute Engine.

Créer une configuration d'instance

Avant de créer une instance, vous devez d'abord créer une configuration d'instance. Au minimum, vous devez spécifier un nom, un type d'ordinateur et une image de disque de démarrage ou un disque de démarrage existant :

$disk = Get-GceImage "windows-cloud" -Family "windows-2012-r2"
$config = New-GceInstanceConfig [VM_NAME] `
    -MachineType [MACHINE_TYPE] `
    -DiskImage $disk

Consultez la documentation de référence des cmdlets Cloud Tools for PowerShell pour connaître les autres options de configuration proposées par le cmdlet New-GceInstanceConfig.

Créer une instance

Utilisez le cmdlet Add-GceInstance pour créer une instance de machine. Vous pouvez spécifier des paramètres, tels que project , zone ou region. Si vous omettez un paramètre, le cmdlet utilise les valeurs définies dans votre configuration SDK Cloud :

$config | Add-GceInstance -Project [PROJECT] -Zone [ZONE]

Gérer une instance

Utilisez le cmdlet Get-GceInstance pour récupérer les instances de machine virtuelle d'un projet. Étant donné qu'il n'y a pas d'unicité des noms d'instance ni sur l'ensemble des projets ni sur l'ensemble des zones, vous pouvez spécifier un paramètre project ou zone pour restreindre la recherche. Par défaut, le cmdlet utilise les valeurs que vous avez définies dans la configuration active du SDK Cloud :

$instance = Get-GceInstance [VM_NAME]

Vous pouvez démarrer, arrêter ou redémarrer une instance à l'aide de différents cmdlets. Vous pouvez faire référence à une instance en utilisant son nom ou l'objet fortement type renvoyé par le cmdlet Get-GceInstance :

Stop-GceInstance $instance
Start-GceInstance $instance
Restart-GceInstance [VM_NAME]

Après avoir créé une instance, vous pouvez définir des tags, des disques, des configurations d'accès et d'autres métadonnées pour cette instance à l'aide du cmdlet Set-GceInstance :

Set-GceInstance $instance -AddMetadata @{"newKey" = "newValue"}
Set-GceInstance $instance -RemoveMetadata [METADATA_TAG]
Set-GceInstance $instance -RemoveTag [TAG] -AddTag [TAG]

Enfin, lorsque vous avez terminé avec une instance, vous pouvez la supprimer de Compute Engine à l'aide du cmdlet Remove-GceInstance :

# Remove all instances with the "to-be-removed" tag.
Get-GceInstance -Project [PROJECT] |
    Where { $_.Tags.Items -contains "to-be-removed" } |
    Remove-GceInstance