Weitere AWS SDK-Beispiele sind im GitHub Repo [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) 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.
# Grundlegende Beispiele für die Verwendung WorkSpaces AWS SDKs
Die folgenden Codebeispiele zeigen, wie Sie die Grundlagen von Amazon WorkSpaces mit verwenden können AWS SDKs.
**Contents**
+ [Aktionen](workspaces_code_examples_actions.md)
+ [`CreateTags`](workspaces_example_workspaces_CreateTags_section.md)
+ [`CreateWorkspaces`](workspaces_example_workspaces_CreateWorkspaces_section.md)
+ [`DeleteTags`](workspaces_example_workspaces_DeleteTags_section.md)
+ [`DescribeTags`](workspaces_example_workspaces_DescribeTags_section.md)
+ [`DescribeWorkspaceBundles`](workspaces_example_workspaces_DescribeWorkspaceBundles_section.md)
+ [`DescribeWorkspaceDirectories`](workspaces_example_workspaces_DescribeWorkspaceDirectories_section.md)
+ [`DescribeWorkspaces`](workspaces_example_workspaces_DescribeWorkspaces_section.md)
+ [`DescribeWorkspacesConnectionStatus`](workspaces_example_workspaces_DescribeWorkspacesConnectionStatus_section.md)
+ [`ModifyWorkspaceCreationProperties`](workspaces_example_workspaces_ModifyWorkspaceCreationProperties_section.md)
+ [`ModifyWorkspaceProperties`](workspaces_example_workspaces_ModifyWorkspaceProperties_section.md)
+ [`ModifyWorkspaceState`](workspaces_example_workspaces_ModifyWorkspaceState_section.md)
+ [`RebootWorkspaces`](workspaces_example_workspaces_RebootWorkspaces_section.md)
+ [`RebuildWorkspaces`](workspaces_example_workspaces_RebuildWorkspaces_section.md)
+ [`RegisterWorkspaceDirectory`](workspaces_example_workspaces_RegisterWorkspaceDirectory_section.md)
+ [`StopWorkspaces`](workspaces_example_workspaces_StopWorkspaces_section.md)
+ [`TerminateWorkspaces`](workspaces_example_workspaces_TerminateWorkspaces_section.md)
# Aktionen zur WorkSpaces Verwendung AWS SDKs
Die folgenden Codebeispiele zeigen, wie Sie einzelne WorkSpaces Aktionen mit ausführen AWS SDKs. Jedes Beispiel enthält einen Link zu GitHub, wo Sie Anweisungen zum Einrichten und Ausführen des Codes finden.
Die folgenden Beispiele enthalten nur die am häufigsten verwendeten Aktionen. Eine vollständige Liste finden Sie in der [Amazon WorkSpaces API-Referenz](https://docs.aws.amazon.com/workspaces/latest/api/welcome.html).
**Topics**
+ [`CreateTags`](workspaces_example_workspaces_CreateTags_section.md)
+ [`CreateWorkspaces`](workspaces_example_workspaces_CreateWorkspaces_section.md)
+ [`DeleteTags`](workspaces_example_workspaces_DeleteTags_section.md)
+ [`DescribeTags`](workspaces_example_workspaces_DescribeTags_section.md)
+ [`DescribeWorkspaceBundles`](workspaces_example_workspaces_DescribeWorkspaceBundles_section.md)
+ [`DescribeWorkspaceDirectories`](workspaces_example_workspaces_DescribeWorkspaceDirectories_section.md)
+ [`DescribeWorkspaces`](workspaces_example_workspaces_DescribeWorkspaces_section.md)
+ [`DescribeWorkspacesConnectionStatus`](workspaces_example_workspaces_DescribeWorkspacesConnectionStatus_section.md)
+ [`ModifyWorkspaceCreationProperties`](workspaces_example_workspaces_ModifyWorkspaceCreationProperties_section.md)
+ [`ModifyWorkspaceProperties`](workspaces_example_workspaces_ModifyWorkspaceProperties_section.md)
+ [`ModifyWorkspaceState`](workspaces_example_workspaces_ModifyWorkspaceState_section.md)
+ [`RebootWorkspaces`](workspaces_example_workspaces_RebootWorkspaces_section.md)
+ [`RebuildWorkspaces`](workspaces_example_workspaces_RebuildWorkspaces_section.md)
+ [`RegisterWorkspaceDirectory`](workspaces_example_workspaces_RegisterWorkspaceDirectory_section.md)
+ [`StopWorkspaces`](workspaces_example_workspaces_StopWorkspaces_section.md)
+ [`TerminateWorkspaces`](workspaces_example_workspaces_TerminateWorkspaces_section.md)
# Verwendung von `CreateTags` mit einer CLI
Die folgenden Code-Beispiele zeigen, wie `CreateTags` verwendet wird.
------
#### [ CLI ]
**AWS CLI**
**Um Tags zu einem hinzuzufügen WorkSpace**
Im folgenden `create-tags` Beispiel werden die angegebenen Tags zu den angegebenen hinzugefügt WorkSpace.
```
aws workspaces create-tags \
--resource-id ws-dk1xzr417 \
--tags Key=Department,Value=Finance
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [ WorkSpaces Tag-Ressourcen](https://docs.aws.amazon.com/workspaces/latest/adminguide/tag-workspaces-resources.html) im * WorkSpaces Amazon-Administratorhandbuch*.
+ Einzelheiten zur API finden Sie [CreateTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workspaces/create-tags.html)in der *AWS CLI Befehlsreferenz*.
------
#### [ PowerShell ]
**Tools für PowerShell V4**
**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
```
+ Einzelheiten zur API finden Sie unter [CreateTags AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet-Referenz (V4).*
**Tools für V5 PowerShell **
**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
```
+ Einzelheiten zur API finden Sie unter [CreateTags AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
------
# Verwendung von `CreateWorkspaces` mit einer CLI
Die folgenden Code-Beispiele zeigen, wie `CreateWorkspaces` verwendet wird.
------
#### [ CLI ]
**AWS CLI**
**Beispiel 1: Um ein zu erstellen AlwaysOn WorkSpace**
Im folgenden `create-workspaces` Beispiel wird eine AlwaysOn WorkSpace für den angegebenen Benutzer erstellt, wobei das angegebene Verzeichnis und das angegebene Bundle verwendet werden.
```
aws workspaces create-workspaces \
--workspaces DirectoryId=d-926722edaf,UserName=Mateo,BundleId=wsb-0zsvgp8fc
```
Ausgabe:
```
{
"FailedRequests": [],
"PendingRequests": [
{
"WorkspaceId": "ws-kcqms853t",
"DirectoryId": "d-926722edaf",
"UserName": "Mateo",
"State": "PENDING",
"BundleId": "wsb-0zsvgp8fc"
}
]
}
```
**Beispiel 2: Um ein zu erstellen AutoStop WorkSpace**
Im folgenden `create-workspaces` Beispiel wird eine AutoStop WorkSpace für den angegebenen Benutzer erstellt, wobei das angegebene Verzeichnis und das angegebene Bundle verwendet werden.
```
aws workspaces create-workspaces \
--workspaces DirectoryId=d-926722edaf,UserName=Mary,BundleId=wsb-0zsvgp8fc,WorkspaceProperties={RunningMode=AUTO_STOP}
```
Ausgabe:
```
{
"FailedRequests": [],
"PendingRequests": [
{
"WorkspaceId": "ws-dk1xzr417",
"DirectoryId": "d-926722edaf",
"UserName": "Mary",
"State": "PENDING",
"BundleId": "wsb-0zsvgp8fc"
}
]
}
```
**Beispiel 3: Um ein vom Benutzer entkoppeltes Objekt zu erstellen WorkSpace**
Im folgenden `create-workspaces` Beispiel wird eine benutzerentkoppelte Datei erstellt, WorkSpace indem der Benutzername auf gesetzt und ein WorkSpace Name`[UNDEFINED]`, eine Verzeichnis-ID und eine Bundle-ID angegeben werden.
```
aws workspaces create-workspaces \
--workspaces DirectoryId=d-926722edaf,UserName='"[UNDEFINED]"',WorkspaceName=MaryWorkspace1,BundleId=wsb-0zsvgp8fc,WorkspaceProperties={RunningMode=ALWAYS_ON}
```
Ausgabe:
```
{
"FailedRequests": [],
"PendingRequests": [
{
"WorkspaceId": "ws-abcd1234",
"DirectoryId": "d-926722edaf",
"UserName": "[UNDEFINED]",
"State": "PENDING",
"BundleId": "wsb-0zsvgp8fc",
"WorkspaceName": "MaryWorkspace1"
}
]
}
```
Weitere Informationen finden Sie unter [Launch a virtual desktop](https://docs.aws.amazon.com/workspaces/latest/adminguide/launch-workspaces-tutorials.html) im *Amazon WorkSpaces Administration Guide*.
+ Einzelheiten zur API finden Sie [CreateWorkspaces](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workspaces/create-workspaces.html)in der *AWS CLI Befehlsreferenz*.
------
#### [ PowerShell ]
**Tools für PowerShell V4**
**Beispiel 1: Erstellen Sie eine WorkSpace für das bereitgestellte Bundle, Verzeichnis und Benutzer.**
```
New-WKSWorkspace -Workspace @{"BundleID" = "wsb-1a2b3c4d"; "DirectoryId" = "d-1a2b3c4d"; "UserName" = "USERNAME"}
```
**Beispiel 2: In diesem Beispiel werden mehrere erstellt WorkSpaces**
```
New-WKSWorkspace -Workspace @{"BundleID" = "wsb-1a2b3c4d"; "DirectoryId" = "d-1a2b3c4d"; "UserName" = "USERNAME_1"},@{"BundleID" = "wsb-1a2b3c4d"; "DirectoryId" = "d-1a2b3c4d"; "UserName" = "USERNAME_2"}
```
+ Einzelheiten zur API finden Sie unter [CreateWorkspaces AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet-Referenz (V4).*
**Tools für V5 PowerShell **
**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: In diesem Beispiel werden mehrere erstellt WorkSpaces**
```
New-WKSWorkspace -Workspace @{"BundleID" = "wsb-1a2b3c4d"; "DirectoryId" = "d-1a2b3c4d"; "UserName" = "USERNAME_1"},@{"BundleID" = "wsb-1a2b3c4d"; "DirectoryId" = "d-1a2b3c4d"; "UserName" = "USERNAME_2"}
```
+ Einzelheiten zur API finden Sie unter [CreateWorkspaces AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
------
# Verwendung von `DeleteTags` mit einer CLI
Die folgenden Code-Beispiele zeigen, wie `DeleteTags` verwendet wird.
------
#### [ CLI ]
**AWS CLI**
**Um ein Tag aus einem zu löschen WorkSpace**
Im folgenden `delete-tags` Beispiel wird das angegebene Tag aus dem angegebenen WorkSpace Tag gelöscht.
```
aws workspaces delete-tags \
--resource-id ws-dk1xzr417 \
--tag-keys Department
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [ WorkSpaces Tag-Ressourcen](https://docs.aws.amazon.com/workspaces/latest/adminguide/tag-workspaces-resources.html) im * WorkSpaces Amazon-Administratorhandbuch*.
+ Einzelheiten zur API finden Sie [DeleteTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workspaces/delete-tags.html)in der *AWS CLI Befehlsreferenz*.
------
#### [ PowerShell ]
**Tools für PowerShell V4**
**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
```
+ Einzelheiten zur API finden Sie unter [DeleteTags AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet-Referenz (V4).*
**Tools für V5 PowerShell **
**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
```
+ Einzelheiten zur API finden Sie unter [DeleteTags AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
------
# Verwendung von `DescribeTags` mit einer CLI
Die folgenden Code-Beispiele zeigen, wie `DescribeTags` verwendet wird.
------
#### [ CLI ]
**AWS CLI**
**Um die Tags für ein zu beschreiben WorkSpace**
Das folgende `describe-tags` Beispiel beschreibt die Tags für die angegebenen WorkSpace.
```
aws workspaces describe-tags \
--resource-id ws-dk1xzr417
```
Ausgabe:
```
{
"TagList": [
{
"Key": "Department",
"Value": "Finance"
}
]
}
```
Weitere Informationen finden Sie unter [ WorkSpaces Tag-Ressourcen](https://docs.aws.amazon.com/workspaces/latest/adminguide/tag-workspaces-resources.html) im * WorkSpaces Amazon-Administratorhandbuch*.
+ Einzelheiten zur API finden Sie [DescribeTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workspaces/describe-tags.html)in der *AWS CLI Befehlsreferenz*.
------
#### [ PowerShell ]
**Tools für PowerShell V4**
**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
```
+ Einzelheiten zur API finden Sie unter [DescribeTags AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet-Referenz (V4).*
**Tools für V5 PowerShell **
**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
```
+ Einzelheiten zur API finden Sie unter [DescribeTags AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
------
# Verwendung von `DescribeWorkspaceBundles` mit einer CLI
Die folgenden Code-Beispiele zeigen, wie `DescribeWorkspaceBundles` verwendet wird.
------
#### [ CLI ]
**AWS CLI**
**So listen Sie die von Amazon bereitgestellten Bundles auf**
Das folgende `describe-workspace-bundles` Beispiel listet die Namen und die IDs von Amazon bereitgestellten Bundles im Tabellenformat und sortiert nach Namen auf.
```
aws workspaces describe-workspace-bundles \
--owner AMAZON \
--query "Bundles[*].[Name, BundleId]"
```
Ausgabe:
```
[
[
"Standard with Amazon Linux 2",
"wsb-clj85qzj1"
],
[
"Performance with Windows 10 (Server 2016 based)",
"wsb-gm4d5tx2v"
],
[
"PowerPro with Windows 7",
"wsb-1pzkp0bx4"
],
[
"Power with Amazon Linux 2",
"wsb-2bs6k5lgn"
],
[
"Graphics with Windows 10 (Server 2019 based)",
"wsb-03gyjnfyy"
],
...
]
```
Weitere Informationen finden Sie unter [WorkSpaces Bundles und Images](https://docs.aws.amazon.com/workspaces/latest/adminguide/amazon-workspaces-bundles.html) im *Amazon WorkSpaces Administration Guide*.
+ Einzelheiten zur API finden Sie [DescribeWorkspaceBundles](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workspaces/describe-workspace-bundles.html)in der *AWS CLI Befehlsreferenz.*
------
#### [ PowerShell ]
**Tools für PowerShell V4**
**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
```
+ Einzelheiten zur API finden Sie unter [DescribeWorkspaceBundles AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet-Referenz (V4).*
**Tools für V5 PowerShell **
**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
```
+ Einzelheiten zur API finden Sie unter [DescribeWorkspaceBundles AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
------
# Verwendung von `DescribeWorkspaceDirectories` mit einer CLI
Die folgenden Code-Beispiele zeigen, wie `DescribeWorkspaceDirectories` verwendet wird.
------
#### [ CLI ]
**AWS CLI**
**So beschreiben Sie ein registriertes Verzeichnis**
Im folgenden Beispiel für `describe-workspace-directories` wird das angegebene registrierte Verzeichnis beschrieben.
```
aws workspaces describe-workspace-directories \
--directory-ids d-926722edaf
```
Ausgabe:
```
{
"Directories": [
{
"DirectoryId": "d-926722edaf",
"Alias": "d-926722edaf",
"DirectoryName": "example.com",
"RegistrationCode": "WSpdx+9RJ8JT",
"SubnetIds": [
"subnet-9d19c4c6",
"subnet-500d5819"
],
"DnsIpAddresses": [
"172.16.1.140",
"172.16.0.30"
],
"CustomerUserName": "Administrator",
"IamRoleId": "arn:aws:iam::123456789012:role/workspaces_DefaultRole",
"DirectoryType": "SIMPLE_AD",
"WorkspaceSecurityGroupId": "sg-0d89e927e5645d7c5",
"State": "REGISTERED",
"WorkspaceCreationProperties": {
"EnableInternetAccess": false,
"UserEnabledAsLocalAdministrator": true,
"EnableMaintenanceMode": true
},
"WorkspaceAccessProperties": {
"DeviceTypeWindows": "ALLOW",
"DeviceTypeOsx": "ALLOW",
"DeviceTypeWeb": "DENY",
"DeviceTypeIos": "ALLOW",
"DeviceTypeAndroid": "ALLOW",
"DeviceTypeChromeOs": "ALLOW",
"DeviceTypeZeroClient": "ALLOW",
"DeviceTypeLinux": "DENY"
},
"Tenancy": "SHARED",
"SelfservicePermissions": {
"RestartWorkspace": "ENABLED",
"IncreaseVolumeSize": "DISABLED",
"ChangeComputeType": "DISABLED",
"SwitchRunningMode": "DISABLED",
"RebuildWorkspace": "DISABLED"
}
}
]
}
```
Weitere Informationen finden Sie unter [Verzeichnisse für WorkSpaces Personal verwalten](https://docs.aws.amazon.com/workspaces/latest/adminguide/manage-workspaces-directory.html) im * WorkSpaces Amazon-Administratorhandbuch*.
+ Einzelheiten zur API finden Sie [DescribeWorkspaceDirectories](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workspaces/describe-workspace-directories.html)in der *AWS CLI Befehlsreferenz*.
------
#### [ PowerShell ]
**Tools für PowerShell V4**
**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
```
+ Einzelheiten zur API finden Sie unter [DescribeWorkspaceDirectories AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet-Referenz (V4).*
**Tools für V5 PowerShell **
**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
```
+ Einzelheiten zur API finden Sie unter [DescribeWorkspaceDirectories AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
------
# Verwendung von `DescribeWorkspaces` mit einer CLI
Die folgenden Code-Beispiele zeigen, wie `DescribeWorkspaces` verwendet wird.
------
#### [ CLI ]
**AWS CLI**
**Um ein zu beschreiben WorkSpace**
Das folgende `describe-workspaces` Beispiel beschreibt den angegebenen WorkSpace.
```
aws workspaces describe-workspaces \
--workspace-ids ws-dk1xzr417
```
Ausgabe:
```
{
"Workspaces": [
{
"WorkspaceId": "ws-dk1xzr417",
"DirectoryId": "d-926722edaf",
"UserName": "Mary",
"IpAddress": "172.16.0.175",
"State": "STOPPED",
"BundleId": "wsb-0zsvgp8fc",
"SubnetId": "subnet-500d5819",
"ComputerName": "WSAMZN-RBSLTTD9",
"WorkspaceProperties": {
"RunningMode": "AUTO_STOP",
"RunningModeAutoStopTimeoutInMinutes": 60,
"RootVolumeSizeGib": 80,
"UserVolumeSizeGib": 10,
"ComputeTypeName": "VALUE"
},
"ModificationStates": []
}
]
}
```
Weitere Informationen finden Sie unter [Verwalten Sie Ihre WorkSpaces](https://docs.aws.amazon.com/workspaces/latest/adminguide/administer-workspaces.html) im * WorkSpaces Amazon-Administratorhandbuch*.
+ Einzelheiten zur API finden Sie [DescribeWorkspaces](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workspaces/describe-workspaces.html)in der *AWS CLI Befehlsreferenz.*
------
#### [ PowerShell ]
**Tools für PowerShell V4**
**Beispiel 1: Ruft Details aller Ihrer Verbindungen 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 finden Sie `WorkSpaceProperties` unter https://docs.aws.amazon.com/workspaces/ latest/api/API \$1 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
```
+ Einzelheiten zur API finden Sie unter [DescribeWorkspaces AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet-Referenz (V4).*
**Tools für V5 PowerShell **
**Beispiel 1: Ruft Details aller Ihrer Verbindungen 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 finden Sie `WorkSpaceProperties` unter https://docs.aws.amazon.com/workspaces/ latest/api/API \$1 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
```
+ Einzelheiten zur API finden Sie unter [DescribeWorkspaces AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
------
# Verwendung von `DescribeWorkspacesConnectionStatus` mit einer CLI
Die folgenden Code-Beispiele zeigen, wie `DescribeWorkspacesConnectionStatus` verwendet wird.
------
#### [ CLI ]
**AWS CLI**
**Zur Beschreibung des Verbindungsstatus eines WorkSpace**
Das folgende `describe-workspaces-connection-status` Beispiel beschreibt den Verbindungsstatus des angegebenen WorkSpace.
```
aws workspaces describe-workspaces-connection-status \
--workspace-ids ws-dk1xzr417
```
Ausgabe:
```
{
"WorkspacesConnectionStatus": [
{
"WorkspaceId": "ws-dk1xzr417",
"ConnectionState": "CONNECTED",
"ConnectionStateCheckTimestamp": 1662526214.744
}
]
}
```
Weitere Informationen finden Sie unter [Verwalten Sie Ihre WorkSpaces](https://docs.aws.amazon.com/workspaces/latest/adminguide/administer-workspaces.html) im * WorkSpaces Amazon-Administratorhandbuch*.
+ Einzelheiten zur API finden Sie [DescribeWorkspacesConnectionStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workspaces/describe-workspaces-connection-status.html)in der *AWS CLI Befehlsreferenz.*
------
#### [ PowerShell ]
**Tools für PowerShell V4**
**Beispiel 1: In diesem Beispiel wird der Verbindungsstatus für den angegebenen Workspace abgerufen**
```
Get-WKSWorkspacesConnectionStatus -WorkspaceId ws-w123s234r
```
+ Einzelheiten zur API finden Sie unter [DescribeWorkspacesConnectionStatus AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet-Referenz (V4).*
**Tools für V5 PowerShell **
**Beispiel 1: In diesem Beispiel wird der Verbindungsstatus für den angegebenen Workspace abgerufen**
```
Get-WKSWorkspacesConnectionStatus -WorkspaceId ws-w123s234r
```
+ Einzelheiten zur API finden Sie unter [DescribeWorkspacesConnectionStatus AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
------
# Verwendung von `ModifyWorkspaceCreationProperties` mit einer CLI
Die folgenden Code-Beispiele zeigen, wie `ModifyWorkspaceCreationProperties` verwendet wird.
------
#### [ CLI ]
**AWS CLI**
**Um die WorkSpace Erstellungseigenschaft eines Verzeichnisses zu ändern**
Im folgenden Beispiel für `modify-workspace-creation-properties` wird die `EnableInternetAccess`-Eigenschaft für das angegebene Verzeichnis aktiviert. Dies ermöglicht die automatische Zuweisung von öffentlichen IP-Adressen für das Verzeichnis, das für das Verzeichnis WorkSpaces erstellt wurde.
```
aws workspaces modify-workspace-creation-properties \
--resource-id d-926722edaf \
--workspace-creation-properties EnableInternetAccess=true
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Verzeichnisdetails für Sie aktualisieren WorkSpaces](https://docs.aws.amazon.com/workspaces/latest/adminguide/update-directory-details.html) im * WorkSpaces Amazon-Administratorhandbuch*.
+ Einzelheiten zur API finden Sie [ModifyWorkspaceCreationProperties](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workspaces/modify-workspace-creation-properties.html)unter *AWS CLI Befehlsreferenz*.
------
#### [ PowerShell ]
**Tools für PowerShell V4**
**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
```
+ Einzelheiten zur API finden Sie unter [ModifyWorkspaceCreationProperties AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet-Referenz (V4).*
**Tools für V5 PowerShell **
**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
```
+ Einzelheiten zur API finden Sie unter [ModifyWorkspaceCreationProperties AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
------
# Verwendung von `ModifyWorkspaceProperties` mit einer CLI
Die folgenden Code-Beispiele zeigen, wie `ModifyWorkspaceProperties` verwendet wird.
------
#### [ CLI ]
**AWS CLI**
**Um den Betriebsmodus eines zu ändern WorkSpace**
Im folgenden `modify-workspace-properties` Beispiel wird der angegebene Laufmodus WorkSpace auf gesetzt`AUTO_STOP`.
```
aws workspaces modify-workspace-properties \
--workspace-id ws-dk1xzr417 \
--workspace-properties RunningMode=AUTO_STOP
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Modify a WorkSpace](https://docs.aws.amazon.com/workspaces/latest/adminguide/modify-workspaces.html) im * WorkSpaces Amazon-Administratorhandbuch*.
+ Einzelheiten zur API finden Sie [ModifyWorkspaceProperties](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workspaces/modify-workspace-properties.html)in der *AWS CLI Befehlsreferenz*.
------
#### [ PowerShell ]
**Tools für PowerShell V4**
**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
```
+ Einzelheiten zur API finden Sie unter [ModifyWorkspaceProperties AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet-Referenz (V4).*
**Tools für V5 PowerShell **
**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
```
+ Einzelheiten zur API finden Sie unter [ModifyWorkspaceProperties AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
------
# Verwendung von `ModifyWorkspaceState` mit einer CLI
Die folgenden Code-Beispiele zeigen, wie `ModifyWorkspaceState` verwendet wird.
------
#### [ CLI ]
**AWS CLI**
**Um den Status eines zu ändern WorkSpace**
Im folgenden `modify-workspace-state` Beispiel wird der angegebene Status WorkSpace auf gesetzt`ADMIN_MAINTENANCE`.
```
aws workspaces modify-workspace-state \
--workspace-id ws-dk1xzr417 \
--workspace-state ADMIN_MAINTENANCE
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [WorkSpace Wartung](https://docs.aws.amazon.com/workspaces/latest/adminguide/workspace-maintenance.html) im * WorkSpaces Amazon-Administratorhandbuch*.
+ Einzelheiten zur API finden Sie [ModifyWorkspaceState](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workspaces/modify-workspace-state.html)in der *AWS CLI Befehlsreferenz*.
------
#### [ PowerShell ]
**Tools für PowerShell V4**
**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
```
+ Einzelheiten zur API finden Sie unter [ModifyWorkspaceState AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet-Referenz (V4).*
**Tools für V5 PowerShell **
**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
```
+ Einzelheiten zur API finden Sie unter [ModifyWorkspaceState AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
------
# Verwendung von `RebootWorkspaces` mit einer CLI
Die folgenden Code-Beispiele zeigen, wie `RebootWorkspaces` verwendet wird.
------
#### [ CLI ]
**AWS CLI**
**Um einen neu zu starten WorkSpace**
Im folgenden `reboot-workspaces` Beispiel wird der angegebene WorkSpace neu gestartet.
```
aws workspaces reboot-workspaces \
--reboot-workspace-requests ws-dk1xzr417
```
Ausgabe:
```
{
"FailedRequests": []
}
```
Weitere Informationen finden Sie unter [Reboot a WorkSpace](https://docs.aws.amazon.com/workspaces/latest/adminguide/reboot-workspaces.html) im * WorkSpaces Amazon-Administratorhandbuch*.
+ Einzelheiten zur API finden Sie [RebootWorkspaces](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workspaces/reboot-workspaces.html)in der *AWS CLI Befehlsreferenz*.
------
#### [ PowerShell ]
**Tools für PowerShell V4**
**Beispiel 1: Startet den angegebenen WorkSpace neu.**
```
Restart-WKSWorkspace -WorkspaceId "ws-1a2b3c4d"
```
**Beispiel 2: Startet mehrere neu. WorkSpaces**
```
Restart-WKSWorkspace -WorkspaceId "ws-1a2b3c4d","ws-5a6b7c8d"
```
**Beispiel 3: Ruft die Sammlung all Ihrer Daten ab WorkSpaces und leitet sie IDs an den WorkSpaceId Parameter - von Restart- weiterWKSWorkspace, wodurch der WorkSpaces neu gestartet wird.**
```
Get-WKSWorkspaces | Restart-WKSWorkspace
```
+ Einzelheiten zur API finden Sie unter [RebootWorkspaces AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet-Referenz* (V4).
**Tools für V5 PowerShell **
**Beispiel 1: Startet den angegebenen neu. WorkSpace**
```
Restart-WKSWorkspace -WorkspaceId "ws-1a2b3c4d"
```
**Beispiel 2: Startet mehrere neu. WorkSpaces**
```
Restart-WKSWorkspace -WorkspaceId "ws-1a2b3c4d","ws-5a6b7c8d"
```
**Beispiel 3: Ruft die Sammlung all Ihrer Daten ab WorkSpaces und leitet sie IDs an den WorkSpaceId Parameter - von Restart- weiterWKSWorkspace, wodurch der WorkSpaces neu gestartet wird.**
```
Get-WKSWorkspaces | Restart-WKSWorkspace
```
+ Einzelheiten zur API finden Sie unter [RebootWorkspaces AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
------
# Verwendung von `RebuildWorkspaces` mit einer CLI
Die folgenden Code-Beispiele zeigen, wie `RebuildWorkspaces` verwendet wird.
------
#### [ CLI ]
**AWS CLI**
**Um ein neu aufzubauen WorkSpace**
Im folgenden `rebuild-workspaces` Beispiel wird das angegebene WorkSpace neu erstellt.
```
aws workspaces rebuild-workspaces \
--rebuild-workspace-requests ws-dk1xzr417
```
Ausgabe:
```
{
"FailedRequests": []
}
```
Weitere Informationen finden Sie unter [Rebuild a WorkSpace](https://docs.aws.amazon.com/workspaces/latest/adminguide/rebuild-workspace.html) im *Amazon WorkSpaces Administration Guide*.
+ Einzelheiten zur API finden Sie [RebuildWorkspaces](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workspaces/rebuild-workspaces.html)in der *AWS CLI Befehlsreferenz*.
------
#### [ PowerShell ]
**Tools für PowerShell V4**
**Beispiel 1: Baut die angegebene WorkSpace Datei neu auf.**
```
Reset-WKSWorkspace -WorkspaceId "ws-1a2b3c4d"
```
**Beispiel 2: Ruft die Sammlung aller Ihrer Dateien ab WorkSpaces und leitet sie IDs an den WorkSpaceId -Parameter von Reset- weiterWKSWorkspace, wodurch der WorkSpaces neu erstellt wird.**
```
Get-WKSWorkspaces | Reset-WKSWorkspace
```
+ Einzelheiten zur API finden Sie unter [RebuildWorkspaces AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet-Referenz (*V4).
**Tools für V5 PowerShell **
**Beispiel 1: Baut die angegebene Datei neu auf. WorkSpace**
```
Reset-WKSWorkspace -WorkspaceId "ws-1a2b3c4d"
```
**Beispiel 2: Ruft die Sammlung aller Ihrer Dateien ab WorkSpaces und leitet sie IDs an den WorkSpaceId -Parameter von Reset- weiterWKSWorkspace, wodurch der WorkSpaces neu erstellt wird.**
```
Get-WKSWorkspaces | Reset-WKSWorkspace
```
+ Einzelheiten zur API finden Sie unter [RebuildWorkspaces AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
------
# Verwendung von `RegisterWorkspaceDirectory` mit einer CLI
Die folgenden Code-Beispiele zeigen, wie `RegisterWorkspaceDirectory` verwendet wird.
------
#### [ CLI ]
**AWS CLI**
**Um ein Verzeichnis zu registrieren**
Im folgenden `register-workspace-directory` Beispiel wird das angegebene Verzeichnis für die Verwendung mit Amazon registriert WorkSpaces.
```
aws workspaces register-workspace-directory \
--directory-id d-926722edaf
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Registrieren eines vorhandenen AWS Directory Service Service-Verzeichnisses bei WorkSpaces Personal](https://docs.aws.amazon.com/workspaces/latest/adminguide/register-deregister-directory.html) im *Amazon WorkSpaces Administration Guide*.
+ Einzelheiten zur API finden Sie [RegisterWorkspaceDirectory](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workspaces/register-workspace-directory.html)unter *AWS CLI Befehlsreferenz*.
------
#### [ PowerShell ]
**Tools für PowerShell V4**
**Beispiel 1: In diesem Beispiel wird das angegebene Verzeichnis für Workspaces Service registriert**
```
Register-WKSWorkspaceDirectory -DirectoryId d-123412a123 -EnableWorkDoc $false
```
+ Einzelheiten zur API finden Sie unter [RegisterWorkspaceDirectory AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet-Referenz (V4).*
**Tools für V5 PowerShell **
**Beispiel 1: In diesem Beispiel wird das angegebene Verzeichnis für Workspaces Service registriert**
```
Register-WKSWorkspaceDirectory -DirectoryId d-123412a123 -EnableWorkDoc $false
```
+ Einzelheiten zur API finden Sie unter [RegisterWorkspaceDirectory AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
------
# Verwendung von `StopWorkspaces` mit einer CLI
Die folgenden Code-Beispiele zeigen, wie `StopWorkspaces` verwendet wird.
------
#### [ CLI ]
**AWS CLI**
**Um ein zu stoppen AutoStop WorkSpace**
Im folgenden `stop-workspaces` Beispiel wird der angegebene Vorgang beendet WorkSpace. Der WorkSpace muss den Betriebsmodus haben`AutoStop`.
```
aws workspaces stop-workspaces \
--stop-workspace-requests WorkspaceId=ws-dk1xzr417
```
Ausgabe:
```
{
"FailedRequests": []
}
```
Weitere Informationen finden Sie unter [Stopp und Start AutoStop WorkSpace im * WorkSpaces Amazon-Administratorhandbuch*](https://docs.aws.amazon.com/workspaces/latest/adminguide/running-mode.html#stop-start-workspace).
+ Einzelheiten zur API finden Sie [StopWorkspaces](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workspaces/stop-workspaces.html)in der *AWS CLI Befehlsreferenz*.
------
#### [ PowerShell ]
**Tools für PowerShell V4**
**Beispiel 1: Stoppt mehrere WorkSpaces.**
```
Stop-WKSWorkspace -WorkspaceId "ws-1a2b3c4d5","ws-6a7b8c9d0"
```
**Beispiel 2: Ruft die Sammlung all Ihrer Daten ab WorkSpaces und leitet sie IDs an den WorkSpaceId Parameter - von Stop- weiter WorkSpaces , WKSWorkspace wodurch der gestoppt wird.**
```
Get-WKSWorkspaces | Stop-WKSWorkspace
```
**Beispiel 3: Dieses Beispiel zeigt, wie StopRequest Objekte übergeben werden, die definieren, was 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
```
+ Einzelheiten zur API finden Sie unter [StopWorkspaces AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet-Referenz (V4).*
**Tools für V5 PowerShell **
**Beispiel 1: Stoppt mehrere WorkSpaces.**
```
Stop-WKSWorkspace -WorkspaceId "ws-1a2b3c4d5","ws-6a7b8c9d0"
```
**Beispiel 2: Ruft die Sammlung all Ihrer Daten ab WorkSpaces und leitet sie IDs an den WorkSpaceId Parameter - von Stop- weiter WorkSpaces , WKSWorkspace wodurch der gestoppt wird.**
```
Get-WKSWorkspaces | Stop-WKSWorkspace
```
**Beispiel 3: Dieses Beispiel zeigt, wie StopRequest Objekte übergeben werden, die definieren, was 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
```
+ Einzelheiten zur API finden Sie unter [StopWorkspaces AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
------
# Verwendung von `TerminateWorkspaces` mit einer CLI
Die folgenden Code-Beispiele zeigen, wie `TerminateWorkspaces` verwendet wird.
------
#### [ CLI ]
**AWS CLI**
**Um ein zu beenden WorkSpace**
Im folgenden Beispiel für `terminate-workspaces` 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](https://docs.aws.amazon.com/workspaces/latest/adminguide/delete-workspaces.html) im * WorkSpaces Amazon-Administratorhandbuch*.
+ Einzelheiten zur API finden Sie [TerminateWorkspaces](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workspaces/terminate-workspaces.html)in der *AWS CLI Befehlsreferenz*.
------
#### [ PowerShell ]
**Tools für PowerShell V4**
**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 Auflistung aller Ihrer Daten ab WorkSpaces und leitet sie über die Pipeline IDs an den WorkSpaceId Parameter - von Remove- WKSWorkspace weiter, wodurch alle von. WorkSpaces Das Cmdlet fragt nach, bevor jedes Cmdlet beendet wird. WorkSpace 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 sie beendet werden WorkSpaces sollen. 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
```
+ Einzelheiten zur API finden Sie unter [TerminateWorkspaces AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet-Referenz (V4).*
**Tools für V5 PowerShell **
**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 Auflistung aller Ihrer Daten ab WorkSpaces und leitet sie über die Pipeline IDs an den WorkSpaceId Parameter - von Remove- WKSWorkspace weiter, wodurch alle von. WorkSpaces Das Cmdlet fragt nach, bevor jedes Cmdlet beendet wird. WorkSpace 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 sie beendet werden WorkSpaces sollen. 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
```
+ Einzelheiten zur API finden Sie unter [TerminateWorkspaces AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
------