View a markdown version of this page

WorkSpaces Exemples d'applications utilisant Tools for PowerShell V5 - AWS Exemples de code SDK
Actions

D'autres exemples de AWS SDK sont disponibles dans le référentiel AWS Doc SDK Examples GitHub .

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

WorkSpaces Exemples d'applications utilisant Tools for PowerShell V5

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide de la Outils AWS pour PowerShell V5 avec WorkSpaces Applications.

Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.

Rubriques

Actions

L'exemple de code suivant montre comment utiliserAdd-APSResourceTag.

Outils pour PowerShell V5

Exemple 1 : Cet exemple ajoute une balise de ressource à la AppStream ressource 

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

Sortie :

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

  • Pour plus de détails sur l'API, consultez TagResource la section Outils AWS pour PowerShell Cmdlet Reference (V5).

L'exemple de code suivant montre comment utiliserCopy-APSImage.

Outils pour PowerShell V5

Exemple 1 : cet exemple copie une image dans une autre région

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

Sortie :

TestImageCopy

  • Pour plus de détails sur l'API, consultez CopyImage la section Référence des Outils AWS pour PowerShell applets de commande (V5).

L'exemple de code suivant montre comment utiliserDisable-APSUSer.

Outils pour PowerShell V5

Exemple 1 : cet exemple désactive un utilisateur dans USERPOOL

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

  • Pour plus de détails sur l'API, consultez DisableUser la section Référence des Outils AWS pour PowerShell applets de commande (V5).

L'exemple de code suivant montre comment utiliserEnable-APSUser.

Outils pour PowerShell V5

Exemple 1 : cet exemple active un utilisateur désactivé dans USERPOOL

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

  • Pour plus de détails sur l'API, consultez EnableUser la section Outils AWS pour PowerShell Cmdlet Reference (V5).

L'exemple de code suivant montre comment utiliserGet-APSAssociatedFleetList.

Outils pour PowerShell V5

Exemple 1 : cet exemple affiche la flotte associée à une pile

Get-APSAssociatedFleetList -StackName PowershellStack

Sortie :

PowershellFleet

  • Pour plus de détails sur l'API, consultez ListAssociatedFleets la section Référence des Outils AWS pour PowerShell applets de commande (V5).

L'exemple de code suivant montre comment utiliserGet-APSAssociatedStackList.

Outils pour PowerShell V5

Exemple 1 : cet exemple affiche la pile associée à une flotte

Get-APSAssociatedStackList -FleetName PowershellFleet

Sortie :

PowershellStack

  • Pour plus de détails sur l'API, consultez ListAssociatedStacks la section Référence des Outils AWS pour PowerShell applets de commande (V5).

L'exemple de code suivant montre comment utiliserGet-APSDirectoryConfigList.

Outils pour PowerShell V5

Exemple 1 : Cet exemple affiche les configurations de répertoire créées dans AppStream 

Get-APSDirectoryConfigList | Select DirectoryName, OrganizationalUnitDistinguishedNames, CreatedTime

Sortie :

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

  • Pour plus de détails sur l'API, consultez DescribeDirectoryConfigs la section Outils AWS pour PowerShell Cmdlet Reference (V5).

L'exemple de code suivant montre comment utiliserGet-APSFleetList.

Outils pour PowerShell V5

Exemple 1 : cet exemple affiche les détails d’une flotte

Get-APSFleetList -Name Test

Sortie :

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

  • Pour plus de détails sur l'API, consultez DescribeFleets la section Référence des Outils AWS pour PowerShell applets de commande (V5).

L'exemple de code suivant montre comment utiliserGet-APSImageBuilderList.

Outils pour PowerShell V5

Exemple 1 : Cet exemple affiche les détails d'un ImageBuilder 

Get-APSImageBuilderList -Name TestImage

Sortie :

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

  • Pour plus de détails sur l'API, consultez DescribeImageBuilders la section Outils AWS pour PowerShell Cmdlet Reference (V5).

L'exemple de code suivant montre comment utiliserGet-APSImageList.

Outils pour PowerShell V5

Exemple 1 : cet exemple affiche des AppStream images privées 

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

Sortie :

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

  • Pour plus de détails sur l'API, consultez DescribeImages la section Outils AWS pour PowerShell Cmdlet Reference (V5).

