View a markdown version of this page

WorkSpaces Anwendungsbeispiele, die Tools für V5 verwenden PowerShell - AWS SDK-Codebeispiele
Aktionen

Weitere AWS SDK-Beispiele sind im AWS Doc SDK Examples GitHub Repo verfügbar.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

WorkSpaces Anwendungsbeispiele, die Tools für V5 verwenden PowerShell

Die folgenden Codebeispiele zeigen Ihnen, wie Sie Aktionen ausführen und allgemeine Szenarien implementieren, indem Sie AWS -Tools für PowerShell V5 mit WorkSpaces Anwendungen verwenden.

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen 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.

Themen

Aktionen

Das folgende Codebeispiel zeigt die VerwendungAdd-APSResourceTag.

Tools für PowerShell V5

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

  • API-Details finden Sie TagResource in der AWS -Tools für PowerShell Cmdlet-Referenz (V5).

Das folgende Codebeispiel zeigt die Verwendung. Copy-APSImage

Tools für PowerShell V5

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

  • API-Details finden Sie CopyImage in der AWS -Tools für PowerShell Cmdlet-Referenz (V5).

Das folgende Codebeispiel zeigt die Verwendung. Disable-APSUSer

Tools für PowerShell V5

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

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

  • API-Details finden Sie DisableUser in der AWS -Tools für PowerShell Cmdlet-Referenz (V5).

Das folgende Codebeispiel zeigt die Verwendung. Enable-APSUser

Tools für PowerShell V5

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

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

  • API-Details finden Sie EnableUser in der AWS -Tools für PowerShell Cmdlet-Referenz (V5).

Das folgende Codebeispiel zeigt die Verwendung. Get-APSAssociatedFleetList

Tools für PowerShell V5

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

Get-APSAssociatedFleetList -StackName PowershellStack

Ausgabe:

PowershellFleet

Das folgende Codebeispiel zeigt die Verwendung. Get-APSAssociatedStackList

Tools für PowerShell V5

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

Get-APSAssociatedStackList -FleetName PowershellFleet

Ausgabe:

PowershellStack

Das folgende Codebeispiel zeigt die Verwendung. Get-APSDirectoryConfigList

Tools für PowerShell V5

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

Das folgende Codebeispiel zeigt die Verwendung. Get-APSFleetList

Tools für PowerShell V5

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

  • API-Details finden Sie DescribeFleets in der AWS -Tools für PowerShell Cmdlet-Referenz (V5).

Das folgende Codebeispiel zeigt die Verwendung. Get-APSImageBuilderList

Tools für PowerShell V5

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

Das folgende Codebeispiel zeigt die Verwendung. Get-APSImageList

Tools für PowerShell V5

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

  • API-Details finden Sie DescribeImages in der AWS -Tools für PowerShell Cmdlet-Referenz (V5).

Das folgende Codebeispiel zeigt die Verwendung. Get-APSImagePermission

Tools für PowerShell V5

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

Das folgende Codebeispiel zeigt die Verwendung. Get-APSSessionList

Tools für PowerShell V5

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

  • API-Details finden Sie DescribeSessions in der AWS -Tools für PowerShell Cmdlet-Referenz (V5).

Das folgende Codebeispiel zeigt die Verwendung. Get-APSStackList

Tools für PowerShell V5

Beispiel 1: In diesem Beispiel wird eine Liste von AppStream Stacks 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

  • API-Details finden Sie DescribeStacks in der AWS -Tools für PowerShell Cmdlet-Referenz (V5).

Das folgende Codebeispiel zeigt die Verwendung. Get-APSTagsForResourceList

Tools für PowerShell V5

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

Das folgende Codebeispiel zeigt die Verwendung. Get-APSUsageReportSubscription

Tools für PowerShell V5

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

Das folgende Codebeispiel zeigt die Verwendung. Get-APSUser

Tools für PowerShell V5

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
--------                   ------------------ -------
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-Details finden Sie DescribeUsers in der AWS -Tools für PowerShell Cmdlet-Referenz (V5).

Das folgende Codebeispiel zeigt die Verwendung. Get-APSUserStackAssociation

Tools für PowerShell V5

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

Das folgende Codebeispiel zeigt die VerwendungNew-APSDirectoryConfig.

Tools für PowerShell V5

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

Das folgende Codebeispiel zeigt die Verwendung. New-APSFleet

Tools für PowerShell V5

Beispiel 1: Dieses Beispiel erstellt eine neue Flotte 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

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

  • API-Details finden Sie CreateFleet in der AWS -Tools für PowerShell Cmdlet-Referenz (V5).

Das folgende Codebeispiel zeigt die Verwendung. New-APSImageBuilder

Tools für PowerShell V5

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

Das folgende Codebeispiel zeigt die Verwendung. New-APSImageBuilderStreamingURL

Tools für PowerShell V5

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

Das folgende Codebeispiel zeigt die Verwendung. New-APSStack

Tools für PowerShell V5

Beispiel 1: Dieses Beispiel erstellt einen neuen Stack AppStream 

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}

  • API-Details finden Sie CreateStack in der AWS -Tools für PowerShell Cmdlet-Referenz (V5).

Das folgende Codebeispiel zeigt die Verwendung. New-APSStreamingURL

Tools für PowerShell V5

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

  • API-Details finden Sie unter CreateStreaming URL in der AWS -Tools für PowerShell Cmdlet-Referenz (V5).

Das folgende Codebeispiel zeigt die Verwendung. New-APSUsageReportSubscription

Tools für PowerShell V5

