AppStream 2.0-Beispiele unter Verwendung von Tools für PowerShell V4

Die folgenden Codebeispiele zeigen, wie Sie Aktionen durchführen und gängige Szenarien implementieren, indem Sie AWS -Tools für PowerShell V4 mit AppStream 2.0 nutzen.

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

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

Aktionen

Add-APSResourceTag

Die folgenden Codebeispiele zeigen, wie Add-APSResourceTag verwendet wird.

Tools für PowerShell V4

Beispiel 1: In diesem Beispiel wird ein Ressourcen-Tag zur AppStream-Ressource hinzugefügt

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

Ausgabe:

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

• Weitere API-Informationen finden Sie unter TagResource in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

Copy-APSImage

Die folgenden Codebeispiele zeigen, wie Copy-APSImage verwendet wird.

Tools für PowerShell V4

Beispiel 1: In diesem Beispiel wird ein Image in eine andere Region kopiert

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

Ausgabe:

TestImageCopy

• Weitere API-Informationen finden Sie unter CopyImage in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

Disable-APSUSer

Die folgenden Codebeispiele zeigen, wie Disable-APSUSer verwendet wird.

Tools für PowerShell V4

Beispiel 1: In diesem Beispiel wird ein Benutzer in USERPOOL deaktiviert

Disable-APSUser -AuthenticationType USERPOOL -UserName [e-mail]

• Weitere API-Informationen finden Sie unter DisableUser in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

Enable-APSUser

Die folgenden Codebeispiele zeigen, wie Enable-APSUser verwendet wird.

Tools für PowerShell V4

Beispiel 1: In diesem Beispiel wird ein deaktivierter Benutzer in USERPOOL aktiviert

Enable-APSUser -AuthenticationType USERPOOL -UserName [e-mail]

• Weitere API-Informationen finden Sie unter EnableUser in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

Get-APSAssociatedFleetList

Die folgenden Codebeispiele zeigen, wie Get-APSAssociatedFleetList verwendet wird.

Tools für PowerShell V4

Beispiel 1: In diesem Beispiel wird die einem Stack zugeordnete Flotte angezeigt

Get-APSAssociatedFleetList -StackName PowershellStack

Ausgabe:

PowershellFleet

• Weitere API-Informationen finden Sie unter ListAssociatedFleets in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

Get-APSAssociatedStackList

Die folgenden Codebeispiele zeigen, wie Get-APSAssociatedStackList verwendet wird.

Tools für PowerShell V4

Beispiel 1: In diesem Beispiel wird der einer Flotte zugeordnete Stack angezeigt

Get-APSAssociatedStackList -FleetName PowershellFleet

Ausgabe:

PowershellStack

• Weitere API-Informationen finden Sie unter ListAssociatedStacks in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

Get-APSDirectoryConfigList

Die folgenden Codebeispiele zeigen, wie Get-APSDirectoryConfigList verwendet wird.

Tools für PowerShell V4

Beispiel 1: In diesem Beispiel werden die in AppStream erstellten Directory-Konfigurationen aktualisiert

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

• Weitere API-Informationen finden Sie unter DescribeDirectoryConfigs in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

Get-APSFleetList

Die folgenden Codebeispiele zeigen, wie Get-APSFleetList verwendet wird.

Tools für PowerShell V4

Beispiel 1: In diesem Beispiel werden Details einer Flotte angezeigt

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

• Weitere API-Informationen finden Sie unter DescribeFleets in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

Get-APSImageBuilderList

Die folgenden Codebeispiele zeigen, wie Get-APSImageBuilderList verwendet wird.

Tools für PowerShell V4

Beispiel 1: In diesem Beispiel werden Details eines ImageBuilder angezeigt

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

• Weitere API-Informationen finden Sie unter DescribeImageBuilders in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

Get-APSImageList

Die folgenden Codebeispiele zeigen, wie Get-APSImageList verwendet wird.

Tools für PowerShell V4

Beispiel 1: In diesem Beispiel werden private AppStream-Images 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

• Weitere API-Informationen finden Sie unter DescribeImages in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

Get-APSImagePermission

Die folgenden Codebeispiele zeigen, wie Get-APSImagePermission verwendet wird.

Tools für PowerShell V4