L'exemple de code suivant montre comment utiliserGet-APSImagePermission.

Outils pour PowerShell V5

Exemple 1 : Cet exemple affiche les autorisations d'image sur une AppStream image partagée 

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

Sortie :

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

  • Pour plus de détails sur l'API, consultez DescribeImagePermissions la section Outils AWS pour PowerShell Cmdlet Reference (V5).

L'exemple de code suivant montre comment utiliserGet-APSSessionList.

Outils pour PowerShell V5

Exemple 1 : cet exemple affiche la liste des sessions d’une flotte

Get-APSSessionList -FleetName PowershellFleet -StackName PowershellStack

Sortie :

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

  • Pour plus de détails sur l'API, consultez DescribeSessions la section Référence des Outils AWS pour PowerShell applets de commande (V5).

L'exemple de code suivant montre comment utiliserGet-APSStackList.

Outils pour PowerShell V5

Exemple 1 : Cet exemple affiche la liste de AppStream Stack 

Get-APSStackList | Select DisplayName, Arn, CreatedTime

Sortie :

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

  • Pour plus de détails sur l'API, consultez DescribeStacks la section Outils AWS pour PowerShell Cmdlet Reference (V5).

L'exemple de code suivant montre comment utiliserGet-APSTagsForResourceList.

Outils pour PowerShell V5

Exemple 1 : cet exemple affiche les balises d'une AppStream ressource 

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

Sortie :

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

  • Pour plus de détails sur l'API, consultez ListTagsForResource la section Outils AWS pour PowerShell Cmdlet Reference (V5).

L'exemple de code suivant montre comment utiliserGet-APSUsageReportSubscription.

Outils pour PowerShell V5

Exemple 1 : cet exemple affiche les détails AppStreamUsageReport de configuration 

Get-APSUsageReportSubscription

Sortie :

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

L'exemple de code suivant montre comment utiliserGet-APSUser.

Outils pour PowerShell V5

Exemple 1 : cet exemple affiche la liste des utilisateurs dont le statut est activé

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

Sortie :

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

  • Pour plus de détails sur l'API, consultez DescribeUsers la section Référence des Outils AWS pour PowerShell applets de commande (V5).

L'exemple de code suivant montre comment utiliserGet-APSUserStackAssociation.

Outils pour PowerShell V5

Exemple 1 : cet exemple affiche la liste des utilisateurs assignés à une pile

Get-APSUserStackAssociation -StackName PowershellStack

Sortie :

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

L'exemple de code suivant montre comment utiliserNew-APSDirectoryConfig.

Outils pour PowerShell V5

Exemple 1 : Cet exemple crée une configuration de répertoire dans AppStream 

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

Sortie :

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

  • Pour plus de détails sur l'API, consultez CreateDirectoryConfig la section Outils AWS pour PowerShell Cmdlet Reference (V5).

L'exemple de code suivant montre comment utiliserNew-APSFleet.

Outils pour PowerShell V5

Exemple 1 : Cet exemple crée une nouvelle 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

Sortie :

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

  • Pour plus de détails sur l'API, consultez CreateFleet la section Outils AWS pour PowerShell Cmdlet Reference (V5).

L'exemple de code suivant montre comment utiliserNew-APSImageBuilder.

Outils pour PowerShell V5

Exemple 1 : Cet exemple crée un générateur d'images dans 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

Sortie :

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

  • Pour plus de détails sur l'API, consultez CreateImageBuilder la section Outils AWS pour PowerShell Cmdlet Reference (V5).

L'exemple de code suivant montre comment utiliserNew-APSImageBuilderStreamingURL.

Outils pour PowerShell V5

Exemple 1 : Cet exemple crée une URL de ImageBuilder diffusion avec une validité de 2 heures 

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

Sortie :

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

L'exemple de code suivant montre comment utiliserNew-APSStack.

Outils pour PowerShell V5

Exemple 1 : Cet exemple crée une nouvelle AppStream pile 

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

Sortie :

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}

  • Pour plus de détails sur l'API, consultez CreateStack la section Outils AWS pour PowerShell Cmdlet Reference (V5).

L'exemple de code suivant montre comment utiliserNew-APSStreamingURL.

Outils pour PowerShell V5

Exemple 1 : cet exemple crée une URL de streaming de pile

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

