AppStream 2.0-Beispiele mit Tools für PowerShell

Die folgenden Codebeispiele zeigen Ihnen, wie Sie Aktionen ausführen und allgemeine Szenarien implementieren, indem Sie das AWS Tools for PowerShell mit AppStream 2.0 verwenden.

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Aktionen zeigen Ihnen zwar, wie Sie einzelne Servicefunktionen aufrufen, aber Sie können Aktionen im Kontext der zugehörigen Szenarien sehen.

Jedes Beispiel enthält einen Link zum vollständigen Quellcode, in dem Sie Anweisungen zum Einrichten und Ausführen des Codes im Kontext finden.

Themen

Aktionen

Aktionen

Das folgende Codebeispiel zeigt die VerwendungAdd-APSResourceTag.

Tools für PowerShell

Beispiel 1: Dieses Beispiel fügt der Ressource ein Ressourcen-Tag hinzu AppStream


Add-APSResourceTag -ResourceArn arn:aws:appstream:us-east-1:123456789012:stack/SessionScriptTest -Tag @{StackState='Test'} -Select ^Tag

Ausgabe:


Name                           Value
----                           -----
StackState                     Test

APIEinzelheiten finden Sie unter TagResource AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt, wie Sie es verwenden. Copy-APSImage

Tools für PowerShell

Beispiel 1: Dieses Beispiel kopiert ein Bild in eine andere Region


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

Ausgabe:


TestImageCopy

APIEinzelheiten finden Sie unter CopyImage AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt, wie Sie es verwenden. Disable-APSUSer

Tools für PowerShell

Beispiel 1: Dieses Beispiel deaktiviert einen Benutzer in USERPOOL


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

APIEinzelheiten finden Sie unter DisableUser AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt, wie Sie es verwenden. Enable-APSUser

Tools für PowerShell

Beispiel 1: Dieses Beispiel aktiviert einen deaktivierten Benutzer in USERPOOL


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

APIEinzelheiten finden Sie unter EnableUser AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt, wie Sie es verwenden. Get-APSAssociatedFleetList

Tools für PowerShell

Beispiel 1: In diesem Beispiel wird eine Flotte angezeigt, die einem Stapel zugeordnet ist


Get-APSAssociatedFleetList -StackName PowershellStack

Ausgabe:


PowershellFleet

APIEinzelheiten finden Sie unter ListAssociatedFleets AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt, wie Sie es verwenden. Get-APSAssociatedStackList

Tools für PowerShell

Beispiel 1: In diesem Beispiel wird ein Stapel angezeigt, der einer Flotte zugeordnet ist


Get-APSAssociatedStackList -FleetName PowershellFleet

Ausgabe:


PowershellStack

APIEinzelheiten finden Sie unter ListAssociatedStacks AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt, wie Sie es verwenden. Get-APSDirectoryConfigList

Tools für PowerShell

Beispiel 1: In diesem Beispiel werden Verzeichniskonfigurationen angezeigt, die in erstellt wurden AppStream


Get-APSDirectoryConfigList | Select DirectoryName, OrganizationalUnitDistinguishedNames, CreatedTime

Ausgabe:


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

APIEinzelheiten finden Sie unter DescribeDirectoryConfigs AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt, wie Sie es verwenden. Get-APSFleetList

Tools für PowerShell

Beispiel 1: Dieses Beispiel zeigt Details einer Flotte


Get-APSFleetList -Name Test

Ausgabe:


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

APIEinzelheiten finden Sie unter DescribeFleets AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt, wie Sie es verwenden. Get-APSImageBuilderList

Tools für PowerShell

Beispiel 1: Dieses Beispiel zeigt Details eines ImageBuilder


Get-APSImageBuilderList -Name TestImage

Ausgabe:


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

APIEinzelheiten finden Sie unter DescribeImageBuilders AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt, wie Sie es verwenden. Get-APSImageList

Tools für PowerShell

Beispiel 1: In diesem Beispiel werden private AppStream Bilder angezeigt


Get-APSImageList -Type PRIVATE | select DisplayName, ImageBuilderName, Visibility, arn

Ausgabe:


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

APIEinzelheiten finden Sie unter DescribeImages AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt, wie Sie es verwenden. Get-APSImagePermission

Tools für PowerShell

Beispiel 1: In diesem Beispiel werden Bildberechtigungen für ein geteiltes AppStream Bild angezeigt


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

Ausgabe:


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