Beispiel 1: In diesem Beispiel werden Image-Berechtigungen für ein geteiltes AppStream-Image angezeigt

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

Ausgabe:

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

• Weitere API-Informationen finden Sie unter DescribeImagePermissions in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

Get-APSSessionList

Die folgenden Codebeispiele zeigen, wie Get-APSSessionList verwendet wird.

Tools für PowerShell V4

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

• Weitere API-Informationen finden Sie unter DescribeSessions in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

Get-APSStackList

Die folgenden Codebeispiele zeigen, wie Get-APSStackList verwendet wird.

Tools für PowerShell V4

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

• Weitere API-Informationen finden Sie unter DescribeStacks in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

Get-APSTagsForResourceList

Die folgenden Codebeispiele zeigen, wie Get-APSTagsForResourceList verwendet wird.

Tools für PowerShell V4

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

• Weitere API-Informationen finden Sie unter ListTagsForResource in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

Get-APSUsageReportSubscription

Die folgenden Codebeispiele zeigen, wie Get-APSUsageReportSubscription verwendet wird.

Tools für PowerShell V4

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    {}

• Weitere API-Informationen finden Sie unter DescribeUsageReportSubscriptions in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

Get-APSUser

Die folgenden Codebeispiele zeigen, wie Get-APSUser verwendet wird.

Tools für PowerShell V4

Beispiel 1: In diesem Beispiel wird eine Liste von Benutzern mit dem Status „Aktiviert“ angezeigt

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

Ausgabe:

UserName                   AuthenticationType Enabled
--------                   ------------------ -------
[e-mail] USERPOOL              True
[e-mail]        USERPOOL              True
[e-mail]    USERPOOL              True
[e-mail]   USERPOOL              True
[e-mail]         USERPOOL              True

• Weitere API-Informationen finden Sie unter DescribeUsers in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

Get-APSUserStackAssociation

Die folgenden Codebeispiele zeigen, wie Get-APSUserStackAssociation verwendet wird.

Tools für PowerShell V4

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 [e-mail]
USERPOOL           False                 PowershellStack [e-mail]

• Weitere API-Informationen finden Sie unter DescribeUserStackAssociations in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

New-APSDirectoryConfig

Die folgenden Codebeispiele zeigen, wie New-APSDirectoryConfig verwendet wird.

Tools für PowerShell

Beispiel 1: In diesem Beispiel wird eine Directory-Konfiguration in AppStream erstellt

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

• Weitere API-Informationen finden Sie unter CreateDirectoryConfig in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

New-APSFleet

Die folgenden Codebeispiele zeigen, wie New-APSFleet verwendet wird.

Tools für PowerShell V4

Beispiel 1: In diesem Beispiel wird eine neue AppStream-Flotte erstellt

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

• Weitere API-Informationen finden Sie unter CreateFleet in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

New-APSImageBuilder

Die folgenden Codebeispiele zeigen, wie New-APSImageBuilder verwendet wird.

Tools für PowerShell V4

Beispiel 1: In diesem Beispiel wird ein ImageBuilder in AppStream erstellt

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

• Weitere API-Informationen finden Sie unter CreateImageBuilder in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

New-APSImageBuilderStreamingURL

Die folgenden Codebeispiele zeigen, wie New-APSImageBuilderStreamingURL verwendet wird.

Tools für PowerShell V4

Beispiel 1: In diesem Beispiel wird eine ImageBuilder-Streaming-URL mit einer Gültigkeit von 2 Stunden erstellt

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

• Weitere API-Informationen finden Sie unter CreateImageBuilderStreamingURL in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

New-APSStack

Die folgenden Codebeispiele zeigen, wie New-APSStack verwendet wird.

Tools für PowerShell V4

Beispiel 1: In diesem Beispiel wird ein neuer AppStream-Stack erstellt

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}

• Weitere API-Informationen finden Sie unter CreateStack in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

New-APSStreamingURL

Die folgenden Codebeispiele zeigen, wie New-APSStreamingURL verwendet wird.

Tools für PowerShell V4

Beispiel 1: In diesem Beispiel wird eine Streaming-URL eines Stacks erstellt

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

• Weitere API-Informationen finden Sie unter CreateStreamingURL in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

New-APSUsageReportSubscription

