

Doc AWS SDK Examples GitHub リポジトリには、他にも SDK の例があります。 [AWS](https://github.com/awsdocs/aws-doc-sdk-examples)

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Tools for PowerShell V4 を使用した WorkSpaces の例
<a name="powershell_4_workspaces_code_examples"></a>

次のコード例は、WorkSpaces で AWS Tools for PowerShell V4 を使用してアクションを実行し、一般的なシナリオを実装する方法を示しています。

*アクション*はより大きなプログラムからのコードの抜粋であり、コンテキスト内で実行する必要があります。アクションは個々のサービス機能を呼び出す方法を示していますが、コンテキスト内のアクションは、関連するシナリオで確認できます。

各例には完全なソースコードへのリンクが含まれており、コードの設定方法と実行方法に関する手順を確認できます。

**Topics**
+ [アクション](#actions)

## アクション
<a name="actions"></a>

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

次のコード例は、`Approve-WKSIpRule` を使用する方法を示しています。

**Tools for PowerShell V4**  
**例 1: この例では、既存の IP グループにルールを追加します。**  

```
$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 の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V4)* の「[AuthorizeIpRules](https://docs.aws.amazon.com/powershell/v4/reference)」を参照してください。

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

次のコード例は、`Copy-WKSWorkspaceImage` を使用する方法を示しています。

**Tools for PowerShell V4**  
**例 1: この例では、指定 ID を持つワークスペースイメージを、us-west-2 から「CopiedImageTest」という名前の現在のリージョンにコピーします。**  

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

```
wsi-456abaqfe
```
+  API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V4)* の「[CopyWorkspaceImage](https://docs.aws.amazon.com/powershell/v4/reference)」を参照してください。

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

次のコード例は、`Edit-WKSClientProperty` を使用する方法を示しています。

**Tools for PowerShell V4**  
**例 1: この例では、WorkSpaces クライアントの再接続を有効にします**  

```
Edit-WKSClientProperty -Region us-west-2 -ClientProperties_ReconnectEnabled "ENABLED" -ResourceId d-123414a369
```
+  API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V4)* の「[ModifyClientProperties](https://docs.aws.amazon.com/powershell/v4/reference)」を参照してください。

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

次のコード例は、`Edit-WKSSelfServicePermission` を使用する方法を示しています。

**Tools for PowerShell V4**  
**例 1: この例では、セルフサービスのアクセス許可を有効にして、指定ディレクトリのコンピューティングタイプを変更し、ボリュームサイズを増やせるようにします。**  

```
Edit-WKSSelfservicePermission -Region us-west-2 -ResourceId d-123454a369 -SelfservicePermissions_ChangeComputeType ENABLED -SelfservicePermissions_IncreaseVolumeSize ENABLED
```
+  API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V4)* の「[ModifySelfservicePermissions](https://docs.aws.amazon.com/powershell/v4/reference)」を参照してください。

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

次のコード例は、`Edit-WKSWorkspaceAccessProperty` を使用する方法を示しています。

**Tools for PowerShell V4**  
**例 1: この例では、指定ディレクトリの Android と Chrome OS で Workspace アクセスを有効にします。**  

```
Edit-WKSWorkspaceAccessProperty -Region us-west-2 -ResourceId d-123454a369 -WorkspaceAccessProperties_DeviceTypeAndroid ALLOW -WorkspaceAccessProperties_DeviceTypeChromeOs ALLOW
```
+  API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V4)* の「[ModifyWorkspaceAccessProperties](https://docs.aws.amazon.com/powershell/v4/reference)」を参照してください。

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

次のコード例は、`Edit-WKSWorkspaceCreationProperty` を使用する方法を示しています。

**Tools for PowerShell V4**  
**例 1: このサンプルでは、Workspace の作成中にインターネットアクセスとメンテナンスモードをデフォルト値として true に設定します。**  

```
Edit-WKSWorkspaceCreationProperty -Region us-west-2 -ResourceId d-123454a369 -WorkspaceCreationProperties_EnableInternetAccess $true -WorkspaceCreationProperties_EnableMaintenanceMode $true
```
+  API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V4)* の「[ModifyWorkspaceCreationProperties](https://docs.aws.amazon.com/powershell/v4/reference)」を参照してください。

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

次のコード例は、`Edit-WKSWorkspaceProperty` を使用する方法を示しています。

**Tools for PowerShell V4**  
**例 1: このサンプルは、指定された Workspace の Workspace 実行モードプロパティを Auto Stop に変更します。**  

```
Edit-WKSWorkspaceProperty -WorkspaceId ws-w361s100v -Region us-west-2 -WorkspaceProperties_RunningMode AUTO_STOP
```
+  API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V4)* の「[ModifyWorkspaceProperties](https://docs.aws.amazon.com/powershell/v4/reference)」を参照してください。

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

次のコード例は、`Edit-WKSWorkspaceState` を使用する方法を示しています。

**Tools for PowerShell V4**  
**例 1: このサンプルは、指定された Workspace の状態を Available に変更します。**  

```
Edit-WKSWorkspaceState -WorkspaceId ws-w361s100v -Region us-west-2 -WorkspaceState AVAILABLE
```
+  API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V4)* の「[ModifyWorkspaceState](https://docs.aws.amazon.com/powershell/v4/reference)」を参照してください。

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

次のコード例は、`Get-WKSClientProperty` を使用する方法を示しています。

**Tools for PowerShell V4**  
**例 1: この例では、指定ディレクトリのワークスペースクライアントのクライアントプロパティを取得します。**  

```
Get-WKSClientProperty -ResourceId d-223562a123
```
+  API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V4)* の「[DescribeClientProperties](https://docs.aws.amazon.com/powershell/v4/reference)」を参照してください。

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

次のコード例は、`Get-WKSIpGroup` を使用する方法を示しています。

**Tools for PowerShell V4**  
**例 1: この例では、指定リージョン内の指定 IP グループの詳細を取得します。**  

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

```
GroupDesc GroupId         GroupName UserRules
--------- -------         --------- ---------
          wsipg-8m1234v45 TestGroup {Amazon.WorkSpaces.Model.IpRuleItem, Amazon.WorkSpaces.Model.IpRuleItem}
```
+  API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V4)* の「[DescribeIpGroups](https://docs.aws.amazon.com/powershell/v4/reference)」を参照してください。

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

次のコード例は、`Get-WKSTag` を使用する方法を示しています。

**Tools for PowerShell V4**  
**例 1: このサンプルは、指定された Workspace のタグを取得します。**  

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

```
Key         Value
---         -----
auto-delete no
purpose     Workbench
```
+  API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V4)* の「[DescribeTags](https://docs.aws.amazon.com/powershell/v4/reference)」を参照してください。

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

次のコード例は、`Get-WKSWorkspace` を使用する方法を示しています。

**Tools for PowerShell V4**  
**例 1: すべての WorkSpaces の詳細をパイプラインに取得します。**  

```
Get-WKSWorkspace
```
**出力:**  

```
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
```
**例 2: このコマンドは、`us-west-2` リージョンのワークスペースの `WorkSpaceProperties` の子プロパティの値を表示します。`WorkSpaceProperties` の子プロパティの詳細については、https://docs.aws.amazon.com/workspaces/latest/api/API\$1WorkspaceProperties.html を参照してください。**  

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

```
        ComputeTypeName                     : STANDARD
        RootVolumeSizeGib                   : 80
        RunningMode                         : AUTO_STOP
        RunningModeAutoStopTimeoutInMinutes : 60
        UserVolumeSizeGib                   : 50
```
**例 3: このコマンドは、`us-west-2` リージョン内のワークスペースにおける `WorkSpaceProperties` の子プロパティ `RootVolumeSizeGib` の値を表示します。GiB 単位のルートボリュームサイズは 80 です。**  

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

```
        80
```
+  API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V4)* の「[DescribeWorkspaces](https://docs.aws.amazon.com/powershell/v4/reference)」を参照してください。

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

次のコード例は、`Get-WKSWorkspaceBundle` を使用する方法を示しています。

**Tools for PowerShell V4**  
**例 1: このサンプルは、現在のリージョンのすべての Workspace バンドルの詳細を取得します。**  

```
Get-WKSWorkspaceBundle
```
**出力:**  

```
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 の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V4)* の「[DescribeWorkspaceBundles](https://docs.aws.amazon.com/powershell/v4/reference)」を参照してください。

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

次のコード例は、`Get-WKSWorkspaceDirectory` を使用する方法を示しています。

**Tools for PowerShell V4**  
**例 1: このサンプルは、登録されたディレクトリの詳細を一覧表示します。**  

```
Get-WKSWorkspaceDirectory
```
**出力:**  

```
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 の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V4)* の「[DescribeWorkspaceDirectories](https://docs.aws.amazon.com/powershell/v4/reference)」を参照してください。

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

次のコード例は、`Get-WKSWorkspaceImage` を使用する方法を示しています。

**Tools for PowerShell V4**  
**例 1: この例では、リージョン内のすべてのイメージの詳細をすべて取得します。**  

```
Get-WKSWorkspaceImage
```
**出力:**  

```
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 の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V4)* の「[DescribeWorkspaceImages](https://docs.aws.amazon.com/powershell/v4/reference)」を参照してください。

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

次のコード例は、`Get-WKSWorkspaceSnapshot` を使用する方法を示しています。

**Tools for PowerShell V4**  
**例 1: この例では、指定ワークスペース用に作成された最新のスナップショットのタイムスタンプを示します。**  

```
Get-WKSWorkspaceSnapshot -WorkspaceId ws-w361s100v
```
**出力:**  

```
RebuildSnapshots                   RestoreSnapshots
----------------                   ----------------
{Amazon.WorkSpaces.Model.Snapshot} {Amazon.WorkSpaces.Model.Snapshot}
```
+  API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V4)* の「[DescribeWorkspaceSnapshots](https://docs.aws.amazon.com/powershell/v4/reference)」を参照してください。

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

次のコード例は、`Get-WKSWorkspacesConnectionStatus` を使用する方法を示しています。

**Tools for PowerShell V4**  
**例 1: このサンプルは、指定された Workspace の接続ステータスを取得します。**  

```
Get-WKSWorkspacesConnectionStatus -WorkspaceId ws-w123s234r
```
+  API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V4)* の「[DescribeWorkspacesConnectionStatus](https://docs.aws.amazon.com/powershell/v4/reference)」を参照してください。

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

次のコード例は、`New-WKSIpGroup` を使用する方法を示しています。

**Tools for PowerShell V4**  
**例 1: この例では、FreshEmptyIpGroup という名前の空の IP グループを作成します**  

```
New-WKSIpGroup -GroupName "FreshNewIPGroup"
```
**出力:**  

```
wsipg-w45rty4ty
```
+  API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V4)* の「[CreateIpGroup](https://docs.aws.amazon.com/powershell/v4/reference)」を参照してください。

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

次のコード例は、`New-WKSTag` を使用する方法を示しています。

**Tools for PowerShell V4**  
**例 1: この例では、`ws-wsname` という名前のワークスペースに新しいタグを追加します。タグのキーは「Name」で、キー値は `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
```
**例 2: この例では、`ws-wsname` という名前のワークスペースに複数のタグを追加します。1 つのタグには「Name」のキーと `AWS_Workspace` のキー値があり、もう 1 つのタグには「Stage」のタグキーと「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 の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V4)* の「[CreateTags](https://docs.aws.amazon.com/powershell/v4/reference)」を参照してください。

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

次のコード例は、`New-WKSWorkspace` を使用する方法を示しています。

**Tools for PowerShell V4**  
**例 1: 指定されたバンドル、ディレクトリ、ユーザーの WorkSpace を作成します。**  

```
New-WKSWorkspace -Workspace @{"BundleID" = "wsb-1a2b3c4d"; "DirectoryId" = "d-1a2b3c4d"; "UserName" = "USERNAME"}
```
**例 2: この例では、複数の WorkSpaces を作成します。**  

```
New-WKSWorkspace -Workspace @{"BundleID" = "wsb-1a2b3c4d"; "DirectoryId" = "d-1a2b3c4d"; "UserName" = "USERNAME_1"},@{"BundleID" = "wsb-1a2b3c4d"; "DirectoryId" = "d-1a2b3c4d"; "UserName" = "USERNAME_2"}
```
+  API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V4)* の「[CreateWorkspaces](https://docs.aws.amazon.com/powershell/v4/reference)」を参照してください。

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

次のコード例は、`Register-WKSIpGroup` を使用する方法を示しています。

**Tools for PowerShell V4**  
**例 1: このサンプルは、指定 IP グループを指定ディレクトリに登録します。**  

```
Register-WKSIpGroup -GroupId wsipg-23ahsdres -DirectoryId d-123412e123
```
+  API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V4)* の「[AssociateIpGroups](https://docs.aws.amazon.com/powershell/v4/reference)」を参照してください。

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

次のコード例は、`Register-WKSWorkspaceDirectory` を使用する方法を示しています。

**Tools for PowerShell V4**  
**例 1: このサンプルは、Workspaces Service の指定されたディレクトリを登録します。**  

```
Register-WKSWorkspaceDirectory -DirectoryId d-123412a123 -EnableWorkDoc $false
```
+  API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V4)* の「[RegisterWorkspaceDirectory](https://docs.aws.amazon.com/powershell/v4/reference)」を参照してください。

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

次のコード例は、`Remove-WKSIpGroup` を使用する方法を示しています。

**Tools for PowerShell V4**  
**例 1: この例では、指定 IP グループを削除します。**  

```
Remove-WKSIpGroup -GroupId wsipg-32fhgtred
```
**出力:**  

```
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 の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V4)* の「[DeleteIpGroup](https://docs.aws.amazon.com/powershell/v4/reference)」を参照してください。

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

次のコード例は、`Remove-WKSTag` を使用する方法を示しています。

**Tools for PowerShell V4**  
**例 1: このサンプルは、Workspace に関連付けられたタグを削除します。**  

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

```
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 の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V4)* の「[DeleteTags](https://docs.aws.amazon.com/powershell/v4/reference)」を参照してください。

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

次のコード例は、`Remove-WKSWorkspace` を使用する方法を示しています。

**Tools for PowerShell V4**  
**例 1: 複数の WorkSpaces を終了します。-Force スイッチを使用すると、コマンドレットの確認を求めるプロンプトが表示されなくなります。**  

```
Remove-WKSWorkspace -WorkspaceId "ws-1a2b3c4d5","ws-6a7b8c9d0" -Force
```
**例 2: すべての WorkSpaces のコレクションを取得し、Remove-WKSWorkspace の -WorkSpaceId パラメータに ID をパイプして、すべての WorkSpaces を終了します。コマンドレットは、各 WorkSpace が終了する前にプロンプトを表示します。確認を非表示にするには、-Force スイッチを追加します。**  

```
Get-WKSWorkspaces | Remove-WKSWorkspace
```
**例 3: この例では、終了する WorkSpaces を定義する TerminateRequest オブジェクトを渡す方法を示します。-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
```
+  API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V4)* の「[TerminateWorkspaces](https://docs.aws.amazon.com/powershell/v4/reference)」を参照してください。

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

次のコード例は、`Reset-WKSWorkspace` を使用する方法を示しています。

**Tools for PowerShell V4**  
**例 1: 指定された WorkSpace を再構築します。**  

```
Reset-WKSWorkspace -WorkspaceId "ws-1a2b3c4d"
```
**例 2: すべての WorkSpaces のコレクションを取得し、Reset-WKSWorkspace の -WorkSpaceId パラメータに ID をパイプして、WorkSpaces を再構築します。**  

```
Get-WKSWorkspaces | Reset-WKSWorkspace
```
+  API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V4)* の「[RebuildWorkspaces](https://docs.aws.amazon.com/powershell/v4/reference)」を参照してください。

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

次のコード例は、`Restart-WKSWorkspace` を使用する方法を示しています。

**Tools for PowerShell V4**  
**例 1: 指定された WorkSpace を再起動します。**  

```
Restart-WKSWorkspace -WorkspaceId "ws-1a2b3c4d"
```
**例 2: 複数の WorkSpaces を再起動します。**  

```
Restart-WKSWorkspace -WorkspaceId "ws-1a2b3c4d","ws-5a6b7c8d"
```
**例 3: すべての WorkSpaces のコレクションを取得し、Restart-WKSWorkspace の -WorkSpaceId パラメータに ID をパイプして、WorkSpaces を再起動します。**  

```
Get-WKSWorkspaces | Restart-WKSWorkspace
```
+  API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V4)* の「[RebootWorkspaces](https://docs.aws.amazon.com/powershell/v4/reference)」を参照してください。

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

次のコード例は、`Stop-WKSWorkspace` を使用する方法を示しています。

**Tools for PowerShell V4**  
**例 1: 複数の WorkSpaces を停止します。**  

```
Stop-WKSWorkspace -WorkspaceId "ws-1a2b3c4d5","ws-6a7b8c9d0"
```
**例 2: すべての WorkSpaces のコレクションを取得し、Stop-WKSWorkspace の -WorkSpaceId パラメータに ID をパイプして、WorkSpaces を停止します。**  

```
Get-WKSWorkspaces | Stop-WKSWorkspace
```
**例 3: この例では、停止する WorkSpaces を定義する StopRequest オブジェクトを渡す方法を示します。**  

```
$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 の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V4)* の「[StopWorkspaces](https://docs.aws.amazon.com/powershell/v4/reference)」を参照してください。

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

次のコード例は、`Unregister-WKSIpGroup` を使用する方法を示しています。

**Tools for PowerShell V4**  
**例 1: このサンプルは、指定ディレクトリから指定 IP グループを登録解除します。**  

```
Unregister-WKSIpGroup -GroupId wsipg-12abcdphq -DirectoryId d-123454b123
```
+  API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V4)* の「[DisassociateIpGroups](https://docs.aws.amazon.com/powershell/v4/reference)」を参照してください。