建立及管理 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 指令建立新的機器執行個體。您可以指定參數，例如 project、zone 或 region。如果您省略參數，則 cmdlet 會使用您 Google Cloud CLI 設定中所設定的值：

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

管理執行個體

請使用 Get-GceInstance 指令碼來擷取專案的虛擬機器執行個體。由於執行個體名稱在所有專案或區域中可能會重複，因此您可以指定 project 或 zone 參數來縮小搜尋範圍。根據預設，Cmdlet 會使用您在有效 gcloud CLI 設定中所設定的值：

$instance = Get-GceInstance [VM_NAME]

您可以使用各種 cmdlet 來啟動、停止或重新啟動執行個體。您可以使用 Get-GceInstance 指令傳回的名稱或強式物件，參照某個執行個體：

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

在使用 Set-GceInstance 指令建立執行個體後，您可以設定執行個體代碼、磁碟、存取設定和其他中繼資料：

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