Esempi per AppStream 2.0 con Strumenti per PowerShell V5

Gli esempi di codice seguenti mostrano come eseguire operazioni e implementare scenari comuni utilizzando AWS Strumenti per PowerShell V5 con AppStream 2.0.

Le azioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le operazioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.

Azioni

Add-APSResourceTag

L’esempio di codice seguente mostra come utilizzare Add-APSResourceTag.

Strumenti per PowerShell V5

Esempio 1: questo esempio aggiunge un tag di risorsa alla risorsa AppStream

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

Output:

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

• Per informazioni dettagliate sull’API, consulta TagResource nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Copy-APSImage

L’esempio di codice seguente mostra come utilizzare Copy-APSImage.

Strumenti per PowerShell V5

Esempio 1: questo esempio copia un’immagine in un’altra Regione

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

Output:

TestImageCopy

• Per informazioni dettagliate sull’API, consulta CopyImage nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Disable-APSUSer

L’esempio di codice seguente mostra come utilizzare Disable-APSUSer.

Strumenti per PowerShell V5

Esempio 1: questo esempio disabilita un utente in USERPOOL

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

• Per informazioni dettagliate sull’API, consulta DisableUser nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Enable-APSUser

L’esempio di codice seguente mostra come utilizzare Enable-APSUser.

Strumenti per PowerShell V5

Esempio 1: questo esempio abilita un utente disabilitato in USERPOOL

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

• Per informazioni dettagliate sull’API, consulta EnableUser nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-APSAssociatedFleetList

L’esempio di codice seguente mostra come utilizzare Get-APSAssociatedFleetList.

Strumenti per PowerShell V5

Esempio 1: questo esempio visualizza il parco associato a uno stack

Get-APSAssociatedFleetList -StackName PowershellStack

Output:

PowershellFleet

• Per informazioni dettagliate sull’API, consulta ListAssociatedFleets nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-APSAssociatedStackList

L’esempio di codice seguente mostra come utilizzare Get-APSAssociatedStackList.

Strumenti per PowerShell V5

Esempio 1: questo esempio visualizza lo stack associato a un parco

Get-APSAssociatedStackList -FleetName PowershellFleet

Output:

PowershellStack

• Per informazioni dettagliate sull’API, consulta ListAssociatedStacks nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-APSDirectoryConfigList

L’esempio di codice seguente mostra come utilizzare Get-APSDirectoryConfigList.

Strumenti per PowerShell V5

Esempio 1: questo esempio visualizza le configurazioni di directory create in AppStream

Get-APSDirectoryConfigList | Select DirectoryName, OrganizationalUnitDistinguishedNames, CreatedTime

Output:

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

• Per informazioni dettagliate sull’API, consulta DescribeDirectoryConfigs nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-APSFleetList

L’esempio di codice seguente mostra come utilizzare Get-APSFleetList.

Strumenti per PowerShell V5

Esempio 1: questo esempio visualizza i dettagli di un parco

Get-APSFleetList -Name Test

Output:

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

• Per informazioni dettagliate sull’API, consulta DescribeFleets nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-APSImageBuilderList

L’esempio di codice seguente mostra come utilizzare Get-APSImageBuilderList.

Strumenti per PowerShell V5

Esempio 1: questo esempio visualizza i dettagli di un oggetto ImageBuilder

Get-APSImageBuilderList -Name TestImage

Output:

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

• Per informazioni dettagliate sull’API, consulta DescribeImageBuilders nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-APSImageList

L’esempio di codice seguente mostra come utilizzare Get-APSImageList.

Strumenti per PowerShell V5

Esempio 1: questo esempio visualizza immagini AppStream private

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

Output:

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

• Per informazioni dettagliate sull’API, consulta DescribeImages nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-APSImagePermission

L’esempio di codice seguente mostra come utilizzare Get-APSImagePermission.

Strumenti per PowerShell V5

Esempio 1: questo esempio visualizza le autorizzazioni relative alle immagini per un’immagine AppStream condivisa

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

Output:

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