Beispiel 1: Dieses Beispiel aktiviert AppStream Nutzungsberichte 

New-APSUsageReportSubscription

Ausgabe:

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

Das folgende Codebeispiel zeigt die Verwendung. New-APSUser

Tools für PowerShell V5

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

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

Ausgabe:

Test@lab.com

  • API-Details finden Sie CreateUser in der AWS -Tools für PowerShell Cmdlet-Referenz (V5).

Das folgende Codebeispiel zeigt die Verwendung. Register-APSFleet

Tools für PowerShell V5

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

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

  • API-Details finden Sie AssociateFleet in der AWS -Tools für PowerShell Cmdlet-Referenz (V5).

Das folgende Codebeispiel zeigt die Verwendung. Register-APSUserStackBatch

Tools für PowerShell V5

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

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

Das folgende Codebeispiel zeigt die Verwendung. Remove-APSDirectoryConfig

Tools für PowerShell V5

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

Das folgende Codebeispiel zeigt die Verwendung. Remove-APSFleet

Tools für PowerShell V5

Beispiel 1: Dieses Beispiel entfernt, 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

  • API-Details finden Sie DeleteFleet in der AWS -Tools für PowerShell Cmdlet-Referenz (V5).

Das folgende Codebeispiel zeigt die Verwendung. Remove-APSImage

Tools für PowerShell V5

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

  • API-Details finden Sie DeleteImage in der AWS -Tools für PowerShell Cmdlet-Referenz (V5).

Das folgende Codebeispiel zeigt die Verwendung. Remove-APSImageBuilder

Tools für PowerShell V5

Beispiel 1: Dieses Beispiel löscht eine 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

Das folgende Codebeispiel zeigt die Verwendung. Remove-APSImagePermission

Tools für PowerShell V5

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

Das folgende Codebeispiel zeigt die Verwendung. Remove-APSResourceTag

Tools für PowerShell V5

Beispiel 1: Dieses Beispiel entfernt ein Ressourcen-Tag aus der AppStream Ressource 

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

  • API-Details finden Sie UntagResource in der AWS -Tools für PowerShell Cmdlet-Referenz (V5).

Das folgende Codebeispiel zeigt die Verwendung. Remove-APSStack

Tools für PowerShell V5

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

  • API-Details finden Sie DeleteStack in der AWS -Tools für PowerShell Cmdlet-Referenz (V5).

Das folgende Codebeispiel zeigt die Verwendung. Remove-APSUsageReportSubscription

Tools für PowerShell V5

Beispiel 1: Dieses Beispiel deaktiviert das Abonnement für AppStream Nutzungsberichte 

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

Das folgende Codebeispiel zeigt die Verwendung. Remove-APSUser

Tools für PowerShell V5

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

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

  • API-Details finden Sie DeleteUser in der AWS -Tools für PowerShell Cmdlet-Referenz (V5).

Das folgende Codebeispiel zeigt die Verwendung. Revoke-APSSession

Tools für PowerShell V5

Beispiel 1: Dieses Beispiel widerruft eine Sitzung mit fleet AppStream 

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

  • API-Details finden Sie ExpireSession in der AWS -Tools für PowerShell Cmdlet-Referenz (V5).

Das folgende Codebeispiel zeigt die Verwendung. Start-APSFleet

Tools für PowerShell V5

Beispiel 1: In diesem Beispiel wird eine Flotte gestartet

Start-APSFleet -Name PowershellFleet

  • API-Details finden Sie StartFleet in der AWS -Tools für PowerShell Cmdlet-Referenz (V5).

Das folgende Codebeispiel zeigt die Verwendung. Start-APSImageBuilder

Tools für PowerShell V5

Beispiel 1: Dieses Beispiel startet eine 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

  • API-Details finden Sie StartImageBuilder in der AWS -Tools für PowerShell Cmdlet-Referenz (V5).

Das folgende Codebeispiel zeigt die Verwendung. Stop-APSFleet

Tools für PowerShell V5

Beispiel 1: In diesem Beispiel wird eine Flotte gestoppt

Stop-APSFleet -Name PowershellFleet

  • API-Details finden Sie StopFleet in der AWS -Tools für PowerShell Cmdlet-Referenz (V5).

Das folgende Codebeispiel zeigt die Verwendung. Stop-APSImageBuilder

Tools für PowerShell V5

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

  • API-Details finden Sie StopImageBuilder in der AWS -Tools für PowerShell Cmdlet-Referenz (V5).

Das folgende Codebeispiel zeigt die Verwendung. Unregister-APSFleet

Tools für PowerShell V5

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

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

  • API-Details finden Sie DisassociateFleet in der AWS -Tools für PowerShell Cmdlet-Referenz (V5).

Das folgende Codebeispiel zeigt die Verwendung. Unregister-APSUserStackBatch

Tools für PowerShell V5

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

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

Das folgende Codebeispiel zeigt die Verwendung. Update-APSDirectoryConfig

Tools für PowerShell V5

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

Das folgende Codebeispiel zeigt die Verwendung. Update-APSFleet

Tools für PowerShell V5

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

  • API-Details finden Sie UpdateFleet in der AWS -Tools für PowerShell Cmdlet-Referenz (V5).

Das folgende Codebeispiel zeigt die Verwendung. Update-APSImagePermission

Tools für PowerShell V5

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

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

Das folgende Codebeispiel zeigt die Verwendung. Update-APSStack

Tools für PowerShell V5

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}

  • API-Details finden Sie UpdateStack in der AWS -Tools für PowerShell Cmdlet-Referenz (V5).