La version 5 (V5) du Outils AWS pour PowerShell est sortie \$1
Pour plus d'informations sur les modifications majeures et la migration de vos applications, consultez la [rubrique relative à la migration](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html).
[https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html)
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 version 5 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.
**Topics**
+ [Actions](#actions)
## Actions
### `Add-APSResourceTag`
L'exemple de code suivant montre comment utiliser`Add-APSResourceTag`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple ajoute une étiquette 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, reportez-vous [TagResource](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Copy-APSImage`
L'exemple de code suivant montre comment utiliser`Copy-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, reportez-vous [CopyImage](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Disable-APSUSer`
L'exemple de code suivant montre comment utiliser`Disable-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, reportez-vous [DisableUser](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Enable-APSUser`
L'exemple de code suivant montre comment utiliser`Enable-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, reportez-vous [EnableUser](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-APSAssociatedFleetList`
L'exemple de code suivant montre comment utiliser`Get-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, reportez-vous [ListAssociatedFleets](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-APSAssociatedStackList`
L'exemple de code suivant montre comment utiliser`Get-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, reportez-vous [ListAssociatedStacks](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-APSDirectoryConfigList`
L'exemple de code suivant montre comment utiliser`Get-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, reportez-vous [DescribeDirectoryConfigs](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-APSFleetList`
L'exemple de code suivant montre comment utiliser`Get-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, reportez-vous [DescribeFleets](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-APSImageBuilderList`
L'exemple de code suivant montre comment utiliser`Get-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, reportez-vous [DescribeImageBuilders](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-APSImageList`
L'exemple de code suivant montre comment utiliser`Get-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, reportez-vous [DescribeImages](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-APSImagePermission`
L'exemple de code suivant montre comment utiliser`Get-APSImagePermission`.
**Outils pour PowerShell V5**
**Exemple 1 : Cet exemple affiche les autorisations relatives aux images 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, reportez-vous [DescribeImagePermissions](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-APSSessionList`
L'exemple de code suivant montre comment utiliser`Get-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, reportez-vous [DescribeSessions](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-APSStackList`
L'exemple de code suivant montre comment utiliser`Get-APSStackList`.
**Outils pour PowerShell V5**
**Exemple 1 : Cet exemple affiche la liste des 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, reportez-vous [DescribeStacks](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-APSTagsForResourceList`
L'exemple de code suivant montre comment utiliser`Get-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, reportez-vous [ListTagsForResource](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-APSUsageReportSubscription`
L'exemple de code suivant montre comment utiliser`Get-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 {}
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeUsageReportSubscriptions](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-APSUser`
L'exemple de code suivant montre comment utiliser`Get-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, reportez-vous [DescribeUsers](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-APSUserStackAssociation`
L'exemple de code suivant montre comment utiliser`Get-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
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeUserStackAssociations](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `New-APSDirectoryConfig`
L'exemple de code suivant montre comment utiliser`New-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, reportez-vous [CreateDirectoryConfig](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `New-APSFleet`
L'exemple de code suivant montre comment utiliser`New-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, reportez-vous [CreateFleet](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `New-APSImageBuilder`
L'exemple de code suivant montre comment utiliser`New-APSImageBuilder`.
**Outils pour PowerShell V5**
**Exemple 1 : Cet exemple crée un Image Builder 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, reportez-vous [CreateImageBuilder](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `New-APSImageBuilderStreamingURL`
L'exemple de code suivant montre comment utiliser`New-APSImageBuilderStreamingURL`.
**Outils pour PowerShell V5**
**Exemple 1 : Cet exemple crée une URL de ImageBuilder diffusion d'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
```
+ Pour plus de détails sur l'API, voir [CreateImageBuilderStreamingURL](https://docs.aws.amazon.com/powershell/v5/reference) dans la *référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `New-APSStack`
L'exemple de code suivant montre comment utiliser`New-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, reportez-vous [CreateStack](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `New-APSStreamingURL`
L'exemple de code suivant montre comment utiliser`New-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, voir [CreateStreamingURL](https://docs.aws.amazon.com/powershell/v5/reference) dans la *référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `New-APSUsageReportSubscription`
L'exemple de code suivant montre comment utiliser`New-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
```
+ Pour plus de détails sur l'API, reportez-vous [CreateUsageReportSubscription](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `New-APSUser`
L'exemple de code suivant montre comment utiliser`New-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, reportez-vous [CreateUser](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Register-APSFleet`
L'exemple de code suivant montre comment utiliser`Register-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, reportez-vous [AssociateFleet](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Register-APSUserStackBatch`
L'exemple de code suivant montre comment utiliser`Register-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, reportez-vous [BatchAssociateUserStack](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Remove-APSDirectoryConfig`
L'exemple de code suivant montre comment utiliser`Remove-APSDirectoryConfig`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple supprime la configuration du AppStream 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, reportez-vous [DeleteDirectoryConfig](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Remove-APSFleet`
L'exemple de code suivant montre comment utiliser`Remove-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, reportez-vous [DeleteFleet](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Remove-APSImage`
L'exemple de code suivant montre comment utiliser`Remove-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, reportez-vous [DeleteImage](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Remove-APSImageBuilder`
L'exemple de code suivant montre comment utiliser`Remove-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, reportez-vous [DeleteImageBuilder](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Remove-APSImagePermission`
L'exemple de code suivant montre comment utiliser`Remove-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, reportez-vous [DeleteImagePermissions](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Remove-APSResourceTag`
L'exemple de code suivant montre comment utiliser`Remove-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, reportez-vous [UntagResource](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Remove-APSStack`
L'exemple de code suivant montre comment utiliser`Remove-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, reportez-vous [DeleteStack](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Remove-APSUsageReportSubscription`
L'exemple de code suivant montre comment utiliser`Remove-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
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteUsageReportSubscription](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Remove-APSUser`
L'exemple de code suivant montre comment utiliser`Remove-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, reportez-vous [DeleteUser](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Revoke-APSSession`
L'exemple de code suivant montre comment utiliser`Revoke-APSSession`.
**Outils pour PowerShell V5**
**Exemple 1 : Cet exemple révoque une session dans le AppStream parc**
```
Revoke-APSSession -SessionId 6cd2f9a3-f948-4aa1-8014-8a7dcde14877
```
+ Pour plus de détails sur l'API, reportez-vous [ExpireSession](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Start-APSFleet`
L'exemple de code suivant montre comment utiliser`Start-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, reportez-vous [StartFleet](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Start-APSImageBuilder`
L'exemple de code suivant montre comment utiliser`Start-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, reportez-vous [StartImageBuilder](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Stop-APSFleet`
L'exemple de code suivant montre comment utiliser`Stop-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, reportez-vous [StopFleet](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Stop-APSImageBuilder`
L'exemple de code suivant montre comment utiliser`Stop-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, reportez-vous [StopImageBuilder](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Unregister-APSFleet`
L'exemple de code suivant montre comment utiliser`Unregister-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, reportez-vous [DisassociateFleet](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Unregister-APSUserStackBatch`
L'exemple de code suivant montre comment utiliser`Unregister-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, reportez-vous [BatchDisassociateUserStack](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Update-APSDirectoryConfig`
L'exemple de code suivant montre comment utiliser`Update-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, reportez-vous [UpdateDirectoryConfig](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Update-APSFleet`
L'exemple de code suivant montre comment utiliser`Update-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, reportez-vous [UpdateFleet](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Update-APSImagePermission`
L'exemple de code suivant montre comment utiliser`Update-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, reportez-vous [UpdateImagePermissions](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Update-APSStack`
L'exemple de code suivant montre comment utiliser`Update-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, reportez-vous [UpdateStack](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.