

Weitere AWS SDK-Beispiele sind im [AWS Doc SDK Examples ](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub Repo verfügbar.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# WorkSpaces Beispiele zur Verwendung von Tools für V5 PowerShell
<a name="powershell_5_workspaces_code_examples"></a>

Die folgenden Codebeispiele zeigen Ihnen, wie Sie Aktionen ausführen und gängige Szenarien implementieren, indem Sie AWS -Tools für PowerShell V5 mit verwenden. WorkSpaces

*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.

Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.

**Topics**
+ [Aktionen](#actions)

## Aktionen
<a name="actions"></a>

### `Approve-WKSIpRule`
<a name="workspaces_AuthorizeIpRules_powershell_5_topic"></a>

Das folgende Codebeispiel zeigt die Verwendung`Approve-WKSIpRule`.

**Tools für PowerShell V5**  
**Beispiel 1: In diesem Beispiel werden Regeln zu einer vorhandenen IP-Gruppe hinzugefügt**  

```
$Rule = @(
@{IPRule = "10.1.0.0/0"; RuleDesc = "First Rule Added"},
@{IPRule = "10.2.0.0/0"; RuleDesc = "Second Rule Added"}
)

Approve-WKSIpRule -GroupId wsipg-abcnx2fcw -UserRule $Rule
```
+  API-Details finden Sie [ AuthorizeIpRules ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * 

### `Copy-WKSWorkspaceImage`
<a name="workspaces_CopyWorkspaceImage_powershell_5_topic"></a>

Das folgende Codebeispiel zeigt die Verwendung. `Copy-WKSWorkspaceImage`

**Tools für PowerShell V5**  
**Beispiel 1: Dieses Beispiel kopiert das Workspace-Image mit der angegebenen ID von us-west-2 in die aktuelle Region mit dem Namen "" CopiedImageTest **  

```
Copy-WKSWorkspaceImage -Name CopiedImageTest -SourceRegion us-west-2 -SourceImageId wsi-djfoedhw6
```
**Ausgabe:**  

```
wsi-456abaqfe
```
+  API-Details finden Sie [ CopyWorkspaceImage ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * 

### `Edit-WKSClientProperty`
<a name="workspaces_ModifyClientProperties_powershell_5_topic"></a>

Das folgende Codebeispiel zeigt die Verwendung. `Edit-WKSClientProperty`

**Tools für PowerShell V5**  
**Beispiel 1: In diesem Beispiel wird Reconnection für den Workspaces-Client aktiviert**  

```
Edit-WKSClientProperty -Region us-west-2 -ClientProperties_ReconnectEnabled "ENABLED" -ResourceId d-123414a369
```
+  API-Details finden Sie [ ModifyClientProperties ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * 

### `Edit-WKSSelfServicePermission`
<a name="workspaces_ModifySelfservicePermissions_powershell_5_topic"></a>

Das folgende Codebeispiel zeigt die Verwendung. `Edit-WKSSelfServicePermission`

**Tools für PowerShell V5**  
**Beispiel1: In diesem Beispiel werden Self-Service-Berechtigungen zum Ändern des Rechentyps und zum Erhöhen der Volumengröße für das angegebene Verzeichnis aktiviert.**  

```
Edit-WKSSelfservicePermission -Region us-west-2 -ResourceId d-123454a369 -SelfservicePermissions_ChangeComputeType ENABLED -SelfservicePermissions_IncreaseVolumeSize ENABLED
```
+  API-Details finden Sie [ ModifySelfservicePermissions ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * 

### `Edit-WKSWorkspaceAccessProperty`
<a name="workspaces_ModifyWorkspaceAccessProperties_powershell_5_topic"></a>

Das folgende Codebeispiel zeigt die Verwendung. `Edit-WKSWorkspaceAccessProperty`

**Tools für PowerShell V5**  
**Beispiel 1: In diesem Beispiel wird der Workspace-Zugriff auf Android und Chrome OS für das angegebene Verzeichnis aktiviert**  

```
Edit-WKSWorkspaceAccessProperty -Region us-west-2 -ResourceId d-123454a369 -WorkspaceAccessProperties_DeviceTypeAndroid ALLOW -WorkspaceAccessProperties_DeviceTypeChromeOs ALLOW
```
+  API-Details finden Sie [ ModifyWorkspaceAccessProperties ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * 

### `Edit-WKSWorkspaceCreationProperty`
<a name="workspaces_ModifyWorkspaceCreationProperties_powershell_5_topic"></a>

Das folgende Codebeispiel zeigt die Verwendung. `Edit-WKSWorkspaceCreationProperty`

**Tools für PowerShell V5**  
**Beispiel 1: In diesem Beispiel werden beim Erstellen eines Workspace die Standardwerte für Internetzugriff und Wartungsmodus auf „true“ gesetzt**  

```
Edit-WKSWorkspaceCreationProperty -Region us-west-2 -ResourceId d-123454a369 -WorkspaceCreationProperties_EnableInternetAccess $true -WorkspaceCreationProperties_EnableMaintenanceMode $true
```
+  API-Details finden Sie [ ModifyWorkspaceCreationProperties ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * 

### `Edit-WKSWorkspaceProperty`
<a name="workspaces_ModifyWorkspaceProperties_powershell_5_topic"></a>

Das folgende Codebeispiel zeigt die Verwendung. `Edit-WKSWorkspaceProperty`

**Tools für PowerShell V5**  
**Beispiel 1: In diesem Beispiel wird die Eigenschaft Workspace Running Mode für den angegebenen Workspace auf Auto Stop geändert**  

```
Edit-WKSWorkspaceProperty -WorkspaceId ws-w361s100v -Region us-west-2 -WorkspaceProperties_RunningMode AUTO_STOP
```
+  API-Details finden Sie [ ModifyWorkspaceProperties ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * 

### `Edit-WKSWorkspaceState`
<a name="workspaces_ModifyWorkspaceState_powershell_5_topic"></a>

Das folgende Codebeispiel zeigt die Verwendung. `Edit-WKSWorkspaceState`

**Tools für PowerShell V5**  
**Beispiel 1: In diesem Beispiel wird der Status des angegebenen Workspace auf „Verfügbar“ geändert**  

```
Edit-WKSWorkspaceState -WorkspaceId ws-w361s100v -Region us-west-2 -WorkspaceState AVAILABLE
```
+  API-Details finden Sie [ ModifyWorkspaceState ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * 

### `Get-WKSClientProperty`
<a name="workspaces_DescribeClientProperties_powershell_5_topic"></a>

Das folgende Codebeispiel zeigt die Verwendung. `Get-WKSClientProperty`

**Tools für PowerShell V5**  
**Beispiel 1: In diesem Beispiel werden die Client-Eigenschaften des Workspace Client für das angegebene Verzeichnis abgerufen**  

```
Get-WKSClientProperty -ResourceId d-223562a123
```
+  API-Details finden Sie [ DescribeClientProperties ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * 

### `Get-WKSIpGroup`
<a name="workspaces_DescribeIpGroups_powershell_5_topic"></a>

Das folgende Codebeispiel zeigt die Verwendung. `Get-WKSIpGroup`

**Tools für PowerShell V5**  
**Beispiel 1: In diesem Beispiel werden die Details der angegebenen IP-Gruppe in der angegebenen Region abgerufen**  

```
Get-WKSIpGroup -Region us-east-1 -GroupId wsipg-8m1234v45
```
**Ausgabe:**  

```
GroupDesc GroupId         GroupName UserRules
--------- -------         --------- ---------
          wsipg-8m1234v45 TestGroup {Amazon.WorkSpaces.Model.IpRuleItem, Amazon.WorkSpaces.Model.IpRuleItem}
```
+  API-Details finden Sie [ DescribeIpGroups ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * 

### `Get-WKSTag`
<a name="workspaces_DescribeTags_powershell_5_topic"></a>

Das folgende Codebeispiel zeigt die Verwendung. `Get-WKSTag`

**Tools für PowerShell V5**  
**Beispiel 1: In diesem Beispiel wird das Tag für den angegebenen Workspace abgerufen**  

```
Get-WKSTag -WorkspaceId ws-w361s234r -Region us-west-2
```
**Ausgabe:**  

```
Key         Value
---         -----
auto-delete no
purpose     Workbench
```
+  API-Details finden Sie [ DescribeTags ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * 

### `Get-WKSWorkspace`
<a name="workspaces_DescribeWorkspaces_powershell_5_topic"></a>

Das folgende Codebeispiel zeigt die Verwendung. `Get-WKSWorkspace`

**Tools für PowerShell V5**  
**Beispiel 1: Ruft Details aller Ihrer Daten WorkSpaces zur Pipeline ab. **  

```
Get-WKSWorkspace
```
**Ausgabe:**  

```
BundleId                    : wsb-1a2b3c4d
ComputerName                :
DirectoryId                 : d-1a2b3c4d
ErrorCode                   :
ErrorMessage                :
IpAddress                   :
RootVolumeEncryptionEnabled : False
State                       : PENDING
SubnetId                    :
UserName                    : myuser
UserVolumeEncryptionEnabled : False
VolumeEncryptionKey         :
WorkspaceId                 : ws-1a2b3c4d
WorkspaceProperties         : Amazon.WorkSpaces.Model.WorkspaceProperties
```
**Beispiel 2: Dieser Befehl zeigt die Werte der untergeordneten Eigenschaften von `WorkSpaceProperties` für einen Workspace in der `us-west-2`-Region an. Weitere Informationen zu den untergeordneten Eigenschaften von `WorkSpaceProperties` finden Sie unter https://docs.aws.amazon.com/workspaces/latest/api/API\_WorkspaceProperties.html. **  

```
(Get-WKSWorkspace -Region us-west-2 -WorkSpaceId ws-xdaf7hc9s).WorkspaceProperties
```
**Ausgabe:**  

```
        ComputeTypeName                     : STANDARD
        RootVolumeSizeGib                   : 80
        RunningMode                         : AUTO_STOP
        RunningModeAutoStopTimeoutInMinutes : 60
        UserVolumeSizeGib                   : 50
```
**Beispiel 3: Dieser Befehl zeigt den Wert der untergeordneten Eigenschaft `RootVolumeSizeGib` von `WorkSpaceProperties` für einen Workspace in der `us-west-2`-Region an. Die Größe des Root-Volumes in GiB beträgt 80.**  

```
(Get-WKSWorkspace -Region us-west-2 -WorkSpaceId ws-xdaf7hc9s).WorkspaceProperties.RootVolumeSizeGib
```
**Ausgabe:**  

```
        80
```
+  API-Details finden Sie [ DescribeWorkspaces ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * 

### `Get-WKSWorkspaceBundle`
<a name="workspaces_DescribeWorkspaceBundles_powershell_5_topic"></a>

Das folgende Codebeispiel zeigt die Verwendung. `Get-WKSWorkspaceBundle`

**Tools für PowerShell V5**  
**Beispiel 1: In diesem Beispiel werden Details zu allen Workspace-Bundles in der aktuellen Region abgerufen**  

```
Get-WKSWorkspaceBundle
```
**Ausgabe:**  

```
BundleId        : wsb-sfhdgv342
ComputeType     : Amazon.WorkSpaces.Model.ComputeType
Description     : This bundle is custom
ImageId         : wsi-235aeqges
LastUpdatedTime : 12/26/2019 06:44:07
Name            : CustomBundleTest
Owner           : 233816212345
RootStorage     : Amazon.WorkSpaces.Model.RootStorage
UserStorage     : Amazon.WorkSpaces.Model.UserStorage
```
+  API-Details finden Sie [ DescribeWorkspaceBundles ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * 

### `Get-WKSWorkspaceDirectory`
<a name="workspaces_DescribeWorkspaceDirectories_powershell_5_topic"></a>

Das folgende Codebeispiel zeigt die Verwendung. `Get-WKSWorkspaceDirectory`

**Tools für PowerShell V5**  
**Beispiel 1: In diesem Beispiel werden die Verzeichnisdetails für registrierte Verzeichnisse aufgeführt**  

```
Get-WKSWorkspaceDirectory
```
**Ausgabe:**  

```
Alias                       : TestWorkspace
CustomerUserName            : Administrator
DirectoryId                 : d-123414a369
DirectoryName               : TestDirectory.com
DirectoryType               : MicrosoftAD
DnsIpAddresses              : {172.31.43.45, 172.31.2.97}
IamRoleId                   : arn:aws:iam::761234567801:role/workspaces_RoleDefault
IpGroupIds                  : {}
RegistrationCode            : WSpdx+4RRT43
SelfservicePermissions      : Amazon.WorkSpaces.Model.SelfservicePermissions
State                       : REGISTERED
SubnetIds                   : {subnet-1m3m7b43, subnet-ard11aba}
Tenancy                     : SHARED
WorkspaceAccessProperties   : Amazon.WorkSpaces.Model.WorkspaceAccessProperties
WorkspaceCreationProperties : Amazon.WorkSpaces.Model.DefaultWorkspaceCreationProperties
WorkspaceSecurityGroupId    : sg-0ed2441234a123c43
```
+  API-Details finden Sie [ DescribeWorkspaceDirectories ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * 

### `Get-WKSWorkspaceImage`
<a name="workspaces_DescribeWorkspaceImages_powershell_5_topic"></a>

Das folgende Codebeispiel zeigt die Verwendung. `Get-WKSWorkspaceImage`

**Tools für PowerShell V5**  
**Beispiel 1: In diesem Beispiel werden Details zu allen Images in der Region abgerufen**  

```
Get-WKSWorkspaceImage
```
**Ausgabe:**  

```
Description     :This image is copied from another image
ErrorCode       :
ErrorMessage    :
ImageId         : wsi-345ahdjgo
Name            : CopiedImageTest
OperatingSystem : Amazon.WorkSpaces.Model.OperatingSystem
RequiredTenancy : DEFAULT
State           : AVAILABLE
```
+  API-Details finden Sie [ DescribeWorkspaceImages ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * 

### `Get-WKSWorkspaceSnapshot`
<a name="workspaces_DescribeWorkspaceSnapshots_powershell_5_topic"></a>

Das folgende Codebeispiel zeigt die Verwendung. `Get-WKSWorkspaceSnapshot`

**Tools für PowerShell V5**  
**Beispiel 1: Dieses Beispiel zeigt den Zeitstempel des letzten Snapshots, der für den angegebenen Workspace erstellt wurde**  

```
Get-WKSWorkspaceSnapshot -WorkspaceId ws-w361s100v
```
**Ausgabe:**  

```
RebuildSnapshots                   RestoreSnapshots
----------------                   ----------------
{Amazon.WorkSpaces.Model.Snapshot} {Amazon.WorkSpaces.Model.Snapshot}
```
+  API-Details finden Sie [ DescribeWorkspaceSnapshots ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * 

### `Get-WKSWorkspacesConnectionStatus`
<a name="workspaces_DescribeWorkspacesConnectionStatus_powershell_5_topic"></a>

Das folgende Codebeispiel zeigt die Verwendung. `Get-WKSWorkspacesConnectionStatus`

**Tools für PowerShell V5**  
**Beispiel 1: In diesem Beispiel wird der Verbindungsstatus für den angegebenen Workspace abgerufen**  

```
Get-WKSWorkspacesConnectionStatus -WorkspaceId ws-w123s234r
```
+  API-Details finden Sie [ DescribeWorkspacesConnectionStatus ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * 

### `New-WKSIpGroup`
<a name="workspaces_CreateIpGroup_powershell_5_topic"></a>

Das folgende Codebeispiel zeigt die Verwendung. `New-WKSIpGroup`

**Tools für PowerShell V5**  
**Beispiel 1: Dieses Beispiel erstellt eine leere IP-Gruppe mit dem Namen FreshEmptyIpGroup **  

```
New-WKSIpGroup -GroupName "FreshNewIPGroup"
```
**Ausgabe:**  

```
wsipg-w45rty4ty
```
+  API-Details finden Sie [ CreateIpGroup ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * 

### `New-WKSTag`
<a name="workspaces_CreateTags_powershell_5_topic"></a>

Das folgende Codebeispiel zeigt die Verwendung. `New-WKSTag`

**Tools für PowerShell V5**  
**Beispiel 1: In diesem Beispiel wird einem Workspace namens `ws-wsname` ein neues Tag hinzugefügt. Das Tag hat den Schlüssel „Name“ und den Schlüsselwert `AWS_Workspace`.**  

```
$tag = New-Object Amazon.WorkSpaces.Model.Tag
$tag.Key = "Name"
$tag.Value = "AWS_Workspace"
New-WKSTag -Region us-west-2 -WorkspaceId ws-wsname -Tag $tag
```
**Beispiel 1: In diesem Beispiel wird einem Workspace namens `ws-wsname` mehrere Tags hinzugefügt. Ein Tag hat den Schlüssel „Name“ und den Schlüsselwert `AWS_Workspace`; das andere Tag hat den Tag-Schlüssel „Stage“ und den Schlüsselwert „Test“.**  

```
$tag = New-Object Amazon.WorkSpaces.Model.Tag
$tag.Key = "Name"
$tag.Value = "AWS_Workspace"

$tag2 = New-Object Amazon.WorkSpaces.Model.Tag
$tag2.Key = "Stage"
$tag2.Value = "Test"
New-WKSTag -Region us-west-2 -WorkspaceId ws-wsname -Tag $tag,$tag2
```
+  API-Details finden Sie [ CreateTags ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * 

### `New-WKSWorkspace`
<a name="workspaces_CreateWorkspaces_powershell_5_topic"></a>

Das folgende Codebeispiel zeigt die Verwendung. `New-WKSWorkspace`

**Tools für PowerShell V5**  
**Beispiel 1: Erstellen Sie eine WorkSpace für das bereitgestellte Paket, das Verzeichnis und den Benutzer. **  

```
New-WKSWorkspace -Workspace @{"BundleID" = "wsb-1a2b3c4d"; "DirectoryId" = "d-1a2b3c4d"; "UserName" = "USERNAME"}
```
**Beispiel 2: Dieses Beispiel erstellt mehrere WorkSpaces **  

```
New-WKSWorkspace -Workspace @{"BundleID" = "wsb-1a2b3c4d"; "DirectoryId" = "d-1a2b3c4d"; "UserName" = "USERNAME_1"},@{"BundleID" = "wsb-1a2b3c4d"; "DirectoryId" = "d-1a2b3c4d"; "UserName" = "USERNAME_2"}
```
+  API-Details finden Sie [ CreateWorkspaces ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * 

### `Register-WKSIpGroup`
<a name="workspaces_AssociateIpGroups_powershell_5_topic"></a>

Das folgende Codebeispiel zeigt die Verwendung. `Register-WKSIpGroup`

**Tools für PowerShell V5**  
**Beispiel 1: In diesem Beispiel wird die angegebene IP-Gruppe im angegebenen Verzeichnis registriert**  

```
Register-WKSIpGroup -GroupId wsipg-23ahsdres -DirectoryId d-123412e123
```
+  API-Details finden Sie [ AssociateIpGroups ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * 

### `Register-WKSWorkspaceDirectory`
<a name="workspaces_RegisterWorkspaceDirectory_powershell_5_topic"></a>

Das folgende Codebeispiel zeigt die Verwendung. `Register-WKSWorkspaceDirectory`

**Tools für PowerShell V5**  
**Beispiel 1: In diesem Beispiel wird das angegebene Verzeichnis für Workspaces Service registriert**  

```
Register-WKSWorkspaceDirectory -DirectoryId d-123412a123 -EnableWorkDoc $false
```
+  API-Details finden Sie [ RegisterWorkspaceDirectory ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * 

### `Remove-WKSIpGroup`
<a name="workspaces_DeleteIpGroup_powershell_5_topic"></a>

Das folgende Codebeispiel zeigt die Verwendung. `Remove-WKSIpGroup`

**Tools für PowerShell V5**  
**Beispiel 1: In diesem Beispiel wird die angegebene IP-Gruppe gelöscht**  

```
Remove-WKSIpGroup -GroupId wsipg-32fhgtred
```
**Ausgabe:**  

```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-WKSIpGroup (DeleteIpGroup)" on target "wsipg-32fhgtred".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"): Y
```
+  API-Details finden Sie [ DeleteIpGroup ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * 

### `Remove-WKSTag`
<a name="workspaces_DeleteTags_powershell_5_topic"></a>

Das folgende Codebeispiel zeigt die Verwendung. `Remove-WKSTag`

**Tools für PowerShell V5**  
**Beispiel 1: In diesem Beispiel wird das dem Workspace zugeordnete Tag entfernt**  

```
Remove-WKSTag -ResourceId ws-w10b3abcd -TagKey "Type"
```
**Ausgabe:**  

```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-WKSTag (DeleteTags)" on target "ws-w10b3abcd".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"): Y
```
+  API-Details finden Sie [ DeleteTags ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * 

### `Remove-WKSWorkspace`
<a name="workspaces_TerminateWorkspaces_powershell_5_topic"></a>

Das folgende Codebeispiel zeigt die Verwendung. `Remove-WKSWorkspace`

**Tools für PowerShell V5**  
**Beispiel 1: Beendet mehrere WorkSpaces. Die Verwendung der Option -Force verhindert, dass das Cmdlet zur Bestätigung auffordert. **  

```
Remove-WKSWorkspace -WorkspaceId "ws-1a2b3c4d5","ws-6a7b8c9d0" -Force
```
**Beispiel 2: Ruft die Sammlung aller Ihrer IDs ab WorkSpaces und leitet die IDs an den WorkSpaceId Parameter - von weiter Remove-WKSWorkspace, wodurch alle IDs beendet werden. WorkSpaces Das Cmdlet fordert Sie auf, bevor jedes Cmdlet beendet WorkSpace wird. 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 definieren, dass beendet werden WorkSpaces soll. 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
```
+  API-Details finden Sie [ TerminateWorkspaces ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * 

### `Reset-WKSWorkspace`
<a name="workspaces_RebuildWorkspaces_powershell_5_topic"></a>

Das folgende Codebeispiel zeigt die Verwendung. `Reset-WKSWorkspace`

**Tools für PowerShell V5**  
**Beispiel 1: Baut das angegebene neu auf. WorkSpace **  

```
Reset-WKSWorkspace -WorkspaceId "ws-1a2b3c4d"
```
**Beispiel 2: Ruft die Sammlung aller Ihrer IDs ab WorkSpaces und leitet die IDs an den WorkSpaceId Parameter - von weiter Reset-WKSWorkspace, wodurch der WorkSpaces neu erstellt wird. **  

```
Get-WKSWorkspaces | Reset-WKSWorkspace
```
+  API-Details finden Sie [ RebuildWorkspaces ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * 

### `Restart-WKSWorkspace`
<a name="workspaces_RebootWorkspaces_powershell_5_topic"></a>

Das folgende Codebeispiel zeigt die Verwendung. `Restart-WKSWorkspace`

**Tools für PowerShell V5**  
**Beispiel 1: Startet das angegebene neu. WorkSpace **  

```
Restart-WKSWorkspace -WorkspaceId "ws-1a2b3c4d"
```
**Beispiel 2: Startet mehrere WorkSpaces neu. **  

```
Restart-WKSWorkspace -WorkspaceId "ws-1a2b3c4d","ws-5a6b7c8d"
```
**Beispiel 3: Ruft die Sammlung aller Ihrer IDs ab WorkSpaces und leitet die IDs an den WorkSpaceId Parameter - von weiter Restart-WKSWorkspace, wodurch der neu WorkSpaces gestartet wird. **  

```
Get-WKSWorkspaces | Restart-WKSWorkspace
```
+  API-Details finden Sie [ RebootWorkspaces ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * 

### `Stop-WKSWorkspace`
<a name="workspaces_StopWorkspaces_powershell_5_topic"></a>

Das folgende Codebeispiel zeigt die Verwendung. `Stop-WKSWorkspace`

**Tools für PowerShell V5**  
**Beispiel 1: Stoppt mehrere WorkSpaces. **  

```
Stop-WKSWorkspace -WorkspaceId "ws-1a2b3c4d5","ws-6a7b8c9d0"
```
**Beispiel 2: Ruft die Sammlung all Ihrer Daten ab WorkSpaces und leitet die IDs an den WorkSpaceId Parameter - weiter, der Stop-WKSWorkspace bewirkt, dass WorkSpaces das gestoppt wird. **  

```
Get-WKSWorkspaces | Stop-WKSWorkspace
```
**Beispiel 3: Dieses Beispiel zeigt, wie StopRequest Objekte übergeben werden, die definieren, dass gestoppt werden WorkSpaces soll. **  

```
$arrRequest = @()
$request1 = New-Object Amazon.WorkSpaces.Model.StopRequest
$request1.WorkspaceId = 'ws-12345678'
$arrRequest += $request1
$request2 = New-Object Amazon.WorkSpaces.Model.StopRequest
$request2.WorkspaceId = 'ws-abcdefgh'
$arrRequest += $request2
Stop-WKSWorkspace -Request $arrRequest
```
+  API-Details finden Sie [ StopWorkspaces ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * 

### `Unregister-WKSIpGroup`
<a name="workspaces_DisassociateIpGroups_powershell_5_topic"></a>

Das folgende Codebeispiel zeigt die Verwendung. `Unregister-WKSIpGroup`

**Tools für PowerShell V5**  
**Beispiel 1: In diesem Beispiel wird die Registrierung der angegebenen IP-Gruppe im angegebenen Verzeichnis aufgehoben**  

```
Unregister-WKSIpGroup -GroupId wsipg-12abcdphq -DirectoryId d-123454b123
```
+  API-Details finden Sie [ DisassociateIpGroups ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * 