Utilizar TerminateWorkspaces con una CLI

Los siguientes ejemplos de código muestran cómo utilizar TerminateWorkspaces.

CLI

AWS CLI

Para terminar un WorkSpace

En el siguiente ejemplo de terminate-workspaces, finaliza el WorkSpace especificado.

aws workspaces terminate-workspaces \
    --terminate-workspace-requests ws-dk1xzr417

Salida:

{
    "FailedRequests": []
}

Para obtener más información, consulte Delete a WorkSpace en la Guía de administración de Amazon WorkSpaces.

• Para obtener información sobre la API, consulte TerminateWorkspaces en la Referencia de comandos de la AWS CLI.

PowerShell

Herramientas para PowerShell V4

Ejemplo 1: Termina varias instancias de WorkSpaces. El uso del modificador -Force impide que el cmdlet solicite confirmación.

Remove-WKSWorkspace -WorkspaceId "ws-1a2b3c4d5","ws-6a7b8c9d0" -Force

Ejemplo 2: Recupera la colección de todas sus instancias de WorkSpaces y envía los ID al parámetro -WorkSpaceId de Remove-WKSWorkspace, lo que provoca que se terminen todas las instancias de WorkSpaces. El cmdlet avisará antes de terminar cada instancia de WorkSpaces. Añada el modificador -Force para suprimir la solicitud de confirmación.

Get-WKSWorkspaces | Remove-WKSWorkspace

Ejemplo 3: En este ejemplo se muestra cómo pasar los objetos TerminateRequest que definen las instancias de WorkSpaces que se deben terminar. El cmdlet solicitará confirmación antes de continuar, a menos que se especifique el modificador -Force.

$arrRequest = @()
$request1 = New-Object Amazon.WorkSpaces.Model.TerminateRequest
$request1.WorkspaceId = 'ws-12345678'
$arrRequest += $request1
$request2 = New-Object Amazon.WorkSpaces.Model.TerminateRequest
$request2.WorkspaceId = 'ws-abcdefgh'
$arrRequest += $request2
Remove-WKSWorkspace -Request $arrRequest

• Para obtener información sobre la API, consulte TerminateWorkspaces en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

Herramientas para PowerShell V5

Ejemplo 1: Termina varias instancias de WorkSpaces. El uso del modificador -Force impide que el cmdlet solicite confirmación.

Remove-WKSWorkspace -WorkspaceId "ws-1a2b3c4d5","ws-6a7b8c9d0" -Force

Ejemplo 2: Recupera la colección de todas sus instancias de WorkSpaces y envía los ID al parámetro -WorkSpaceId de Remove-WKSWorkspace, lo que provoca que se terminen todas las instancias de WorkSpaces. El cmdlet avisará antes de terminar cada instancia de WorkSpaces. Añada el modificador -Force para suprimir la solicitud de confirmación.

Get-WKSWorkspaces | Remove-WKSWorkspace

Ejemplo 3: En este ejemplo se muestra cómo pasar los objetos TerminateRequest que definen las instancias de WorkSpaces que se deben terminar. El cmdlet solicitará confirmación antes de continuar, a menos que se especifique el modificador -Force.

$arrRequest = @()
$request1 = New-Object Amazon.WorkSpaces.Model.TerminateRequest
$request1.WorkspaceId = 'ws-12345678'
$arrRequest += $request1
$request2 = New-Object Amazon.WorkSpaces.Model.TerminateRequest
$request2.WorkspaceId = 'ws-abcdefgh'
$arrRequest += $request2
Remove-WKSWorkspace -Request $arrRequest

• Para obtener información sobre la API, consulte TerminateWorkspaces en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V5).