创建和管理 Compute Engine 实例

此页面介绍如何从 Cloud Tools for PowerShell 中创建和管理 Compute Engine 实例。 如需详细了解 Compute Engine cmdlet，请参阅 Cloud Tools for PowerShell cmdlet 参考。

创建实例配置

在创建实例之前，必须先创建实例配置。 此配置至少需要名称、机器类型和启动磁盘映像，或者原先就有启动磁盘：

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

如需了解 New-GceInstanceConfig cmdlet 提供的其他配置选项，请参阅 Cloud Tools for PowerShell cmdlet 参考。

创建实例

使用 Add-GceInstance cmdlet 创建新的机器实例。您可以指定参数，例如 project、zone 或 region。如果您省略参数，cmdlet 将使用 Google Cloud CLI 配置中设置的值：

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

管理实例

使用 Get-GceInstance cmdlet 检索项目的虚拟机实例。 由于实例名称在项目或地区中可能不唯一，因此您可以指定 project 或 zone 参数以缩小搜索范围。默认情况下，cmdlet 会使用您在活跃 gcloud CLI 配置中设置的任何值：

$instance = Get-GceInstance [VM_NAME]

您可以使用各种 cmdlet 启动、停止或重新启动实例。您可以使用从 Get-GceInstance cmdlet 返回的名称或强类型对象来引用实例：

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

使用 Set-GceInstance cmdlet 创建实例后，您可以设置实例标记、磁盘、访问配置和其他元数据：

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

最后，用完实例后，可以使用 Remove-GceInstance cmdlet 将其从 Compute Engine 中移除：

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