버전 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)
## 작업
### `Add-APSResourceTag`
다음 코드 예시는 `Add-APSResourceTag`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 AppStream 리소스에 리소스 태그를 추가합니다.**
```
Add-APSResourceTag -ResourceArn arn:aws:appstream:us-east-1:123456789012:stack/SessionScriptTest -Tag @{StackState='Test'} -Select ^Tag
```
**출력:**
```
Name Value
---- -----
StackState Test
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [TagResource](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `Copy-APSImage`
다음 코드 예시는 `Copy-APSImage`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 이미지를 다른 리전에 복사합니다.**
```
Copy-APSImage -DestinationImageName TestImageCopy -DestinationRegion us-west-2 -SourceImageName Powershell
```
**출력:**
```
TestImageCopy
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [CopyImage](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `Disable-APSUSer`
다음 코드 예시는 `Disable-APSUSer`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 USERPOOL에서 사용자를 비활성화합니다.**
```
Disable-APSUser -AuthenticationType USERPOOL -UserName TestUser@lab.com
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [DisableUser](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `Enable-APSUser`
다음 코드 예시는 `Enable-APSUser`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 USERPOOL에서 비활성화된 사용자를 활성화합니다.**
```
Enable-APSUser -AuthenticationType USERPOOL -UserName TestUser@lab.com
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [EnableUser](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `Get-APSAssociatedFleetList`
다음 코드 예시는 `Get-APSAssociatedFleetList`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 스택과 연결된 플릿을 표시합니다.**
```
Get-APSAssociatedFleetList -StackName PowershellStack
```
**출력:**
```
PowershellFleet
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [ListAssociatedFleets](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `Get-APSAssociatedStackList`
다음 코드 예시는 `Get-APSAssociatedStackList`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 플릿과 연결된 스택을 표시합니다.**
```
Get-APSAssociatedStackList -FleetName PowershellFleet
```
**출력:**
```
PowershellStack
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [ListAssociatedStacks](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `Get-APSDirectoryConfigList`
다음 코드 예시는 `Get-APSDirectoryConfigList`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 AppStream에서 생성된 디렉터리 구성을 표시합니다.**
```
Get-APSDirectoryConfigList | Select DirectoryName, OrganizationalUnitDistinguishedNames, CreatedTime
```
**출력:**
```
DirectoryName OrganizationalUnitDistinguishedNames CreatedTime
------------- ------------------------------------ -----------
Test.com {OU=AppStream,DC=Test,DC=com} 9/6/2019 10:56:40 AM
contoso.com {OU=AppStream,OU=contoso,DC=contoso,DC=com} 8/9/2019 9:08:50 AM
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [DescribeDirectoryConfigs](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `Get-APSFleetList`
다음 코드 예시는 `Get-APSFleetList`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 플릿의 세부 정보를 표시합니다.**
```
Get-APSFleetList -Name Test
```
**출력:**
```
Arn : arn:aws:appstream:us-east-1:1234567890:fleet/Test
ComputeCapacityStatus : Amazon.AppStream.Model.ComputeCapacityStatus
CreatedTime : 9/12/2019 5:00:45 PM
Description : Test
DisconnectTimeoutInSeconds : 900
DisplayName : Test
DomainJoinInfo :
EnableDefaultInternetAccess : False
FleetErrors : {}
FleetType : ON_DEMAND
IamRoleArn :
IdleDisconnectTimeoutInSeconds : 900
ImageArn : arn:aws:appstream:us-east-1:1234567890:image/Test
ImageName : Test
InstanceType : stream.standard.medium
MaxUserDurationInSeconds : 57600
Name : Test
State : STOPPED
VpcConfig : Amazon.AppStream.Model.VpcConfig
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [DescribeFleets](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `Get-APSImageBuilderList`
다음 코드 예시는 `Get-APSImageBuilderList`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 ImageBuilder의 세부 정보를 표시합니다.**
```
Get-APSImageBuilderList -Name TestImage
```
**출력:**
```
AccessEndpoints : {}
AppstreamAgentVersion : 06-19-2019
Arn : arn:aws:appstream:us-east-1:1234567890:image-builder/TestImage
CreatedTime : 1/14/2019 4:33:05 AM
Description :
DisplayName : TestImage
DomainJoinInfo :
EnableDefaultInternetAccess : False
IamRoleArn :
ImageArn : arn:aws:appstream:us-east-1::image/Base-Image-Builder-05-02-2018
ImageBuilderErrors : {}
InstanceType : stream.standard.large
Name : TestImage
NetworkAccessConfiguration : Amazon.AppStream.Model.NetworkAccessConfiguration
Platform : WINDOWS
State : STOPPED
StateChangeReason :
VpcConfig : Amazon.AppStream.Model.VpcConfig
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [DescribeImageBuilders](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `Get-APSImageList`
다음 코드 예시는 `Get-APSImageList`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 프라이빗 AppStream 이미지를 표시합니다.**
```
Get-APSImageList -Type PRIVATE | select DisplayName, ImageBuilderName, Visibility, arn
```
**출력:**
```
DisplayName ImageBuilderName Visibility Arn
----------- ---------------- ---------- ---
OfficeApps OfficeApps PRIVATE arn:aws:appstream:us-east-1:123456789012:image/OfficeApps
SessionScriptV2 SessionScriptTest PRIVATE arn:aws:appstream:us-east-1:123456789012:image/SessionScriptV2
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [DescribeImages](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `Get-APSImagePermission`
다음 코드 예시는 `Get-APSImagePermission`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 공유 AppStream 이미지에 대한 이미지 권한을 표시합니다.**
```
Get-APSImagePermission -Name Powershell | select SharedAccountId, @{n="AllowFleet";e={$_.ImagePermissions.AllowFleet}}, @{n="AllowImageBuilder";e={$_.ImagePermissions.AllowImageBuilder}}
```
**출력:**
```
SharedAccountId AllowFleet AllowImageBuilder
--------------- ---------- -----------------
123456789012 True True
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [DescribeImagePermissions](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `Get-APSSessionList`
다음 코드 예시는 `Get-APSSessionList`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 플릿에 대한 세션 목록을 표시합니다.**
```
Get-APSSessionList -FleetName PowershellFleet -StackName PowershellStack
```
**출력:**
```
AuthenticationType : API
ConnectionState : CONNECTED
FleetName : PowershellFleet
Id : d8987c70-4394-4324-a396-2d485c26f2a2
MaxExpirationTime : 12/27/2019 4:54:07 AM
NetworkAccessConfiguration : Amazon.AppStream.Model.NetworkAccessConfiguration
StackName : PowershellStack
StartTime : 12/26/2019 12:54:12 PM
State : ACTIVE
UserId : Test
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [DescribeSessions](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `Get-APSStackList`
다음 코드 예시는 `Get-APSStackList`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플에는 AppStream Stack 목록이 표시됩니다.**
```
Get-APSStackList | Select DisplayName, Arn, CreatedTime
```
**출력:**
```
DisplayName Arn CreatedTime
----------- --- -----------
PowershellStack arn:aws:appstream:us-east-1:123456789012:stack/PowershellStack 4/24/2019 8:49:29 AM
SessionScriptTest arn:aws:appstream:us-east-1:123456789012:stack/SessionScriptTest 9/12/2019 3:23:12 PM
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [DescribeStacks](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `Get-APSTagsForResourceList`
다음 코드 예시는 `Get-APSTagsForResourceList`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 AppStream 리소스의 태그를 표시합니다.**
```
Get-APSTagsForResourceList -ResourceArn arn:aws:appstream:us-east-1:123456789012:stack/SessionScriptTest
```
**출력:**
```
Key Value
--- -----
StackState Test
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [ListTagsForResource](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `Get-APSUsageReportSubscription`
다음 코드 예시는 `Get-APSUsageReportSubscription`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 AppStreamUsageReport 구성 세부 정보를 표시합니다.**
```
Get-APSUsageReportSubscription
```
**출력:**
```
LastGeneratedReportDate S3BucketName Schedule SubscriptionErrors
----------------------- ------------ -------- ------------------
1/1/0001 12:00:00 AM appstream-logs-us-east-1-123456789012-sik1hnxe DAILY {}
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [DescribeUsageReportSubscriptions](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `Get-APSUser`
다음 코드 예시는 `Get-APSUser`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 활성화된 상태의 사용자 목록을 표시합니다.**
```
Get-APSUser -AuthenticationType USERPOOL | Select-Object UserName, AuthenticationType, Enabled
```
**출력:**
```
UserName AuthenticationType Enabled
-------- ------------------ -------
foo1@contoso.com USERPOOL True
foo2@contoso.com USERPOOL True
foo3@contoso.com USERPOOL True
foo4@contoso.com USERPOOL True
foo5@contoso.com USERPOOL True
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [DescribeUsers](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `Get-APSUserStackAssociation`
다음 코드 예시는 `Get-APSUserStackAssociation`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 스택에 할당된 사용자 목록을 표시합니다.**
```
Get-APSUserStackAssociation -StackName PowershellStack
```
**출력:**
```
AuthenticationType SendEmailNotification StackName UserName
------------------ --------------------- --------- --------
USERPOOL False PowershellStack TestUser1@lab.com
USERPOOL False PowershellStack TestUser2@lab.com
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [DescribeUserStackAssociations](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `New-APSDirectoryConfig`
다음 코드 예시는 `New-APSDirectoryConfig`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 AppStream에 디렉터리 구성을 생성합니다.**
```
New-APSDirectoryConfig -ServiceAccountCredentials_AccountName contoso\ServiceAccount -ServiceAccountCredentials_AccountPassword MyPass -DirectoryName contoso.com -OrganizationalUnitDistinguishedName "OU=AppStream,OU=Contoso,DC=Contoso,DC=com"
```
**출력:**
```
CreatedTime DirectoryName OrganizationalUnitDistinguishedNames ServiceAccountCredentials
----------- ------------- ------------------------------------ -------------------------
12/27/2019 11:00:30 AM contoso.com {OU=AppStream,OU=Contoso,DC=Contoso,DC=com} Amazon.AppStream.Model.ServiceAccountCredentials
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [CreateDirectoryConfig](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `New-APSFleet`
다음 코드 예시는 `New-APSFleet`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 새로운 AppStream 플릿을 생성합니다.**
```
New-APSFleet -ComputeCapacity_DesiredInstance 1 -InstanceType stream.standard.medium -Name TestFleet -DisplayName TestFleet -FleetType ON_DEMAND -EnableDefaultInternetAccess $True -VpcConfig_SubnetIds "subnet-123ce32","subnet-a1234cfd" -VpcConfig_SecurityGroupIds sg-4d012a34 -ImageName SessionScriptTest -Region us-west-2
```
**출력:**
```
Arn : arn:aws:appstream:us-west-2:123456789012:fleet/TestFleet
ComputeCapacityStatus : Amazon.AppStream.Model.ComputeCapacityStatus
CreatedTime : 12/27/2019 11:24:42 AM
Description :
DisconnectTimeoutInSeconds : 900
DisplayName : TestFleet
DomainJoinInfo :
EnableDefaultInternetAccess : True
FleetErrors : {}
FleetType : ON_DEMAND
IamRoleArn :
IdleDisconnectTimeoutInSeconds : 0
ImageArn : arn:aws:appstream:us-west-2:123456789012:image/SessionScriptTest
ImageName : SessionScriptTest
InstanceType : stream.standard.medium
MaxUserDurationInSeconds : 57600
Name : TestFleet
State : STOPPED
VpcConfig : Amazon.AppStream.Model.VpcConfig
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [CreateFleet](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `New-APSImageBuilder`
다음 코드 예시는 `New-APSImageBuilder`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 AppStream에 Image Builder를 생성합니다.**
```
New-APSImageBuilder -InstanceType stream.standard.medium -Name TestIB -DisplayName TestIB -ImageName AppStream-WinServer2012R2-12-12-2019 -EnableDefaultInternetAccess $True -VpcConfig_SubnetId subnet-a1234cfd -VpcConfig_SecurityGroupIds sg-2d012a34 -Region us-west-2
```
**출력:**
```
AccessEndpoints : {}
AppstreamAgentVersion : 12-16-2019
Arn : arn:aws:appstream:us-west-2:123456789012:image-builder/TestIB
CreatedTime : 12/27/2019 11:39:24 AM
Description :
DisplayName : TestIB
DomainJoinInfo :
EnableDefaultInternetAccess : True
IamRoleArn :
ImageArn : arn:aws:appstream:us-west-2::image/AppStream-WinServer2012R2-12-12-2019
ImageBuilderErrors : {}
InstanceType : stream.standard.medium
Name : TestIB
NetworkAccessConfiguration :
Platform : WINDOWS
State : PENDING
StateChangeReason :
VpcConfig : Amazon.AppStream.Model.VpcConfig
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [CreateImageBuilder](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `New-APSImageBuilderStreamingURL`
다음 코드 예시는 `New-APSImageBuilderStreamingURL`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 유효 기간이 2시간인 ImageBuilder 스트리밍 URL을 생성합니다.**
```
New-APSImageBuilderStreamingURL -Name TestIB -Validity 7200 -Region us-west-2
```
**출력:**
```
Expires StreamingURL
------- ------------
12/27/2019 1:49:13 PM https://appstream2.us-west-2.aws.amazon.com/authenticate?parameters=eyJ0eXBlIjoiQURNSU4iLCJleHBpcmVzIjoiMTU3NzQ1NDU1MyIsImF3c0FjY291bnRJZCI6IjM5MzQwMzgxMTQwNyIsInVzZXJJZCI6ImFkbWluIiwiY2F
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [CreateImageBuilderStreamingURL](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `New-APSStack`
다음 코드 예시는 `New-APSStack`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 새로운 AppStream 스택을 생성합니다.**
```
New-APSStack -Name TestStack -DisplayName TestStack -ApplicationSettings_Enabled $True -ApplicationSettings_SettingsGroup TestStack -Region us-west-2
```
**출력:**
```
AccessEndpoints : {}
ApplicationSettings : Amazon.AppStream.Model.ApplicationSettingsResponse
Arn : arn:aws:appstream:us-west-2:123456789012:stack/TestStack
CreatedTime : 12/27/2019 12:34:19 PM
Description :
DisplayName : TestStack
EmbedHostDomains : {}
FeedbackURL :
Name : TestStack
RedirectURL :
StackErrors : {}
StorageConnectors : {}
UserSettings : {Amazon.AppStream.Model.UserSetting, Amazon.AppStream.Model.UserSetting, Amazon.AppStream.Model.UserSetting, Amazon.AppStream.Model.UserSetting}
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [CreateStack](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `New-APSStreamingURL`
다음 코드 예시는 `New-APSStreamingURL`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 Stack의 스트리밍 URL을 생성합니다.**
```
New-APSStreamingURL -StackName SessionScriptTest -FleetName SessionScriptNew -UserId TestUser
```
**출력:**
```
Expires StreamingURL
------- ------------
12/27/2019 12:43:37 PM https://appstream2.us-east-1.aws.amazon.com/authenticate?parameters=eyJ0eXBlIjoiRU5EX1VTRVIiLCJleHBpcmVzIjoiMTU3NzQ1MDYxNyIsImF3c0FjY291bnRJZCI6IjM5MzQwMzgxMTQwNyIsInVzZXJJZCI6IlRlc3RVc2
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [CreateStreamingURL](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `New-APSUsageReportSubscription`
다음 코드 예시는 `New-APSUsageReportSubscription`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 AppStream 사용 보고서를 활성화합니다.**
```
New-APSUsageReportSubscription
```
**출력:**
```
S3BucketName Schedule
------------ --------
appstream-logs-us-east-1-123456789012-sik2hnxe DAILY
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [CreateUsageReportSubscription](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `New-APSUser`
다음 코드 예시는 `New-APSUser`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 USERPOOL에 사용자를 생성합니다.**
```
New-APSUser -UserName Test@lab.com -AuthenticationType USERPOOL -FirstName 'kt' -LastName 'aws' -Select ^UserName
```
**출력:**
```
Test@lab.com
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [CreateUser](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `Register-APSFleet`
다음 코드 예시는 `Register-APSFleet`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 스택에 플릿을 등록합니다.**
```
Register-APSFleet -StackName TestStack -FleetName TestFleet -Region us-west-2
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [AssociateFleet](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `Register-APSUserStackBatch`
다음 코드 예시는 `Register-APSUserStackBatch`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 USERPOOL의 사용자에게 스택을 할당합니다.**
```
Register-APSUserStackBatch -UserStackAssociation @{AuthenticationType="USERPOOL";SendEmailNotification=$False;StackName="PowershellStack";UserName="TestUser1@lab.com"}
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [BatchAssociateUserStack](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `Remove-APSDirectoryConfig`
다음 코드 예시는 `Remove-APSDirectoryConfig`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 AppStream Directory 구성을 제거합니다.**
```
Remove-APSDirectoryConfig -DirectoryName contoso.com
```
**출력:**
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-APSDirectoryConfig (DeleteDirectoryConfig)" on target "contoso.com".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): A
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [DeleteDirectoryConfig](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `Remove-APSFleet`
다음 코드 예시는 `Remove-APSFleet`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 AppStream 플릿을 삭제합니다.**
```
Remove-APSFleet -Name TestFleet -Region us-west-2
```
**출력:**
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-APSFleet (DeleteFleet)" on target "TestFleet".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): A
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [DeleteFleet](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `Remove-APSImage`
다음 코드 예시는 `Remove-APSImage`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 이미지를 삭제합니다.**
```
Remove-APSImage -Name TestImage -Region us-west-2
```
**출력:**
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-APSImage (DeleteImage)" on target "TestImage".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): A
Applications : {}
AppstreamAgentVersion : LATEST
Arn : arn:aws:appstream:us-west-2:123456789012:image/TestImage
BaseImageArn :
CreatedTime : 12/27/2019 1:34:10 PM
Description :
DisplayName : TestImage
ImageBuilderName :
ImageBuilderSupported : True
ImagePermissions :
Name : TestImage
Platform : WINDOWS
PublicBaseImageReleasedDate : 6/12/2018 12:00:00 AM
State : AVAILABLE
StateChangeReason :
Visibility : PRIVATE
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [DeleteImage](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `Remove-APSImageBuilder`
다음 코드 예시는 `Remove-APSImageBuilder`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 ImageBuilder를 삭제합니다.**
```
Remove-APSImageBuilder -Name TestIB -Region us-west-2
```
**출력:**
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-APSImageBuilder (DeleteImageBuilder)" on target "TestIB".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): A
AccessEndpoints : {}
AppstreamAgentVersion : 12-16-2019
Arn : arn:aws:appstream:us-west-2:123456789012:image-builder/TestIB
CreatedTime : 12/27/2019 11:39:24 AM
Description :
DisplayName : TestIB
DomainJoinInfo :
EnableDefaultInternetAccess : True
IamRoleArn :
ImageArn : arn:aws:appstream:us-west-2::image/AppStream-WinServer2012R2-12-12-2019
ImageBuilderErrors : {}
InstanceType : stream.standard.medium
Name : TestIB
NetworkAccessConfiguration : Amazon.AppStream.Model.NetworkAccessConfiguration
Platform : WINDOWS
State : DELETING
StateChangeReason :
VpcConfig : Amazon.AppStream.Model.VpcConfig
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [DeleteImageBuilder](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `Remove-APSImagePermission`
다음 코드 예시는 `Remove-APSImagePermission`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 이미지의 권한을 제거합니다.**
```
Remove-APSImagePermission -Name Powershell -SharedAccountId 123456789012
```
**출력:**
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-APSImagePermission (DeleteImagePermissions)" on target "Powershell".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): A
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [DeleteImagePermissions](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `Remove-APSResourceTag`
다음 코드 예시는 `Remove-APSResourceTag`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 AppStream 리소스에서 리소스 태그를 제거합니다.**
```
Remove-APSResourceTag -ResourceArn arn:aws:appstream:us-east-1:123456789012:stack/SessionScriptTest -TagKey StackState
```
**출력:**
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-APSResourceTag (UntagResource)" on target "arn:aws:appstream:us-east-1:123456789012:stack/SessionScriptTest".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): A
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [UntagResource](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `Remove-APSStack`
다음 코드 예시는 `Remove-APSStack`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 스택을 삭제합니다.**
```
Remove-APSStack -Name TestStack -Region us-west-2
```
**출력:**
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-APSStack (DeleteStack)" on target "TestStack".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): A
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [DeleteStack](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `Remove-APSUsageReportSubscription`
다음 코드 예시는 `Remove-APSUsageReportSubscription`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 AppStream 사용 보고서 구독을 비활성화합니다.**
```
Remove-APSUsageReportSubscription
```
**출력:**
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-APSUsageReportSubscription (DeleteUsageReportSubscription)" on target "".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): A
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [DeleteUsageReportSubscription](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `Remove-APSUser`
다음 코드 예시는 `Remove-APSUser`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 USERPOOL에서 사용자를 삭제합니다.**
```
Remove-APSUser -UserName TestUser@lab.com -AuthenticationType USERPOOL
```
**출력:**
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-APSUser (DeleteUser)" on target "TestUser@lab.com".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): A
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [DeleteUser](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `Revoke-APSSession`
다음 코드 예시는 `Revoke-APSSession`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 AppStream 플릿에 대한 세션을 취소합니다.**
```
Revoke-APSSession -SessionId 6cd2f9a3-f948-4aa1-8014-8a7dcde14877
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [ExpireSession](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `Start-APSFleet`
다음 코드 예시는 `Start-APSFleet`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 플릿을 시작합니다.**
```
Start-APSFleet -Name PowershellFleet
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [StartFleet](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `Start-APSImageBuilder`
다음 코드 예시는 `Start-APSImageBuilder`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 ImageBuilder를 시작합니다.**
```
Start-APSImageBuilder -Name TestImage
```
**출력:**
```
AccessEndpoints : {}
AppstreamAgentVersion : 06-19-2019
Arn : arn:aws:appstream:us-east-1:123456789012:image-builder/TestImage
CreatedTime : 1/14/2019 4:33:05 AM
Description :
DisplayName : TestImage
DomainJoinInfo :
EnableDefaultInternetAccess : False
IamRoleArn :
ImageArn : arn:aws:appstream:us-east-1::image/Base-Image-Builder-05-02-2018
ImageBuilderErrors : {}
InstanceType : stream.standard.large
Name : TestImage
NetworkAccessConfiguration : Amazon.AppStream.Model.NetworkAccessConfiguration
Platform : WINDOWS
State : PENDING
StateChangeReason :
VpcConfig : Amazon.AppStream.Model.VpcConfig
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [StartImageBuilder](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `Stop-APSFleet`
다음 코드 예시는 `Stop-APSFleet`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 플릿을 중지합니다.**
```
Stop-APSFleet -Name PowershellFleet
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [StopFleet](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `Stop-APSImageBuilder`
다음 코드 예시는 `Stop-APSImageBuilder`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 ImageBuilder를 중지합니다.**
```
Stop-APSImageBuilder -Name TestImage
```
**출력:**
```
AccessEndpoints : {}
AppstreamAgentVersion : 06-19-2019
Arn : arn:aws:appstream:us-east-1:123456789012:image-builder/TestImage
CreatedTime : 1/14/2019 4:33:05 AM
Description :
DisplayName : TestImage
DomainJoinInfo :
EnableDefaultInternetAccess : False
IamRoleArn :
ImageArn : arn:aws:appstream:us-east-1::image/Base-Image-Builder-05-02-2018
ImageBuilderErrors : {}
InstanceType : stream.standard.large
Name : TestImage
NetworkAccessConfiguration : Amazon.AppStream.Model.NetworkAccessConfiguration
Platform : WINDOWS
State : STOPPING
StateChangeReason :
VpcConfig : Amazon.AppStream.Model.VpcConfig
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [StopImageBuilder](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `Unregister-APSFleet`
다음 코드 예시는 `Unregister-APSFleet`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 스택에서 플릿 등록을 취소합니다.**
```
Unregister-APSFleet -StackName TestStack -FleetName TestFleet -Region us-west-2
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [DisassociateFleet](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `Unregister-APSUserStackBatch`
다음 코드 예시는 `Unregister-APSUserStackBatch`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 할당된 스택에서 사용자를 제거합니다.**
```
Unregister-APSUserStackBatch -UserStackAssociation @{AuthenticationType="USERPOOL";SendEmailNotification=$False;StackName="PowershellStack";UserName="TestUser1@lab.com"}
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [BatchDisassociateUserStack](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `Update-APSDirectoryConfig`
다음 코드 예시는 `Update-APSDirectoryConfig`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 AppStream에서 생성된 디렉터리 구성을 업데이트합니다.**
```
Update-APSDirectoryConfig -ServiceAccountCredentials_AccountName contoso\ServiceAccount -ServiceAccountCredentials_AccountPassword MyPass@1$@# -DirectoryName contoso.com -OrganizationalUnitDistinguishedName "OU=AppStreamNew,OU=Contoso,DC=Contoso,DC=com"
```
**출력:**
```
CreatedTime DirectoryName OrganizationalUnitDistinguishedNames ServiceAccountCredentials
----------- ------------- ------------------------------------ -------------------------
12/27/2019 3:50:02 PM contoso.com {OU=AppStreamNew,OU=Contoso,DC=Contoso,DC=com} Amazon.AppStream.Model.ServiceAccountCredentials
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [UpdateDirectoryConfig](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `Update-APSFleet`
다음 코드 예시는 `Update-APSFleet`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 플릿의 속성을 업데이트합니다.**
```
Update-APSFleet -Name PowershellFleet -EnableDefaultInternetAccess $True -DisconnectTimeoutInSecond 950
```
**출력:**
```
Arn : arn:aws:appstream:us-east-1:123456789012:fleet/PowershellFleet
ComputeCapacityStatus : Amazon.AppStream.Model.ComputeCapacityStatus
CreatedTime : 4/24/2019 8:39:41 AM
Description : PowershellFleet
DisconnectTimeoutInSeconds : 950
DisplayName : PowershellFleet
DomainJoinInfo :
EnableDefaultInternetAccess : True
FleetErrors : {}
FleetType : ON_DEMAND
IamRoleArn :
IdleDisconnectTimeoutInSeconds : 900
ImageArn : arn:aws:appstream:us-east-1:123456789012:image/Powershell
ImageName : Powershell
InstanceType : stream.standard.medium
MaxUserDurationInSeconds : 57600
Name : PowershellFleet
State : STOPPED
VpcConfig : Amazon.AppStream.Model.VpcConfig
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [UpdateFleet](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `Update-APSImagePermission`
다음 코드 예시는 `Update-APSImagePermission`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 AppStream 이미지를 다른 계정에 공유합니다.**
```
Update-APSImagePermission -Name Powershell -SharedAccountId 123456789012 -ImagePermissions_AllowFleet $True -ImagePermissions_AllowImageBuilder $True
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [UpdateImagePermissions](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `Update-APSStack`
다음 코드 예시는 `Update-APSStack`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 샘플은 스택에서 애플리케이션 설정 지속성과 홈 폴더를 업데이트(활성화)합니다.**
```
Update-APSStack -Name PowershellStack -ApplicationSettings_Enabled $True -ApplicationSettings_SettingsGroup PowershellStack -StorageConnector @{ConnectorType="HOMEFOLDERS"}
```
**출력:**
```
AccessEndpoints : {}
ApplicationSettings : Amazon.AppStream.Model.ApplicationSettingsResponse
Arn : arn:aws:appstream:us-east-1:123456789012:stack/PowershellStack
CreatedTime : 4/24/2019 8:49:29 AM
Description : PowershellStack
DisplayName : PowershellStack
EmbedHostDomains : {}
FeedbackURL :
Name : PowershellStack
RedirectURL :
StackErrors : {}
StorageConnectors : {Amazon.AppStream.Model.StorageConnector, Amazon.AppStream.Model.StorageConnector}
UserSettings : {Amazon.AppStream.Model.UserSetting, Amazon.AppStream.Model.UserSetting, Amazon.AppStream.Model.UserSetting, Amazon.AppStream.Model.UserSetting}
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [UpdateStack](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.