Die folgenden Codebeispiele zeigen, wie New-APSUsageReportSubscription verwendet wird.

Tools für PowerShell V4

Beispiel 1: In diesem Beispiel werden AppStream Usage Reports aktiviert

New-APSUsageReportSubscription

Ausgabe:

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

• Weitere API-Informationen finden Sie unter CreateUsageReportSubscription in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

New-APSUser

Die folgenden Codebeispiele zeigen, wie New-APSUser verwendet wird.

Tools für PowerShell V4

Beispiel 1: In diesem Beispiel wird ein Benutzer in USERPOOL erstellt

New-APSUser -UserName [e-mail] -AuthenticationType USERPOOL -FirstName 'kt' -LastName 'aws' -Select ^UserName

Ausgabe:

[e-mail]

• Weitere API-Informationen finden Sie unter CreateUser in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

Register-APSFleet

Die folgenden Codebeispiele zeigen, wie Register-APSFleet verwendet wird.

Tools für PowerShell V4

Beispiel 1: In diesem Beispiel wird eine Flotte bei einem Stack registriert

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

• Weitere API-Informationen finden Sie unter AssociateFleet in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

Register-APSUserStackBatch

Die folgenden Codebeispiele zeigen, wie Register-APSUserStackBatch verwendet wird.

Tools für PowerShell V4

Beispiel 1: In diesem Beispiel wird einem Benutzer in USERPOOL ein Stack zugewiesen

Register-APSUserStackBatch -UserStackAssociation @{AuthenticationType="USERPOOL";SendEmailNotification=$False;StackName="PowershellStack";UserName="[e-mail]"}

• Weitere API-Informationen finden Sie unter BatchAssociateUserStack in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

Remove-APSDirectoryConfig

Die folgenden Codebeispiele zeigen, wie Remove-APSDirectoryConfig verwendet wird.

Tools für PowerShell V4

Beispiel 1: In diesem Beispiel wird eine AppStream-Directory-Konfiguration 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

• Weitere API-Informationen finden Sie unter DeleteDirectoryConfig in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

Remove-APSFleet

Die folgenden Codebeispiele zeigen, wie Remove-APSFleet verwendet wird.

Tools für PowerShell V4

Beispiel 1: In diesem Beispiel wird eine AppStream-Flotte gelöscht

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

• Weitere API-Informationen finden Sie unter DeleteFleet in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

Remove-APSImage

Die folgenden Codebeispiele zeigen, wie Remove-APSImage verwendet wird.

Tools für PowerShell V4

Beispiel 1: In diesem Beispiel wird ein Image gelöscht

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

• Weitere API-Informationen finden Sie unter DeleteImage in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

Remove-APSImageBuilder

Die folgenden Codebeispiele zeigen, wie Remove-APSImageBuilder verwendet wird.

Tools für PowerShell V4

Beispiel 1: In diesem Beispiel wird ein ImageBuilder gelöscht

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

• Weitere API-Informationen finden Sie unter DeleteImageBuilder in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

Remove-APSImagePermission

Die folgenden Codebeispiele zeigen, wie Remove-APSImagePermission verwendet wird.

Tools für PowerShell V4

Beispiel 1: In diesem Beispiel werden die Berechtigungen eines Images 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

• Weitere API-Informationen finden Sie unter DeleteImagePermissions in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

Remove-APSResourceTag

Die folgenden Codebeispiele zeigen, wie Remove-APSResourceTag verwendet wird.

Tools für PowerShell V4

Beispiel 1: In diesem Beispiel wird ein Ressourcen-Tag aus der 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

• Weitere API-Informationen finden Sie unter UntagResource in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

Remove-APSStack

Die folgenden Codebeispiele zeigen, wie Remove-APSStack verwendet wird.

Tools für PowerShell V4

Beispiel 1: In diesem Beispiel wird ein Stack gelöscht

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

• Weitere API-Informationen finden Sie unter DeleteStack in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

Remove-APSUsageReportSubscription

Die folgenden Codebeispiele zeigen, wie Remove-APSUsageReportSubscription verwendet wird.

Tools für PowerShell V4

Beispiel 1: In diesem Beispiel wird das Abonnement von AppStream Usage Report 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

• Weitere API-Informationen finden Sie unter DeleteUsageReportSubscription in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