APIEinzelheiten finden Sie unter DescribeImagePermissions AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt, wie Sie es verwenden. Get-APSSessionList

Tools für PowerShell

Beispiel 1: In diesem Beispiel wird eine Liste von Sitzungen für eine Flotte angezeigt


Get-APSSessionList -FleetName PowershellFleet -StackName PowershellStack

Ausgabe:


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

APIEinzelheiten finden Sie unter DescribeSessions AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt, wie Sie es verwenden. Get-APSStackList

Tools für PowerShell

Beispiel 1: In diesem Beispiel wird eine Liste von AppStream Stack angezeigt


Get-APSStackList | Select DisplayName, Arn, CreatedTime

Ausgabe:


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

APIEinzelheiten finden Sie unter DescribeStacks AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt, wie Sie es verwenden. Get-APSTagsForResourceList

Tools für PowerShell

Beispiel 1: In diesem Beispiel werden Tags auf einer AppStream Ressource angezeigt


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

Ausgabe:


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

APIEinzelheiten finden Sie unter ListTagsForResource AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt, wie Sie es verwenden. Get-APSUsageReportSubscription

Tools für PowerShell

Beispiel 1: In diesem Beispiel werden AppStreamUsageReport Konfigurationsdetails angezeigt


Get-APSUsageReportSubscription

Ausgabe:


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

APIEinzelheiten finden Sie unter DescribeUsageReportSubscriptions AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt, wie Sie es verwenden. Get-APSUser

Tools für PowerShell

Beispiel 1: In diesem Beispiel wird eine Liste von Benutzern mit aktiviertem Status angezeigt


Get-APSUser -AuthenticationType USERPOOL | Select-Object UserName, AuthenticationType, Enabled

Ausgabe:


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

APIEinzelheiten finden Sie unter DescribeUsers AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt, wie Sie es verwenden. Get-APSUserStackAssociation

Tools für PowerShell

Beispiel 1: In diesem Beispiel wird eine Liste der Benutzer angezeigt, die einem Stack zugewiesen sind


Get-APSUserStackAssociation -StackName PowershellStack

Ausgabe:


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

APIEinzelheiten finden Sie unter DescribeUserStackAssociations AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt, wie Sie es verwenden. New-APSDirectoryConfig

Tools für PowerShell

Beispiel 1: Dieses Beispiel erstellt eine Verzeichniskonfiguration in AppStream


New-APSDirectoryConfig -ServiceAccountCredentials_AccountName contoso\ServiceAccount -ServiceAccountCredentials_AccountPassword MyPass -DirectoryName contoso.com -OrganizationalUnitDistinguishedName "OU=AppStream,OU=Contoso,DC=Contoso,DC=com"

Ausgabe:


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

APIEinzelheiten finden Sie unter CreateDirectoryConfig AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt, wie Sie es verwenden. New-APSFleet

Tools für PowerShell

Beispiel 1: Dieses Beispiel erstellt eine neue AppStream Flotte


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

Ausgabe:


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

APIEinzelheiten finden Sie unter CreateFleet AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt, wie Sie es verwenden. New-APSImageBuilder

Tools für PowerShell

Beispiel 1: Dieses Beispiel erstellt einen 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

Ausgabe:


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

APIEinzelheiten finden Sie unter CreateImageBuilder AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt, wie Sie es verwenden. New-APSImageBuilderStreamingURL

Tools für PowerShell

Beispiel 1: Dieses Beispiel erstellt ein ImageBuilder Streaming URL mit einer Gültigkeit von 2 Stunden


New-APSImageBuilderStreamingURL -Name TestIB -Validity 7200 -Region us-west-2

Ausgabe:


Expires               StreamingURL
-------               ------------
12/27/2019 1:49:13 PM https://appstream2.us-west-2.aws.amazon.com/authenticate?parameters=eyJ0eXBlIjoiQURNSU4iLCJleHBpcmVzIjoiMTU3NzQ1NDU1MyIsImF3c0FjY291bnRJZCI6IjM5MzQwMzgxMTQwNyIsInVzZXJJZCI6ImFkbWluIiwiY2F

APIEinzelheiten finden Sie unter CreateImageBuilderStreamingURL AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt die Verwendung. New-APSStack

Tools für PowerShell

Beispiel 1: Dieses Beispiel erstellt einen neuen AppStream Stack


New-APSStack -Name TestStack -DisplayName TestStack -ApplicationSettings_Enabled $True -ApplicationSettings_SettingsGroup TestStack -Region us-west-2

Ausgabe:


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}