Sortie :

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

  • Pour plus de détails sur l'API, consultez CreateStreaming l'URL dans Outils AWS pour PowerShell Cmdlet Reference (V5).

L'exemple de code suivant montre comment utiliserNew-APSUsageReportSubscription.

Outils pour PowerShell V5

Exemple 1 : Cet exemple active les rapports AppStream d'utilisation 

New-APSUsageReportSubscription

Sortie :

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

L'exemple de code suivant montre comment utiliserNew-APSUser.

Outils pour PowerShell V5

Exemple 1 : cet exemple crée un utilisateur dans USERPOOL

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

Sortie :

Test@lab.com

  • Pour plus de détails sur l'API, consultez CreateUser la section Référence des Outils AWS pour PowerShell applets de commande (V5).

L'exemple de code suivant montre comment utiliserRegister-APSFleet.

Outils pour PowerShell V5

Exemple 1 : cet exemple enregistre une flotte avec une pile

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

  • Pour plus de détails sur l'API, consultez AssociateFleet la section Référence des Outils AWS pour PowerShell applets de commande (V5).

L'exemple de code suivant montre comment utiliserRegister-APSUserStackBatch.

Outils pour PowerShell V5

Exemple 1 : cet exemple attribue une pile à un utilisateur dans USERPOOL

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

  • Pour plus de détails sur l'API, consultez BatchAssociateUserStack la section Référence des Outils AWS pour PowerShell applets de commande (V5).

L'exemple de code suivant montre comment utiliserRemove-APSDirectoryConfig.

Outils pour PowerShell V5

Exemple 1 : cet exemple supprime la configuration AppStream du répertoire 

Remove-APSDirectoryConfig -DirectoryName contoso.com

Sortie :

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

  • Pour plus de détails sur l'API, consultez DeleteDirectoryConfig la section Outils AWS pour PowerShell Cmdlet Reference (V5).

L'exemple de code suivant montre comment utiliserRemove-APSFleet.

Outils pour PowerShell V5

Exemple 1 : Cet exemple supprime et supprime une flotte AppStream 

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

Sortie :

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

  • Pour plus de détails sur l'API, consultez DeleteFleet la section Outils AWS pour PowerShell Cmdlet Reference (V5).

L'exemple de code suivant montre comment utiliserRemove-APSImage.

Outils pour PowerShell V5

Exemple 1 : cet exemple supprime une image

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

Sortie :

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

  • Pour plus de détails sur l'API, consultez DeleteImage la section Référence des Outils AWS pour PowerShell applets de commande (V5).

L'exemple de code suivant montre comment utiliserRemove-APSImageBuilder.

Outils pour PowerShell V5

Exemple 1 : Cet exemple supprime un ImageBuilder 

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

Sortie :

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

  • Pour plus de détails sur l'API, consultez DeleteImageBuilder la section Outils AWS pour PowerShell Cmdlet Reference (V5).

L'exemple de code suivant montre comment utiliserRemove-APSImagePermission.

Outils pour PowerShell V5

Exemple 1 : cet exemple supprime les autorisations d’une image

Remove-APSImagePermission -Name Powershell -SharedAccountId 123456789012

Sortie :

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

  • Pour plus de détails sur l'API, consultez DeleteImagePermissions la section Outils AWS pour PowerShell Cmdlet Reference (V5).

L'exemple de code suivant montre comment utiliserRemove-APSResourceTag.

Outils pour PowerShell V5

Exemple 1 : Cet exemple supprime une balise de ressource de la AppStream ressource 

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

Sortie :

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

  • Pour plus de détails sur l'API, consultez UntagResource la section Outils AWS pour PowerShell Cmdlet Reference (V5).

L'exemple de code suivant montre comment utiliserRemove-APSStack.

Outils pour PowerShell V5

Exemple 1 : cet exemple supprime une pile

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

Sortie :

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

  • Pour plus de détails sur l'API, consultez DeleteStack la section Référence des Outils AWS pour PowerShell applets de commande (V5).

L'exemple de code suivant montre comment utiliserRemove-APSUsageReportSubscription.

Outils pour PowerShell V5

Exemple 1 : cet exemple désactive l'abonnement au rapport AppStream d'utilisation 

Remove-APSUsageReportSubscription

Sortie :

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

