버전 5(V5) AWS Tools for PowerShell 가 릴리스되었습니다.
변경 사항 해제 및 애플리케이션 마이그레이션에 대한 자세한 내용은 [마이그레이션 주제를](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html) 참조하세요.
[https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html)
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Tools for PowerShell V5를 사용한 WorkSpaces 예제
다음 코드 예제에서는 WorkSpaces와 함께 AWS Tools for PowerShell V5를 사용하여 작업을 수행하고 일반적인 시나리오를 구현하는 방법을 보여줍니다.
*작업*은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 개별 서비스 함수를 직접적으로 호출하는 방법을 보여주며 관련 시나리오의 컨텍스트에 맞는 작업을 볼 수 있습니다.
각 예시에는 전체 소스 코드에 대한 링크가 포함되어 있으며, 여기에서 컨텍스트에 맞춰 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있습니다.
**Topics**
+ [작업](#actions)
## 작업
### `Approve-WKSIpRule`
다음 코드 예시는 `Approve-WKSIpRule`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 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 Cmdlet 참조(V5)*의 [AuthorizeIpRules](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `Copy-WKSWorkspaceImage`
다음 코드 예시는 `Copy-WKSWorkspaceImage`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플에서는 지정된 ID를 가진 워크스페이스 이미지를 us-west-2에서 이름이 'CopiedImageTest'인 현재 리전으로 복사합니다.**
```
Copy-WKSWorkspaceImage -Name CopiedImageTest -SourceRegion us-west-2 -SourceImageId wsi-djfoedhw6
```
**출력:**
```
wsi-456abaqfe
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [CopyWorkspaceImage](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `Edit-WKSClientProperty`
다음 코드 예시는 `Edit-WKSClientProperty`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플에서는 Workspaces Client에 대한 재연결을 활성화합니다.**
```
Edit-WKSClientProperty -Region us-west-2 -ClientProperties_ReconnectEnabled "ENABLED" -ResourceId d-123414a369
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [ModifyClientProperties](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `Edit-WKSSelfServicePermission`
다음 코드 예시는 `Edit-WKSSelfServicePermission`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플에서는 지정된 디렉터리의 컴퓨팅 유형을 변경하고 볼륨 크기를 늘릴 수 있는 셀프 서비스 권한을 활성화합니다.**
```
Edit-WKSSelfservicePermission -Region us-west-2 -ResourceId d-123454a369 -SelfservicePermissions_ChangeComputeType ENABLED -SelfservicePermissions_IncreaseVolumeSize ENABLED
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [ModifySelfservicePermissions](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `Edit-WKSWorkspaceAccessProperty`
다음 코드 예시는 `Edit-WKSWorkspaceAccessProperty`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 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 Cmdlet 참조(V5)*의 [ModifyWorkspaceAccessProperties](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `Edit-WKSWorkspaceCreationProperty`
다음 코드 예시는 `Edit-WKSWorkspaceCreationProperty`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플에서는 Workspace를 생성하는 동안 인터넷 액세스 및 유지 관리 모드의 기본값을 true로 설정합니다.**
```
Edit-WKSWorkspaceCreationProperty -Region us-west-2 -ResourceId d-123454a369 -WorkspaceCreationProperties_EnableInternetAccess $true -WorkspaceCreationProperties_EnableMaintenanceMode $true
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [ModifyWorkspaceCreationProperties](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `Edit-WKSWorkspaceProperty`
다음 코드 예시는 `Edit-WKSWorkspaceProperty`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플에서는 지정된 Workspace에 대해 Workspace 실행 모드 속성을 자동 중지로 변경합니다**
```
Edit-WKSWorkspaceProperty -WorkspaceId ws-w361s100v -Region us-west-2 -WorkspaceProperties_RunningMode AUTO_STOP
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [ModifyWorkspaceProperties](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `Edit-WKSWorkspaceState`
다음 코드 예시는 `Edit-WKSWorkspaceState`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플에서는 지정된 Workspace의 상태를 사용 가능 상태로 변경합니다.**
```
Edit-WKSWorkspaceState -WorkspaceId ws-w361s100v -Region us-west-2 -WorkspaceState AVAILABLE
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [ModifyWorkspaceState](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `Get-WKSClientProperty`
다음 코드 예시는 `Get-WKSClientProperty`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플에서는 지정된 디렉터리에 대한 Workspace Client의 클라이언트 속성을 가져옵니다.**
```
Get-WKSClientProperty -ResourceId d-223562a123
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [DescribeClientProperties](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `Get-WKSIpGroup`
다음 코드 예시는 `Get-WKSIpGroup`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 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 Cmdlet 참조(V5)*의 [DescribeIpGroups](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `Get-WKSTag`
다음 코드 예시는 `Get-WKSTag`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플에서는 지정된 Workspace에 대한 태그를 가져옵니다.**
```
Get-WKSTag -WorkspaceId ws-w361s234r -Region us-west-2
```
**출력:**
```
Key Value
--- -----
auto-delete no
purpose Workbench
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [DescribeTags](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `Get-WKSWorkspace`
다음 코드 예시는 `Get-WKSWorkspace`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 파이프라인에 대한 모든 WorkSpace의 세부 정보를 검색합니다.**
```
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 Cmdlet 참조(V5)*의 [DescribeWorkspaces](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `Get-WKSWorkspaceBundle`
다음 코드 예시는 `Get-WKSWorkspaceBundle`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 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 Cmdlet 참조(V5)*의 [DescribeWorkspaceBundles](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `Get-WKSWorkspaceDirectory`
다음 코드 예시는 `Get-WKSWorkspaceDirectory`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 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 Cmdlet 참조(V5)*의 [DescribeWorkspaceDirectories](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `Get-WKSWorkspaceImage`
다음 코드 예시는 `Get-WKSWorkspaceImage`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 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 Cmdlet 참조(V5)*의 [DescribeWorkspaceImages](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `Get-WKSWorkspaceSnapshot`
다음 코드 예시는 `Get-WKSWorkspaceSnapshot`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플에서는 지정된 Workspace에 대해 생성된 가장 최근 스냅샷의 타임스탬프를 보여줍니다.**
```
Get-WKSWorkspaceSnapshot -WorkspaceId ws-w361s100v
```
**출력:**
```
RebuildSnapshots RestoreSnapshots
---------------- ----------------
{Amazon.WorkSpaces.Model.Snapshot} {Amazon.WorkSpaces.Model.Snapshot}
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [DescribeWorkspaceSnapshots](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `Get-WKSWorkspacesConnectionStatus`
다음 코드 예시는 `Get-WKSWorkspacesConnectionStatus`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플에서는 지정된 Workspace의 연결 상태를 가져옵니다.**
```
Get-WKSWorkspacesConnectionStatus -WorkspaceId ws-w123s234r
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [DescribeWorkspacesConnectionStatus](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `New-WKSIpGroup`
다음 코드 예시는 `New-WKSIpGroup`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플에서는 FreshEmptyIpGroup이라는 빈 IP 그룹을 생성합니다.**
```
New-WKSIpGroup -GroupName "FreshNewIPGroup"
```
**출력:**
```
wsipg-w45rty4ty
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [CreateIpGroup](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `New-WKSTag`
다음 코드 예시는 `New-WKSTag`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 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`이라는 워크스페이스에 여러 태그를 추가합니다. 한 태그는 키가 'Name'이고 키 값이 `AWS_Workspace`이며, 다른 하나의 태그는 키가 '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 Cmdlet 참조(V5)*의 [CreateTags](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `New-WKSWorkspace`
다음 코드 예시는 `New-WKSWorkspace`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 제공된 번들, 디렉터리, 사용자에 대한 WorkSpace를 생성합니다.**
```
New-WKSWorkspace -Workspace @{"BundleID" = "wsb-1a2b3c4d"; "DirectoryId" = "d-1a2b3c4d"; "UserName" = "USERNAME"}
```
**예제 2: 이 예제에서는 여러 WorkSpace를 생성합니다.**
```
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 Cmdlet 참조(V5)*의 [CreateWorkspaces](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `Register-WKSIpGroup`
다음 코드 예시는 `Register-WKSIpGroup`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플에서는 지정된 IP 그룹을 지정된 디렉터리에 등록합니다.**
```
Register-WKSIpGroup -GroupId wsipg-23ahsdres -DirectoryId d-123412e123
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [AssociateIpGroups](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `Register-WKSWorkspaceDirectory`
다음 코드 예시는 `Register-WKSWorkspaceDirectory`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플에서는 Workspaces Service에 지정된 디렉터리를 등록합니다.**
```
Register-WKSWorkspaceDirectory -DirectoryId d-123412a123 -EnableWorkDoc $false
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [RegisterWorkspaceDirectory](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `Remove-WKSIpGroup`
다음 코드 예시는 `Remove-WKSIpGroup`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 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 Cmdlet 참조(V5)*의 [DeleteIpGroup](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `Remove-WKSTag`
다음 코드 예시는 `Remove-WKSTag`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 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 Cmdlet 참조(V5)*의 [DeleteTags](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `Remove-WKSWorkspace`
다음 코드 예시는 `Remove-WKSWorkspace`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 여러 WorkSpace를 종료합니다. -Force 스위치를 사용하면 cmdlet이 확인 프롬프트를 표시하지 않습니다.**
```
Remove-WKSWorkspace -WorkspaceId "ws-1a2b3c4d5","ws-6a7b8c9d0" -Force
```
**예제 2: 모든 WorkSpace 컬렉션을 검색하고 Remove-WKSWorkspace의 -WorkSpaceId 파라미터에 ID를 파이프하여 모든 WorkSpace를 종료합니다. 각 WorkSpace가 종료되기 전에 cmdlet이 프롬프트를 표시합니다. 확인 프롬프트를 차단하려면 -Force 스위치를 추가합니다.**
```
Get-WKSWorkspaces | Remove-WKSWorkspace
```
**예제 3: 이 예제에서는 종료할 WorkSpace를 정의하는 TerminateRequest 객체를 전달하는 방법을 보여줍니다. -Force 스위치 파라미터를 지정하지 않으면 cmdlet이 명령을 진행하기 전에 확인을 요청하는 프롬프트를 표시합니다.**
```
$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 Cmdlet 참조(V5)*의 [TerminateWorkspaces](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `Reset-WKSWorkspace`
다음 코드 예시는 `Reset-WKSWorkspace`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 지정된 WorkSpace를 재구축합니다.**
```
Reset-WKSWorkspace -WorkspaceId "ws-1a2b3c4d"
```
**예제 2: 모든 WorkSpace 컬렉션을 검색하고 Reset-WKSWorkspace의 -WorkSpaceId 파라미터에 ID를 파이프하여 WorkSpace를 재구축합니다.**
```
Get-WKSWorkspaces | Reset-WKSWorkspace
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [RebuildWorkspaces](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `Restart-WKSWorkspace`
다음 코드 예시는 `Restart-WKSWorkspace`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 지정된 WorkSpace를 재부팅합니다.**
```
Restart-WKSWorkspace -WorkspaceId "ws-1a2b3c4d"
```
**예제 2: 여러 WorkSpace를 재부팅합니다.**
```
Restart-WKSWorkspace -WorkspaceId "ws-1a2b3c4d","ws-5a6b7c8d"
```
**예제 3: 모든 WorkSpace 컬렉션을 검색하고 Restart-WKSWorkspace의 -WorkSpaceId 파라미터에 ID를 파이프하여 WorkSpace를 재시작합니다.**
```
Get-WKSWorkspaces | Restart-WKSWorkspace
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [RebootWorkspaces](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `Stop-WKSWorkspace`
다음 코드 예시는 `Stop-WKSWorkspace`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 여러 WorkSpace를 중지합니다.**
```
Stop-WKSWorkspace -WorkspaceId "ws-1a2b3c4d5","ws-6a7b8c9d0"
```
**예제 2: 모든 WorkSpace 컬렉션을 검색하고 Stop-WKSWorkspace의 -WorkSpaceId 파라미터에 ID를 파이프하여 WorkSpace를 중지합니다.**
```
Get-WKSWorkspaces | Stop-WKSWorkspace
```
**예제 3: 이 예제에서는 중지할 WorkSpace를 정의하는 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 Cmdlet 참조(V5)*의 [StopWorkspaces](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `Unregister-WKSIpGroup`
다음 코드 예시는 `Unregister-WKSIpGroup`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플에서는 지정된 디렉터리에서 지정된 IP 그룹의 등록을 취소합니다.**
```
Unregister-WKSIpGroup -GroupId wsipg-12abcdphq -DirectoryId d-123454b123
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [DisassociateIpGroups](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.