Verwendung von TerminateWorkspaces mit einer CLI

So beenden Sie einen WorkSpace

Im folgenden terminate-workspaces-Beispiel wird der angegebene WorkSpace beendet.

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

Ausgabe:

{
    "FailedRequests": []
}

Weitere Informationen finden Sie unter Löschen eines WorkSpace im Administratorhandbuch für Amazon WorkSpace.

Beispiel 1: Beendet mehrere WorkSpaces. Die Verwendung der Option -Force verhindert, dass das Cmdlet eine Bestätigung anfordert.

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

Beispiel 2: Ruft die Sammlung all Ihrer WorkSpaces ab und leitet die IDs an den Parameter -WorkSpaceID von Remove-WKSWorkspace weiter, wodurch alle WorkSpaces beendet werden. Das Cmdlet fordert Sie vor dem Beenden jedes WorkSpace zur Bestätigung auf. Um die Bestätigungsaufforderung zu unterdrücken, fügen Sie den Schalter -Force hinzu.

Get-WKSWorkspaces | Remove-WKSWorkspace

Beispiel 3: Dieses Beispiel zeigt, wie TerminateRequest-Objekte übergeben werden, die die zu beendenden WorkSpaces definieren. Das Cmdlet fordert Sie zur Bestätigung auf, bevor es fortfährt, es sei denn, der Schalterparameter -Force ist ebenfalls angegeben.

$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

Beispiel 1: Beendet mehrere WorkSpaces. Die Verwendung der Option -Force verhindert, dass das Cmdlet eine Bestätigung anfordert.

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

Beispiel 2: Ruft die Sammlung all Ihrer WorkSpaces ab und leitet die IDs an den Parameter -WorkSpaceID von Remove-WKSWorkspace weiter, wodurch alle WorkSpaces beendet werden. Das Cmdlet fordert Sie vor dem Beenden jedes WorkSpace zur Bestätigung auf. Um die Bestätigungsaufforderung zu unterdrücken, fügen Sie den Schalter -Force hinzu.

Get-WKSWorkspaces | Remove-WKSWorkspace

Beispiel 3: Dieses Beispiel zeigt, wie TerminateRequest-Objekte übergeben werden, die die zu beendenden WorkSpaces definieren. Das Cmdlet fordert Sie zur Bestätigung auf, bevor es fortfährt, es sei denn, der Schalterparameter -Force ist ebenfalls angegeben.

$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