• Per informazioni dettagliate sull’API, consulta DescribeImagePermissions nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-APSSessionList

L’esempio di codice seguente mostra come utilizzare Get-APSSessionList.

Strumenti per PowerShell V5

Esempio 1: questo esempio visualizza l’elenco delle sessioni per un parco

Get-APSSessionList -FleetName PowershellFleet -StackName PowershellStack

Output:

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

• Per informazioni dettagliate sull’API, consulta DescribeSessions nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-APSStackList

L’esempio di codice seguente mostra come utilizzare Get-APSStackList.

Strumenti per PowerShell V5

Esempio 1: questo esempio visualizza l’elenco di stack AppStream

Get-APSStackList | Select DisplayName, Arn, CreatedTime

Output:

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

• Per informazioni dettagliate sull’API, consulta DescribeStacks nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-APSTagsForResourceList

L’esempio di codice seguente mostra come utilizzare Get-APSTagsForResourceList.

Strumenti per PowerShell V5

Esempio 1: questo esempio visualizza i tag di una risorsa AppStream

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

Output:

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

• Per informazioni dettagliate sull’API, consulta ListTagsForResource nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-APSUsageReportSubscription

L’esempio di codice seguente mostra come utilizzare Get-APSUsageReportSubscription.

Strumenti per PowerShell V5

Esempio 1: questo esempio visualizza i dettagli della configurazione di AppStreamUsageReport

Get-APSUsageReportSubscription

Output:

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

• Per informazioni dettagliate sull’API, consulta DescribeUsageReportSubscriptions nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-APSUser

L’esempio di codice seguente mostra come utilizzare Get-APSUser.

Strumenti per PowerShell V5

Esempio 1: questo esempio visualizza un elenco di utenti con stato abilitato

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

Output:

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

• Per informazioni dettagliate sull’API, consulta DescribeUsers nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-APSUserStackAssociation

L’esempio di codice seguente mostra come utilizzare Get-APSUserStackAssociation.

Strumenti per PowerShell V5

Esempio 1: questo esempio visualizza l’elenco degli utenti assegnati a uno stack

Get-APSUserStackAssociation -StackName PowershellStack

Output:

AuthenticationType SendEmailNotification StackName       UserName
------------------ --------------------- ---------       --------
USERPOOL           False                 PowershellStack [e-mail]
USERPOOL           False                 PowershellStack [e-mail]

• Per informazioni dettagliate sull’API, consulta DescribeUserStackAssociations nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

New-APSDirectoryConfig

L’esempio di codice seguente mostra come utilizzare New-APSDirectoryConfig.

Strumenti per PowerShell V5

Esempio 1: questo esempio crea una configurazione di directory in AppStream

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

Output:

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

• Per informazioni dettagliate sull’API, consulta CreateDirectoryConfig nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

New-APSFleet

L’esempio di codice seguente mostra come utilizzare New-APSFleet.

Strumenti per PowerShell V5

Esempio 1: questo esempio crea un nuovo parco 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

Output:

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

• Per informazioni dettagliate sull’API, consulta CreateFleet nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

New-APSImageBuilder

L’esempio di codice seguente mostra come utilizzare New-APSImageBuilder.

Strumenti per PowerShell V5

Esempio 1: questo esempio crea un oggetto 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

Output:

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

• Per informazioni dettagliate sull’API, consulta CreateImageBuilder nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

New-APSImageBuilderStreamingURL

L’esempio di codice seguente mostra come utilizzare New-APSImageBuilderStreamingURL.

Strumenti per PowerShell V5

Esempio 1: questo esempio crea un URL di streaming ImageBuilder con validità di 2 ore

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

Output:

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

• Per informazioni dettagliate sull’API, consulta CreateImageBuilderStreamingURL nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

New-APSStack

L’esempio di codice seguente mostra come utilizzare New-APSStack.

Strumenti per PowerShell V5

Esempio 1: questo esempio crea un nuovo stack AppStream

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

Output:

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}

• Per informazioni dettagliate sull’API, consulta CreateStack nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

New-APSStreamingURL