Remove-APSUser

Die folgenden Codebeispiele zeigen, wie Remove-APSUser verwendet wird.

Tools für PowerShell V4

Beispiel 1: In diesem Beispiel wird ein Benutzer aus USERPOOL gelöscht

Remove-APSUser -UserName [e-mail] -AuthenticationType USERPOOL

Ausgabe:

Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-APSUser (DeleteUser)" on target "[e-mail]".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"): A

• Weitere API-Informationen finden Sie unter DeleteUser in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

Revoke-APSSession

Die folgenden Codebeispiele zeigen, wie Revoke-APSSession verwendet wird.

Tools für PowerShell V4

Beispiel 1: In diesem Beispiel wird eine Sitzung mit AppStream Fleet widerrufen

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

• Weitere API-Informationen finden Sie unter ExpireSession in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

Start-APSFleet

Die folgenden Codebeispiele zeigen, wie Start-APSFleet verwendet wird.

Tools für PowerShell V4

Beispiel 1: In diesem Beispiel wird eine Flotte gestartet

Start-APSFleet -Name PowershellFleet

• Weitere API-Informationen finden Sie unter StartFleet in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

Start-APSImageBuilder

Die folgenden Codebeispiele zeigen, wie Start-APSImageBuilder verwendet wird.

Tools für PowerShell V4

Beispiel 1: In diesem Beispiel wird ein ImageBuilder gestartet

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

• Weitere API-Informationen finden Sie unter StartImageBuilder in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

Stop-APSFleet

Die folgenden Codebeispiele zeigen, wie Stop-APSFleet verwendet wird.

Tools für PowerShell V4

Beispiel 1: In diesem Beispiel wird eine Flotte gestoppt

Stop-APSFleet -Name PowershellFleet

• Weitere API-Informationen finden Sie unter StopFleet in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

Stop-APSImageBuilder

Die folgenden Codebeispiele zeigen, wie Stop-APSImageBuilder verwendet wird.

Tools für PowerShell V4

Beispiel 1: In diesem Beispiel wird ein ImageBuilder gestoppt

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

• Weitere API-Informationen finden Sie unter StopImageBuilder in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

Unregister-APSFleet

Die folgenden Codebeispiele zeigen, wie Unregister-APSFleet verwendet wird.

Tools für PowerShell V4

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

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

• Weitere API-Informationen finden Sie unter DisassociateFleet in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

Unregister-APSUserStackBatch

Die folgenden Codebeispiele zeigen, wie Unregister-APSUserStackBatch verwendet wird.

Tools für PowerShell V4

Beispiel 1: In diesem Beispiel wird ein Benutzer aus einem zugewiesenen Stack entfernt

Unregister-APSUserStackBatch -UserStackAssociation @{AuthenticationType="USERPOOL";SendEmailNotification=$False;StackName="PowershellStack";UserName="[e-mail]"}

• Weitere API-Informationen finden Sie unter BatchDisassociateUserStack in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

Update-APSDirectoryConfig

Die folgenden Codebeispiele zeigen, wie Update-APSDirectoryConfig verwendet wird.

Tools für PowerShell V4

Beispiel 1: In diesem Beispiel wird die in AppStream erstellte Verzeichniskonfiguration aktualisiert

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

• Weitere API-Informationen finden Sie unter UpdateDirectoryConfig in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

Update-APSFleet

Die folgenden Codebeispiele zeigen, wie Update-APSFleet verwendet wird.

Tools für PowerShell V4

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

• Weitere API-Informationen finden Sie unter UpdateFleet in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

Update-APSImagePermission

Die folgenden Codebeispiele zeigen, wie Update-APSImagePermission verwendet wird.

Tools für PowerShell V4

Beispiel 1: In diesem Beispiel wird ein AppStream-Image mit einem anderen Konto geteilt

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

• Weitere API-Informationen finden Sie unter UpdateImagePermissions in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

Update-APSStack

Die folgenden Codebeispiele zeigen, wie Update-APSStack verwendet wird.

Tools für PowerShell V4

Beispiel 1: In diesem Beispiel werden die Persistenz der Anwendungseinstellungen und die Basisordner auf einem Stack aktualisiert (aktiviert)

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}

• Weitere API-Informationen finden Sie unter UpdateStack in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).