APIEinzelheiten finden Sie unter CreateStack AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt, wie Sie es verwenden. New-APSStreamingURL

Tools für PowerShell

Beispiel 1: Dieses Beispiel erstellt ein Streaming URL von Stack


New-APSStreamingURL -StackName SessionScriptTest -FleetName SessionScriptNew -UserId TestUser

Ausgabe:


Expires                StreamingURL
-------                ------------
12/27/2019 12:43:37 PM https://appstream2.us-east-1.aws.amazon.com/authenticate?parameters=eyJ0eXBlIjoiRU5EX1VTRVIiLCJleHBpcmVzIjoiMTU3NzQ1MDYxNyIsImF3c0FjY291bnRJZCI6IjM5MzQwMzgxMTQwNyIsInVzZXJJZCI6IlRlc3RVc2

APIEinzelheiten finden Sie unter CreateStreamingURL AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt die Verwendung. New-APSUsageReportSubscription

Tools für PowerShell

Beispiel 1: In diesem Beispiel werden AppStream Nutzungsberichte aktiviert


New-APSUsageReportSubscription

Ausgabe:


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

APIEinzelheiten finden Sie unter CreateUsageReportSubscription AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt, wie Sie es verwenden. New-APSUser

Tools für PowerShell

Beispiel 1: Dieses Beispiel erstellt einen Benutzer in USERPOOL


New-APSUser -UserName Test@lab.com -AuthenticationType USERPOOL -FirstName 'kt' -LastName 'aws' -Select ^UserName

Ausgabe:


Test@lab.com

APIEinzelheiten finden Sie unter CreateUser AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt, wie Sie es verwenden. Register-APSFleet

Tools für PowerShell

Beispiel 1: Dieses Beispiel registriert eine Flotte mit einem Stack


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

APIEinzelheiten finden Sie unter AssociateFleet AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt, wie Sie es verwenden. Register-APSUserStackBatch

Tools für PowerShell

Beispiel 1: Dieses Beispiel weist einem Benutzer einen Stack zu in USERPOOL


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

APIEinzelheiten finden Sie unter BatchAssociateUserStack AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt, wie Sie es verwenden. Remove-APSDirectoryConfig

Tools für PowerShell

Beispiel 1: In diesem Beispiel wird die AppStream Verzeichniskonfiguration entfernt


Remove-APSDirectoryConfig -DirectoryName contoso.com

Ausgabe:


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

APIEinzelheiten finden Sie unter DeleteDirectoryConfig AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt, wie Sie es verwenden. Remove-APSFleet

Tools für PowerShell

Beispiel 1: Dieses Beispiel entfernt und löscht eine Flotte AppStream


Remove-APSFleet -Name TestFleet -Region us-west-2

Ausgabe:


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

APIEinzelheiten finden Sie unter DeleteFleet AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt, wie Sie es verwenden. Remove-APSImage

Tools für PowerShell

Beispiel 1: Dieses Beispiel löscht ein Bild


Remove-APSImage -Name TestImage -Region us-west-2

Ausgabe:


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

APIEinzelheiten finden Sie unter DeleteImage AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt, wie Sie es verwenden. Remove-APSImageBuilder

Tools für PowerShell

Beispiel 1: Dieses Beispiel löscht ein ImageBuilder


Remove-APSImageBuilder -Name TestIB -Region us-west-2

Ausgabe:


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

APIEinzelheiten finden Sie unter DeleteImageBuilder AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt, wie Sie es verwenden. Remove-APSImagePermission

Tools für PowerShell

Beispiel 1: In diesem Beispiel werden die Berechtigungen eines Bilds entfernt


Remove-APSImagePermission -Name Powershell -SharedAccountId 123456789012

Ausgabe:


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

APIEinzelheiten finden Sie unter DeleteImagePermissions AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt, wie Sie es verwenden. Remove-APSResourceTag

Tools für PowerShell

Beispiel 1: In diesem Beispiel wird ein Ressourcen-Tag aus einer AppStream Ressource entfernt


Remove-APSResourceTag -ResourceArn arn:aws:appstream:us-east-1:123456789012:stack/SessionScriptTest -TagKey StackState

Ausgabe:


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

APIEinzelheiten finden Sie unter UntagResource AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt, wie Sie es verwenden. Remove-APSStack

Tools für PowerShell

Beispiel 1: Dieses Beispiel löscht einen Stack


Remove-APSStack -Name TestStack -Region us-west-2

Ausgabe:


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