L'exemple de code suivant montre comment utiliserRemove-APSUser.

Outils pour PowerShell V5

Exemple 1 : cet exemple supprime un utilisateur de USERPOOL

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

Sortie :

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

  • Pour plus de détails sur l'API, consultez DeleteUser la section Référence des Outils AWS pour PowerShell applets de commande (V5).

L'exemple de code suivant montre comment utiliserRevoke-APSSession.

Outils pour PowerShell V5

Exemple 1 : cet exemple révoque une session pour Fleet AppStream 

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

  • Pour plus de détails sur l'API, consultez ExpireSession la section Outils AWS pour PowerShell Cmdlet Reference (V5).

L'exemple de code suivant montre comment utiliserStart-APSFleet.

Outils pour PowerShell V5

Exemple 1 : cet exemple démarre une flotte

Start-APSFleet -Name PowershellFleet

  • Pour plus de détails sur l'API, consultez StartFleet la section Référence des Outils AWS pour PowerShell applets de commande (V5).

L'exemple de code suivant montre comment utiliserStart-APSImageBuilder.

Outils pour PowerShell V5

Exemple 1 : Cet exemple démarre un ImageBuilder 

Start-APSImageBuilder -Name TestImage

Sortie :

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

  • Pour plus de détails sur l'API, consultez StartImageBuilder la section Outils AWS pour PowerShell Cmdlet Reference (V5).

L'exemple de code suivant montre comment utiliserStop-APSFleet.

Outils pour PowerShell V5

Exemple 1 : cet exemple arrête une flotte

Stop-APSFleet -Name PowershellFleet

  • Pour plus de détails sur l'API, consultez StopFleet la section Référence des Outils AWS pour PowerShell applets de commande (V5).

L'exemple de code suivant montre comment utiliserStop-APSImageBuilder.

Outils pour PowerShell V5

Exemple 1 : Cet exemple arrête un ImageBuilder 

Stop-APSImageBuilder -Name TestImage

Sortie :

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

  • Pour plus de détails sur l'API, consultez StopImageBuilder la section Outils AWS pour PowerShell Cmdlet Reference (V5).

L'exemple de code suivant montre comment utiliserUnregister-APSFleet.

Outils pour PowerShell V5

Exemple 1 : cet exemple annule l’enregistrement d’une flotte à partir d’une pile

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

  • Pour plus de détails sur l'API, consultez DisassociateFleet la section Référence des Outils AWS pour PowerShell applets de commande (V5).

L'exemple de code suivant montre comment utiliserUnregister-APSUserStackBatch.

Outils pour PowerShell V5

Exemple 1 : cet exemple supprime un utilisateur d’une pile assignée

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

  • Pour plus de détails sur l'API, consultez BatchDisassociateUserStack la section Référence des Outils AWS pour PowerShell applets de commande (V5).

L'exemple de code suivant montre comment utiliserUpdate-APSDirectoryConfig.

Outils pour PowerShell V5

Exemple 1 : Cet exemple met à jour la configuration du répertoire créée dans AppStream 

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

Sortie :

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

  • Pour plus de détails sur l'API, consultez UpdateDirectoryConfig la section Outils AWS pour PowerShell Cmdlet Reference (V5).

L'exemple de code suivant montre comment utiliserUpdate-APSFleet.

Outils pour PowerShell V5

Exemple 1 : cet exemple met à jour les propriétés d’une flotte

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

Sortie :

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

  • Pour plus de détails sur l'API, consultez UpdateFleet la section Référence des Outils AWS pour PowerShell applets de commande (V5).

L'exemple de code suivant montre comment utiliserUpdate-APSImagePermission.

Outils pour PowerShell V5

Exemple 1 : Cet exemple partage une AppStream image avec un autre compte 

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

  • Pour plus de détails sur l'API, consultez UpdateImagePermissions la section Outils AWS pour PowerShell Cmdlet Reference (V5).

L'exemple de code suivant montre comment utiliserUpdate-APSStack.

Outils pour PowerShell V5

Exemple 1 : cet exemple met à jour (active) la persistance des paramètres de l’application et les dossiers de base sur une pile

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

Sortie :

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}

  • Pour plus de détails sur l'API, consultez UpdateStack la section Référence des Outils AWS pour PowerShell applets de commande (V5).