L’esempio di codice seguente mostra come utilizzare New-APSStreamingURL.

Strumenti per PowerShell V5

Esempio 1: questo esempio crea un URL di streaming per lo stack

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

Output:

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

• Per informazioni dettagliate sull’API, consulta CreateStreamingURL nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

New-APSUsageReportSubscription

L’esempio di codice seguente mostra come utilizzare New-APSUsageReportSubscription.

Strumenti per PowerShell V5

Esempio 1: questo esempio abilita i report sull’utilizzo di AppStream

New-APSUsageReportSubscription

Output:

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

• Per informazioni dettagliate sull’API, consulta CreateUsageReportSubscription nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

New-APSUser

L’esempio di codice seguente mostra come utilizzare New-APSUser.

Strumenti per PowerShell V5

Esempio 1: questo esempio crea un utente in USERPOOL

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

Output:

[e-mail]

• Per informazioni dettagliate sull’API, consulta CreateUser nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Register-APSFleet

L’esempio di codice seguente mostra come utilizzare Register-APSFleet.

Strumenti per PowerShell V5

Esempio 1: questo esempio registra il parco con uno stack

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

• Per informazioni dettagliate sull’API, consulta AssociateFleet nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Register-APSUserStackBatch

L’esempio di codice seguente mostra come utilizzare Register-APSUserStackBatch.

Strumenti per PowerShell V5

Esempio 1: questo esempio assegna lo stack a un utente in USERPOOL

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

• Per informazioni dettagliate sull’API, consulta BatchAssociateUserStack nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Remove-APSDirectoryConfig

L’esempio di codice seguente mostra come utilizzare Remove-APSDirectoryConfig.

Strumenti per PowerShell V5

Esempio 1: questo esempio rimuove la configurazione di directory di AppStream

Remove-APSDirectoryConfig -DirectoryName contoso.com

Output:

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

• Per informazioni dettagliate sull’API, consulta DeleteDirectoryConfig nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Remove-APSFleet

L’esempio di codice seguente mostra come utilizzare Remove-APSFleet.

Strumenti per PowerShell V5

Esempio 1: questo esempio rimuove le eliminazioni in un parco AppStream

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

Output:

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

• Per informazioni dettagliate sull’API, consulta DeleteFleet nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Remove-APSImage

L’esempio di codice seguente mostra come utilizzare Remove-APSImage.

Strumenti per PowerShell V5

Esempio 1: questo esempio elimina un’immagine

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

Output:

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

• Per informazioni dettagliate sull’API, consulta DeleteImage nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Remove-APSImageBuilder

L’esempio di codice seguente mostra come utilizzare Remove-APSImageBuilder.

Strumenti per PowerShell V5

Esempio 1: questo esempio elimina un oggetto ImageBuilder

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

Output:

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

• Per informazioni dettagliate sull’API, consulta DeleteImageBuilder nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Remove-APSImagePermission

L’esempio di codice seguente mostra come utilizzare Remove-APSImagePermission.

Strumenti per PowerShell V5

Esempio 1: questo esempio rimuove le autorizzazioni di un’immagine

Remove-APSImagePermission -Name Powershell -SharedAccountId 123456789012

Output:

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

• Per informazioni dettagliate sull’API, consulta DeleteImagePermissions nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Remove-APSResourceTag

L’esempio di codice seguente mostra come utilizzare Remove-APSResourceTag.

Strumenti per PowerShell V5

Esempio 1: questo esempio rimuove un tag di risorsa dalla risorsa AppStream

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

Output:

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

• Per informazioni dettagliate sull’API, consulta UntagResource nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Remove-APSStack

L’esempio di codice seguente mostra come utilizzare Remove-APSStack.

Strumenti per PowerShell V5

Esempio 1: questo esempio elimina uno stack

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

Output:

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

• Per informazioni dettagliate sull’API, consulta DeleteStack nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Remove-APSUsageReportSubscription

L’esempio di codice seguente mostra come utilizzare Remove-APSUsageReportSubscription.

Strumenti per PowerShell V5