APIEinzelheiten finden Sie unter DeleteStack AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt die Verwendung. Remove-APSUsageReportSubscription

Tools für PowerShell

Beispiel 1: In diesem Beispiel wird das Abonnement für den AppStream Nutzungsbericht deaktiviert


Remove-APSUsageReportSubscription

Ausgabe:


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

APIEinzelheiten finden Sie unter DeleteUsageReportSubscription AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt die Verwendung. Remove-APSUser

Tools für PowerShell

Beispiel 1: Dieses Beispiel löscht einen Benutzer von USERPOOL


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

Ausgabe:


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

APIEinzelheiten finden Sie unter DeleteUser AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt die Verwendung. Revoke-APSSession

Tools für PowerShell

Beispiel 1: Dieses Beispiel widerruft eine Sitzung für Fleet AppStream


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

APIEinzelheiten finden Sie unter ExpireSession AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt die Verwendung. Start-APSFleet

Tools für PowerShell

Beispiel 1: Dieses Beispiel startet eine Flotte


Start-APSFleet -Name PowershellFleet

APIEinzelheiten finden Sie unter StartFleet AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt die Verwendung. Start-APSImageBuilder

Tools für PowerShell

Beispiel 1: Dieses Beispiel startet ein ImageBuilder


Start-APSImageBuilder -Name TestImage

Ausgabe:


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

APIEinzelheiten finden Sie unter StartImageBuilder AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt die Verwendung. Stop-APSFleet

Tools für PowerShell

Beispiel 1: Dieses Beispiel stoppt eine Flotte


Stop-APSFleet -Name PowershellFleet

APIEinzelheiten finden Sie unter StopFleet AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt die Verwendung. Stop-APSImageBuilder

Tools für PowerShell

Beispiel 1: Dieses Beispiel stoppt ein ImageBuilder


Stop-APSImageBuilder -Name TestImage

Ausgabe:


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

APIEinzelheiten finden Sie unter StopImageBuilder AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt die Verwendung. Unregister-APSFleet

Tools für PowerShell

Beispiel 1: In diesem Beispiel wird die Registrierung einer Flotte vom Stapel aufgehoben


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

APIEinzelheiten finden Sie unter DisassociateFleet AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt die Verwendung. Unregister-APSUserStackBatch

Tools für PowerShell

Beispiel 1: Dieses Beispiel entfernt einen Benutzer aus einem zugewiesenen Stack


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

APIEinzelheiten finden Sie unter BatchDisassociateUserStack AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt die Verwendung. Update-APSDirectoryConfig

Tools für PowerShell

Beispiel 1: Dieses Beispiel aktualisiert die Verzeichniskonfiguration, die in erstellt wurde AppStream


Update-APSDirectoryConfig -ServiceAccountCredentials_AccountName contoso\ServiceAccount -ServiceAccountCredentials_AccountPassword MyPass@1$@# -DirectoryName contoso.com -OrganizationalUnitDistinguishedName "OU=AppStreamNew,OU=Contoso,DC=Contoso,DC=com"

Ausgabe:


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

APIEinzelheiten finden Sie unter UpdateDirectoryConfig AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt die Verwendung. Update-APSFleet

Tools für PowerShell

Beispiel 1: In diesem Beispiel werden die Eigenschaften einer Flotte aktualisiert


Update-APSFleet -Name PowershellFleet -EnableDefaultInternetAccess $True -DisconnectTimeoutInSecond 950

Ausgabe:


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

APIEinzelheiten finden Sie unter UpdateFleet AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt die Verwendung. Update-APSImagePermission

Tools für PowerShell

Beispiel 1: Dieses Beispiel teilt ein AppStream Bild mit einem anderen Konto


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

APIEinzelheiten finden Sie unter UpdateImagePermissions AWS Tools for PowerShellCmdlet-Referenz.

Das folgende Codebeispiel zeigt die Verwendung. Update-APSStack

Tools für PowerShell

Beispiel 1: Dieses Beispiel aktualisiert (aktiviert) die Persistenz von Anwendungseinstellungen und Basisordnern auf einem Stack


Update-APSStack -Name PowershellStack -ApplicationSettings_Enabled $True -ApplicationSettings_SettingsGroup PowershellStack -StorageConnector @{ConnectorType="HOMEFOLDERS"}

Ausgabe:


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}

APIEinzelheiten finden Sie unter UpdateStack AWS Tools for PowerShellCmdlet-Referenz.

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

Application Auto Scaling

Aurora