Tools for PowerShell를 사용한 AppStream 2.0 예제 - AWS SDK 코드 예제
작업

AWS Doc SDK ExamplesWord AWS SDK 리포지토리에는 더 많은 GitHub 예제가 있습니다.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Tools for PowerShell를 사용한 AppStream 2.0 예제

다음 코드 예제에서는 AWS Tools for PowerShell with AppStream 2.0을 사용하여 작업을 수행하고 일반적인 시나리오를 구현하는 방법을 보여줍니다.

작업은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 개별 서비스 함수를 직접적으로 호출하는 방법을 보여주며 관련 시나리오의 컨텍스트에 맞는 작업을 볼 수 있습니다.

각 예제에는 컨텍스트에서 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있는 전체 소스 코드에 대한 링크가 포함되어 있습니다.

주제

작업

다음 코드 예시에서는 Add-APSResourceTag을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 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 참조의 TagResource를 참조하세요.

다음 코드 예시에서는 Copy-APSImage을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 1:이 샘플은 이미지를 다른 리전에 복사합니다.

Copy-APSImage -DestinationImageName TestImageCopy -DestinationRegion us-west-2 -SourceImageName Powershell

출력:

TestImageCopy

  • API 세부 정보는 AWS Tools for PowerShell Cmdlet 참조의 CopyImage를 참조하세요.

다음 코드 예시에서는 Disable-APSUSer을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 1:이 샘플은 USERPOOL에서 사용자를 비활성화합니다.

Disable-APSUser -AuthenticationType USERPOOL -UserName TestUser@lab.com

  • API 세부 정보는 AWS Tools for PowerShell Cmdlet 참조의 DisableUser를 참조하세요.

다음 코드 예시에서는 Enable-APSUser을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 1:이 샘플은 USERPOOL에서 비활성화된 사용자를 활성화합니다.

Enable-APSUser -AuthenticationType USERPOOL -UserName TestUser@lab.com

  • API 세부 정보는 AWS Tools for PowerShell Cmdlet 참조의 EnableUser를 참조하세요.

다음 코드 예시에서는 Get-APSAssociatedFleetList을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 1:이 샘플은 스택과 연결된 플릿을 표시합니다.

Get-APSAssociatedFleetList -StackName PowershellStack

출력:

PowershellFleet

  • API 세부 정보는 AWS Tools for PowerShell Cmdlet 참조의 ListAssociatedFleets를 참조하세요.

다음 코드 예시에서는 Get-APSAssociatedStackList을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 1:이 샘플은 플릿과 연결된 스택을 표시합니다.

Get-APSAssociatedStackList -FleetName PowershellFleet

출력:

PowershellStack

  • API 세부 정보는 AWS Tools for PowerShell Cmdlet 참조의 ListAssociatedStacks를 참조하세요.

다음 코드 예시에서는 Get-APSDirectoryConfigList을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 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

다음 코드 예시에서는 Get-APSFleetList을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 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 참조의 DescribeFleets를 참조하세요.

다음 코드 예시에서는 Get-APSImageBuilderList을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 1:이 샘플은 an 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 참조의 DescribeImageBuilders를 참조하세요.

다음 코드 예시에서는 Get-APSImageList을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 1:이 샘플은 Private 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 참조의 DescribeImages를 참조하세요.

다음 코드 예시에서는 Get-APSImagePermission을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 1:이 샘플은 shared AppStream 이미지에 대한 이미지 권한을 표시합니다.

Get-APSImagePermission -Name Powershell  | select SharedAccountId, @{n="AllowFleet";e={$_.ImagePermissions.AllowFleet}}, @{n="AllowImageBuilder";e={$_.ImagePermissions.AllowImageBuilder}}

출력:

SharedAccountId AllowFleet AllowImageBuilder
--------------- ---------- -----------------
123456789012          True              True

다음 코드 예시에서는 Get-APSSessionList을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 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 참조의 DescribeSessions를 참조하세요.

다음 코드 예시에서는 Get-APSStackList을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 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 참조의 DescribeStacks를 참조하세요.

다음 코드 예시에서는 Get-APSTagsForResourceList을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 1:이 샘플은 AppStream 리소스에 태그를 표시합니다.

Get-APSTagsForResourceList -ResourceArn arn:aws:appstream:us-east-1:123456789012:stack/SessionScriptTest

출력:

Key        Value
---        -----
StackState Test

  • API 세부 정보는 AWS Tools for PowerShell Cmdlet 참조의 ListTagsForResource를 참조하세요.

다음 코드 예시에서는 Get-APSUsageReportSubscription을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 1:이 샘플은 AppStreamUsageReport 구성 세부 정보를 표시합니다.

Get-APSUsageReportSubscription

출력:

LastGeneratedReportDate S3BucketName                                   Schedule SubscriptionErrors
----------------------- ------------                                   -------- ------------------
1/1/0001 12:00:00 AM    appstream-logs-us-east-1-123456789012-sik1hnxe DAILY    {}

다음 코드 예시에서는 Get-APSUser을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 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 참조의 DescribeUsers를 참조하세요.

다음 코드 예시에서는 Get-APSUserStackAssociation을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 1:이 샘플은 스택에 할당된 사용자 목록을 표시합니다.

Get-APSUserStackAssociation -StackName PowershellStack

출력:

AuthenticationType SendEmailNotification StackName       UserName
------------------ --------------------- ---------       --------
USERPOOL           False                 PowershellStack TestUser1@lab.com
USERPOOL           False                 PowershellStack TestUser2@lab.com

다음 코드 예시에서는 New-APSDirectoryConfig을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 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 참조의 CreateDirectoryConfig를 참조하세요.