Esempio 1: questo esempio disabilita l’abbonamento al report sull’utilizzo di AppStream

Remove-APSUsageReportSubscription

Output:

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

• Per informazioni dettagliate sull’API, consulta DeleteUsageReportSubscription nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Remove-APSUser

L’esempio di codice seguente mostra come utilizzare Remove-APSUser.

Strumenti per PowerShell V5

Esempio 1: questo esempio elimina un utente da USERPOOL

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

Output:

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

• Per informazioni dettagliate sull’API, consulta DeleteUser nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Revoke-APSSession

L’esempio di codice seguente mostra come utilizzare Revoke-APSSession.

Strumenti per PowerShell V5

Esempio 1: questo esempio revoca una sessione nel parco AppStream

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

• Per informazioni dettagliate sull’API, consulta ExpireSession nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Start-APSFleet

L’esempio di codice seguente mostra come utilizzare Start-APSFleet.

Strumenti per PowerShell V5

Esempio 1: questo esempio avvia un parco

Start-APSFleet -Name PowershellFleet

• Per informazioni dettagliate sull’API, consulta StartFleet nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Start-APSImageBuilder

L’esempio di codice seguente mostra come utilizzare Start-APSImageBuilder.

Strumenti per PowerShell V5

Esempio 1: questo esempio avvia un oggetto ImageBuilder

Start-APSImageBuilder -Name TestImage

Output:

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

• Per informazioni dettagliate sull’API, consulta StartImageBuilder nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Stop-APSFleet

L’esempio di codice seguente mostra come utilizzare Stop-APSFleet.

Strumenti per PowerShell V5

Esempio 1: questo esempio arresta un parco

Stop-APSFleet -Name PowershellFleet

• Per informazioni dettagliate sull’API, consulta StopFleet nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Stop-APSImageBuilder

L’esempio di codice seguente mostra come utilizzare Stop-APSImageBuilder.

Strumenti per PowerShell V5

Esempio 1: questo esempio arresta un oggetto ImageBuilder

Stop-APSImageBuilder -Name TestImage

Output:

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

• Per informazioni dettagliate sull’API, consulta StopImageBuilder nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Unregister-APSFleet

L’esempio di codice seguente mostra come utilizzare Unregister-APSFleet.

Strumenti per PowerShell V5

Esempio 1: questo esempio annulla la registrazione di un parco in uno stack

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

• Per informazioni dettagliate sull’API, consulta DisassociateFleet nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Unregister-APSUserStackBatch

L’esempio di codice seguente mostra come utilizzare Unregister-APSUserStackBatch.

Strumenti per PowerShell V5

Esempio 1: questo esempio rimuove un utente da uno stack assegnato

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

• Per informazioni dettagliate sull’API, consulta BatchDisassociateUserStack nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Update-APSDirectoryConfig

L’esempio di codice seguente mostra come utilizzare Update-APSDirectoryConfig.

Strumenti per PowerShell V5

Esempio 1: questo esempio aggiorna una configurazione di directory creata in AppStream

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

Output:

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

• Per informazioni dettagliate sull’API, consulta UpdateDirectoryConfig nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Update-APSFleet

L’esempio di codice seguente mostra come utilizzare Update-APSFleet.

Strumenti per PowerShell V5

Esempio 1: questo esempio aggiorna le proprietà di un parco

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

Output:

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

• Per informazioni dettagliate sull’API, consulta UpdateFleet nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Update-APSImagePermission

L’esempio di codice seguente mostra come utilizzare Update-APSImagePermission.

Strumenti per PowerShell V5

Esempio 1: questo esempio condivide un’immagine AppStream con un altro account

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

• Per informazioni dettagliate sull’API, consulta UpdateImagePermissions nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Update-APSStack

L’esempio di codice seguente mostra come utilizzare Update-APSStack.

Strumenti per PowerShell V5

Esempio 1: questo esempio aggiorna (abilita) la persistenza delle impostazioni dell’applicazione e le cartelle Home in uno stack

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

Output:

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}

• Per informazioni dettagliate sull’API, consulta UpdateStack nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).