En esta página, se muestra cómo crear y administrar instancias de Compute Engine desde Cloud Tools for PowerShell. Consulta la referencia del cmdlet de Cloud Tools for PowerShell a fin de obtener más información sobre los cmdlets de Compute Engine.
Crea una configuración de instancia
Antes de crear una instancia, primero debes crear la configuración de una instancia. Como mínimo, esto requiere un nombre, un tipo de máquina y una imagen de disco de arranque o un disco de inicio preexistente:
$disk = Get-GceImage "windows-cloud" -Family "windows-2012-r2" $config = New-GceInstanceConfig [VM_NAME] ` -MachineType [MACHINE_TYPE] ` -DiskImage $disk
Consulta la referencia del cmdlet de Cloud Tools for PowerShell para ver otras opciones de configuración que se ofrecen con el cmdlet New-GceInstanceConfig
.
Crear una instancia
Usa el cmdlet Add-GceInstance
para crear una instancia de máquina nueva. Puedes especificar parámetros, como project, zone o region. Si omites un parámetro, los valores establecidos en la configuración de Google Cloud CLI se usan con el cmdlet:
$config | Add-GceInstance -Project [PROJECT] -Zone [ZONE]
Administra una instancia
Usa el cmdlet Get-GceInstance
para recuperar las instancias de máquina virtual de un proyecto.
Ya que es posible que el nombre de la instancia no sea exclusivo en los proyectos o zonas, puedes especificar un parámetro de proyecto o zona para reducir la búsqueda. Según la configuración predeterminada, los valores que estableciste en la configuración activa de gcloud CLI se usan con el cmdlet:
$instance = Get-GceInstance [VM_NAME]
Puedes iniciar, detener o reiniciar una instancia con varios cmdlets. Puedes hacer referencia a una instancia con el nombre o el objeto tipificado que muestra el cmdlet Get-GceInstance
:
Stop-GceInstance $instance Start-GceInstance $instance Restart-GceInstance [VM_NAME]
Puedes configurar etiquetas de instancia, discos, configuraciones de acceso y otros tipos de metadatos después de crear tu instancia con el cmdlet Set-GceInstance
:
Set-GceInstance $instance -AddMetadata @{"newKey" = "newValue"} Set-GceInstance $instance -RemoveMetadata [METADATA_TAG] Set-GceInstance $instance -RemoveTag [TAG] -AddTag [TAG]
Por último, cuando finalizas con una instancia, puedes quitarla de Compute Engine con el 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