다음 코드 예시에서는 New-APSFleet을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 1:이 샘플은 new 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 참조의 CreateFleet를 참조하세요.

다음 코드 예시에서는 New-APSImageBuilder을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 1:이 샘플은 Image Builder in AppStream를 생성합니다.

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 참조의 CreateImageBuilder를 참조하세요.

다음 코드 예시에서는 New-APSImageBuilderStreamingURL을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 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

다음 코드 예시에서는 New-APSStack을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 1:이 샘플은 new AppStream Stack을 생성합니다.

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 참조의 CreateStack를 참조하세요.

다음 코드 예시에서는 New-APSStreamingURL을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 1:이 샘플은 스트리밍 URL of Stack을 생성합니다.

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 참조의 CreateStreamingURLWord를 참조하세요.

다음 코드 예시에서는 New-APSUsageReportSubscription을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 1:이 샘플은 AppStream 사용 보고서를 활성화합니다.

New-APSUsageReportSubscription

출력:

S3BucketName                                   Schedule
------------                                   --------
appstream-logs-us-east-1-123456789012-sik2hnxe DAILY

다음 코드 예시에서는 New-APSUser을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 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 참조의 CreateUser를 참조하세요.

다음 코드 예시에서는 Register-APSFleet을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 1:이 샘플은 스택에 플릿을 등록합니다.

Register-APSFleet -StackName TestStack -FleetName TestFleet -Region us-west-2

  • API 세부 정보는 AWS Tools for PowerShell Cmdlet 참조의 AssociateFleet를 참조하세요.

다음 코드 예시에서는 Register-APSUserStackBatch을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 1:이 샘플은 USERPOOL에서 사용자에게 스택을 할당합니다.

Register-APSUserStackBatch -UserStackAssociation @{AuthenticationType="USERPOOL";SendEmailNotification=$False;StackName="PowershellStack";UserName="TestUser1@lab.com"}

다음 코드 예시에서는 Remove-APSDirectoryConfig을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 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 참조의 DeleteDirectoryConfig를 참조하세요.

다음 코드 예시에서는 Remove-APSFleet을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 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 참조의 DeleteFleet를 참조하세요.

다음 코드 예시에서는 Remove-APSImage을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 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 참조의 DeleteImage를 참조하세요.

다음 코드 예시에서는 Remove-APSImageBuilder을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 1:이 샘플은 an 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 참조의 DeleteImageBuilder를 참조하세요.

다음 코드 예시에서는 Remove-APSImagePermission을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 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

다음 코드 예시에서는 Remove-APSResourceTag을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 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 참조의 UntagResource를 참조하세요.

다음 코드 예시에서는 Remove-APSStack을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 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 참조의 DeleteStack를 참조하세요.

다음 코드 예시에서는 Remove-APSUsageReportSubscription을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 1:이 샘플은 AppStream Usage Report 구독을 비활성화합니다.

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

다음 코드 예시에서는 Remove-APSUser을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 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 참조의 DeleteUser를 참조하세요.

다음 코드 예시에서는 Revoke-APSSession을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 1:이 샘플은 AppStream 플릿에 대한 세션을 취소합니다.

Revoke-APSSession -SessionId 6cd2f9a3-f948-4aa1-8014-8a7dcde14877

  • API 세부 정보는 AWS Tools for PowerShell Cmdlet 참조의 ExpireSession를 참조하세요.

다음 코드 예시에서는 Start-APSFleet을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 1:이 샘플은 플릿을 시작합니다.

Start-APSFleet -Name PowershellFleet

  • API 세부 정보는 AWS Tools for PowerShell Cmdlet 참조의 StartFleet를 참조하세요.

다음 코드 예시에서는 Start-APSImageBuilder을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 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 참조의 StartImageBuilder를 참조하세요.

다음 코드 예시에서는 Stop-APSFleet을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 1:이 샘플은 플릿을 중지합니다.

Stop-APSFleet -Name PowershellFleet

  • API 세부 정보는 AWS Tools for PowerShell Cmdlet 참조의 StopFleet를 참조하세요.

다음 코드 예시에서는 Stop-APSImageBuilder을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 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 참조의 StopImageBuilder를 참조하세요.

다음 코드 예시에서는 Unregister-APSFleet을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 1:이 샘플은 스택에서 플릿 등록을 취소합니다.

Unregister-APSFleet -StackName TestStack -FleetName TestFleet -Region us-west-2

  • API 세부 정보는 AWS Tools for PowerShell Cmdlet 참조의 DisassociateFleet를 참조하세요.

다음 코드 예시에서는 Unregister-APSUserStackBatch을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 1:이 샘플은 할당된 스택에서 사용자를 제거합니다.

Unregister-APSUserStackBatch -UserStackAssociation @{AuthenticationType="USERPOOL";SendEmailNotification=$False;StackName="PowershellStack";UserName="TestUser1@lab.com"}

다음 코드 예시에서는 Update-APSDirectoryConfig을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 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 참조의 UpdateDirectoryConfig를 참조하세요.

다음 코드 예시에서는 Update-APSFleet을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 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 참조의 UpdateFleet를 참조하세요.

다음 코드 예시에서는 Update-APSImagePermission을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 1:이 샘플은 다른 계정과 AppStream 이미지를 공유합니다.

Update-APSImagePermission -Name Powershell -SharedAccountId 123456789012 -ImagePermissions_AllowFleet $True -ImagePermissions_AllowImageBuilder $True

다음 코드 예시에서는 Update-APSStack을 사용하는 방법을 보여 줍니다.

for PowerShell 도구

예제 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 참조의 UpdateStack를 참조하세요.