Selecione suas preferências de cookies

Usamos cookies essenciais e ferramentas semelhantes que são necessárias para fornecer nosso site e serviços. Usamos cookies de desempenho para coletar estatísticas anônimas, para que possamos entender como os clientes usam nosso site e fazer as devidas melhorias. Cookies essenciais não podem ser desativados, mas você pode clicar em “Personalizar” ou “Recusar” para recusar cookies de desempenho.

Se você concordar, a AWS e terceiros aprovados também usarão cookies para fornecer recursos úteis do site, lembrar suas preferências e exibir conteúdo relevante, incluindo publicidade relevante. Para aceitar ou recusar todos os cookies não essenciais, clique em “Aceitar” ou “Recusar”. Para fazer escolhas mais detalhadas, clique em “Personalizar”.

AppStream Exemplos 2.0 usando ferramentas para PowerShell - AWS Exemplos de código do SDK

Há mais exemplos de AWS SDK disponíveis no repositório AWS Doc SDK Examples GitHub .

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Há mais exemplos de AWS SDK disponíveis no repositório AWS Doc SDK Examples GitHub .

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

AppStream Exemplos 2.0 usando ferramentas para PowerShell

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o Ferramentas da AWS para PowerShell with AppStream 2.0.

Ações são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.

Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.

Tópicos

Ações

O código de exemplo a seguir mostra como usar Add-APSResourceTag.

Ferramentas para PowerShell

Exemplo 1: Este exemplo adiciona uma tag de recurso ao AppStream recurso

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

Saída:

Name Value ---- ----- StackState Test
  • Para obter detalhes da API, consulte TagResourceem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Add-APSResourceTag.

Ferramentas para PowerShell

Exemplo 1: Este exemplo adiciona uma tag de recurso ao AppStream recurso

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

Saída:

Name Value ---- ----- StackState Test
  • Para obter detalhes da API, consulte TagResourceem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Copy-APSImage.

Ferramentas para PowerShell

Exemplo 1: Esta amostra copia uma imagem para outra região

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

Saída:

TestImageCopy
  • Para obter detalhes da API, consulte CopyImageem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Copy-APSImage.

Ferramentas para PowerShell

Exemplo 1: Esta amostra copia uma imagem para outra região

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

Saída:

TestImageCopy
  • Para obter detalhes da API, consulte CopyImageem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Disable-APSUSer.

Ferramentas para PowerShell

Exemplo 1: Este exemplo desativa um usuário no USERPOOL

Disable-APSUser -AuthenticationType USERPOOL -UserName TestUser@lab.com
  • Para obter detalhes da API, consulte DisableUserem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Disable-APSUSer.

Ferramentas para PowerShell

Exemplo 1: Este exemplo desativa um usuário no USERPOOL

Disable-APSUser -AuthenticationType USERPOOL -UserName TestUser@lab.com
  • Para obter detalhes da API, consulte DisableUserem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Enable-APSUser.

Ferramentas para PowerShell

Exemplo 1: Este exemplo habilita um usuário desativado no USERPOOL

Enable-APSUser -AuthenticationType USERPOOL -UserName TestUser@lab.com
  • Para obter detalhes da API, consulte EnableUserem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Enable-APSUser.

Ferramentas para PowerShell

Exemplo 1: Este exemplo habilita um usuário desativado no USERPOOL

Enable-APSUser -AuthenticationType USERPOOL -UserName TestUser@lab.com
  • Para obter detalhes da API, consulte EnableUserem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Get-APSAssociatedFleetList.

Ferramentas para PowerShell

Exemplo 1: Este exemplo exibe a frota associada a uma pilha

Get-APSAssociatedFleetList -StackName PowershellStack

Saída:

PowershellFleet
  • Para obter detalhes da API, consulte ListAssociatedFleetsem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Get-APSAssociatedFleetList.

Ferramentas para PowerShell

Exemplo 1: Este exemplo exibe a frota associada a uma pilha

Get-APSAssociatedFleetList -StackName PowershellStack

Saída:

PowershellFleet
  • Para obter detalhes da API, consulte ListAssociatedFleetsem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Get-APSAssociatedStackList.

Ferramentas para PowerShell

Exemplo 1: Este exemplo exibe a pilha associada a uma frota

Get-APSAssociatedStackList -FleetName PowershellFleet

Saída:

PowershellStack
  • Para obter detalhes da API, consulte ListAssociatedStacksem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Get-APSAssociatedStackList.

Ferramentas para PowerShell

Exemplo 1: Este exemplo exibe a pilha associada a uma frota

Get-APSAssociatedStackList -FleetName PowershellFleet

Saída:

PowershellStack
  • Para obter detalhes da API, consulte ListAssociatedStacksem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Get-APSDirectoryConfigList.

Ferramentas para PowerShell

Exemplo 1: Este exemplo exibe as configurações de diretório criadas em AppStream

Get-APSDirectoryConfigList | Select DirectoryName, OrganizationalUnitDistinguishedNames, CreatedTime

Saída:

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
  • Para obter detalhes da API, consulte DescribeDirectoryConfigsem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Get-APSDirectoryConfigList.

Ferramentas para PowerShell

Exemplo 1: Este exemplo exibe as configurações de diretório criadas em AppStream

Get-APSDirectoryConfigList | Select DirectoryName, OrganizationalUnitDistinguishedNames, CreatedTime

Saída:

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
  • Para obter detalhes da API, consulte DescribeDirectoryConfigsem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Get-APSFleetList.

Ferramentas para PowerShell

Exemplo 1: Este exemplo exibe detalhes de uma frota

Get-APSFleetList -Name Test

Saída:

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
  • Para obter detalhes da API, consulte DescribeFleetsem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Get-APSFleetList.

Ferramentas para PowerShell

Exemplo 1: Este exemplo exibe detalhes de uma frota

Get-APSFleetList -Name Test

Saída:

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
  • Para obter detalhes da API, consulte DescribeFleetsem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Get-APSImageBuilderList.

Ferramentas para PowerShell

Exemplo 1: Esta amostra exibe detalhes de um ImageBuilder

Get-APSImageBuilderList -Name TestImage

Saída:

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
  • Para obter detalhes da API, consulte DescribeImageBuildersem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Get-APSImageBuilderList.

Ferramentas para PowerShell

Exemplo 1: Esta amostra exibe detalhes de um ImageBuilder

Get-APSImageBuilderList -Name TestImage

Saída:

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
  • Para obter detalhes da API, consulte DescribeImageBuildersem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Get-APSImageList.

Ferramentas para PowerShell

Exemplo 1: Este exemplo exibe AppStream imagens privadas

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

Saída:

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
  • Para obter detalhes da API, consulte DescribeImagesem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Get-APSImageList.

Ferramentas para PowerShell

Exemplo 1: Este exemplo exibe AppStream imagens privadas

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

Saída:

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
  • Para obter detalhes da API, consulte DescribeImagesem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Get-APSImagePermission.

Ferramentas para PowerShell

Exemplo 1: Este exemplo exibe permissões de imagem em uma AppStream imagem compartilhada

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

Saída:

SharedAccountId AllowFleet AllowImageBuilder --------------- ---------- ----------------- 123456789012 True True
  • Para obter detalhes da API, consulte DescribeImagePermissionsem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Get-APSImagePermission.

Ferramentas para PowerShell

Exemplo 1: Este exemplo exibe permissões de imagem em uma AppStream imagem compartilhada

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

Saída:

SharedAccountId AllowFleet AllowImageBuilder --------------- ---------- ----------------- 123456789012 True True
  • Para obter detalhes da API, consulte DescribeImagePermissionsem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Get-APSSessionList.

Ferramentas para PowerShell

Exemplo 1: Este exemplo exibe a lista de sessões de uma frota

Get-APSSessionList -FleetName PowershellFleet -StackName PowershellStack

Saída:

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
  • Para obter detalhes da API, consulte DescribeSessionsem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Get-APSSessionList.

Ferramentas para PowerShell

Exemplo 1: Este exemplo exibe a lista de sessões de uma frota

Get-APSSessionList -FleetName PowershellFleet -StackName PowershellStack

Saída:

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
  • Para obter detalhes da API, consulte DescribeSessionsem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Get-APSStackList.

Ferramentas para PowerShell

Exemplo 1: Este exemplo exibe uma lista de AppStream pilhas

Get-APSStackList | Select DisplayName, Arn, CreatedTime

Saída:

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
  • Para obter detalhes da API, consulte DescribeStacksem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Get-APSStackList.

Ferramentas para PowerShell

Exemplo 1: Este exemplo exibe uma lista de AppStream pilhas

Get-APSStackList | Select DisplayName, Arn, CreatedTime

Saída:

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
  • Para obter detalhes da API, consulte DescribeStacksem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Get-APSTagsForResourceList.

Ferramentas para PowerShell

Exemplo 1: Este exemplo exibe tags em um AppStream recurso

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

Saída:

Key Value --- ----- StackState Test
  • Para obter detalhes da API, consulte ListTagsForResourceem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Get-APSTagsForResourceList.

Ferramentas para PowerShell

Exemplo 1: Este exemplo exibe tags em um AppStream recurso

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

Saída:

Key Value --- ----- StackState Test
  • Para obter detalhes da API, consulte ListTagsForResourceem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Get-APSUsageReportSubscription.

Ferramentas para PowerShell

Exemplo 1: Este exemplo exibe detalhes AppStreamUsageReport de configuração

Get-APSUsageReportSubscription

Saída:

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

O código de exemplo a seguir mostra como usar Get-APSUsageReportSubscription.

Ferramentas para PowerShell

Exemplo 1: Este exemplo exibe detalhes AppStreamUsageReport de configuração

Get-APSUsageReportSubscription

Saída:

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

O código de exemplo a seguir mostra como usar Get-APSUser.

Ferramentas para PowerShell

Exemplo 1: Este exemplo exibe a lista de usuários com status ativado

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

Saída:

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
  • Para obter detalhes da API, consulte DescribeUsersem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Get-APSUser.

Ferramentas para PowerShell

Exemplo 1: Este exemplo exibe a lista de usuários com status ativado

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

Saída:

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
  • Para obter detalhes da API, consulte DescribeUsersem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Get-APSUserStackAssociation.

Ferramentas para PowerShell

Exemplo 1: Este exemplo exibe a lista de usuários atribuídos a uma pilha

Get-APSUserStackAssociation -StackName PowershellStack

Saída:

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

O código de exemplo a seguir mostra como usar Get-APSUserStackAssociation.

Ferramentas para PowerShell

Exemplo 1: Este exemplo exibe a lista de usuários atribuídos a uma pilha

Get-APSUserStackAssociation -StackName PowershellStack

Saída:

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

O código de exemplo a seguir mostra como usar New-APSDirectoryConfig.

Ferramentas para PowerShell

Exemplo 1: Esse exemplo cria uma configuração de diretório no AppStream

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

Saída:

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
  • Para obter detalhes da API, consulte CreateDirectoryConfigem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar New-APSDirectoryConfig.

Ferramentas para PowerShell

Exemplo 1: Esse exemplo cria uma configuração de diretório no AppStream

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

Saída:

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
  • Para obter detalhes da API, consulte CreateDirectoryConfigem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar New-APSFleet.

Ferramentas para PowerShell

Exemplo 1: Este exemplo cria uma nova AppStream frota

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

Saída:

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
  • Para obter detalhes da API, consulte CreateFleetem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar New-APSFleet.

Ferramentas para PowerShell

Exemplo 1: Este exemplo cria uma nova AppStream frota

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

Saída:

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
  • Para obter detalhes da API, consulte CreateFleetem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar New-APSImageBuilder.

Ferramentas para PowerShell

Exemplo 1: Este exemplo cria um Image Builder em 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

Saída:

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
  • Para obter detalhes da API, consulte CreateImageBuilderem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar New-APSImageBuilder.

Ferramentas para PowerShell

Exemplo 1: Este exemplo cria um Image Builder em 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

Saída:

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
  • Para obter detalhes da API, consulte CreateImageBuilderem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar New-APSImageBuilderStreamingURL.

Ferramentas para PowerShell

Exemplo 1: esse exemplo cria um URL ImageBuilder de streaming com validade de 2 horas

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

Saída:

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

O código de exemplo a seguir mostra como usar New-APSImageBuilderStreamingURL.

Ferramentas para PowerShell

Exemplo 1: esse exemplo cria um URL ImageBuilder de streaming com validade de 2 horas

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

Saída:

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

O código de exemplo a seguir mostra como usar New-APSStack.

Ferramentas para PowerShell

Exemplo 1: Este exemplo cria uma nova AppStream pilha

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

Saída:

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}
  • Para obter detalhes da API, consulte CreateStackem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar New-APSStack.

Ferramentas para PowerShell

Exemplo 1: Este exemplo cria uma nova AppStream pilha

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

Saída:

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}
  • Para obter detalhes da API, consulte CreateStackem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar New-APSStreamingURL.

Ferramentas para PowerShell

Exemplo 1: este exemplo cria um URL de streaming do Stack

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

Saída:

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

O código de exemplo a seguir mostra como usar New-APSStreamingURL.

Ferramentas para PowerShell

Exemplo 1: este exemplo cria um URL de streaming do Stack

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

Saída:

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

O código de exemplo a seguir mostra como usar New-APSUsageReportSubscription.

Ferramentas para PowerShell

Exemplo 1: Este exemplo habilita relatórios AppStream de uso

New-APSUsageReportSubscription

Saída:

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

O código de exemplo a seguir mostra como usar New-APSUsageReportSubscription.

Ferramentas para PowerShell

Exemplo 1: Este exemplo habilita relatórios AppStream de uso

New-APSUsageReportSubscription

Saída:

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

O código de exemplo a seguir mostra como usar New-APSUser.

Ferramentas para PowerShell

Exemplo 1: Este exemplo cria um usuário no USERPOOL

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

Saída:

Test@lab.com
  • Para obter detalhes da API, consulte CreateUserem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar New-APSUser.

Ferramentas para PowerShell

Exemplo 1: Este exemplo cria um usuário no USERPOOL

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

Saída:

Test@lab.com
  • Para obter detalhes da API, consulte CreateUserem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Register-APSFleet.

Ferramentas para PowerShell

Exemplo 1: Esta amostra registra a frota com uma pilha

Register-APSFleet -StackName TestStack -FleetName TestFleet -Region us-west-2
  • Para obter detalhes da API, consulte AssociateFleetem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Register-APSFleet.

Ferramentas para PowerShell

Exemplo 1: Esta amostra registra a frota com uma pilha

Register-APSFleet -StackName TestStack -FleetName TestFleet -Region us-west-2
  • Para obter detalhes da API, consulte AssociateFleetem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Register-APSUserStackBatch.

Ferramentas para PowerShell

Exemplo 1: Este exemplo atribui pilha a um usuário em USERPOOL

Register-APSUserStackBatch -UserStackAssociation @{AuthenticationType="USERPOOL";SendEmailNotification=$False;StackName="PowershellStack";UserName="TestUser1@lab.com"}
  • Para obter detalhes da API, consulte BatchAssociateUserStackem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Register-APSUserStackBatch.

Ferramentas para PowerShell

Exemplo 1: Este exemplo atribui pilha a um usuário em USERPOOL

Register-APSUserStackBatch -UserStackAssociation @{AuthenticationType="USERPOOL";SendEmailNotification=$False;StackName="PowershellStack";UserName="TestUser1@lab.com"}
  • Para obter detalhes da API, consulte BatchAssociateUserStackem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Remove-APSDirectoryConfig.

Ferramentas para PowerShell

Exemplo 1: Este exemplo remove a configuração AppStream do diretório

Remove-APSDirectoryConfig -DirectoryName contoso.com

Saída:

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
  • Para obter detalhes da API, consulte DeleteDirectoryConfigem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Remove-APSDirectoryConfig.

Ferramentas para PowerShell

Exemplo 1: Este exemplo remove a configuração AppStream do diretório

Remove-APSDirectoryConfig -DirectoryName contoso.com

Saída:

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
  • Para obter detalhes da API, consulte DeleteDirectoryConfigem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Remove-APSFleet.

Ferramentas para PowerShell

Exemplo 1: Este exemplo remove e exclui uma frota AppStream

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

Saída:

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
  • Para obter detalhes da API, consulte DeleteFleetem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Remove-APSFleet.

Ferramentas para PowerShell

Exemplo 1: Este exemplo remove e exclui uma frota AppStream

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

Saída:

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
  • Para obter detalhes da API, consulte DeleteFleetem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Remove-APSImage.

Ferramentas para PowerShell

Exemplo 1: Este exemplo exclui uma imagem

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

Saída:

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
  • Para obter detalhes da API, consulte DeleteImageem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Remove-APSImage.

Ferramentas para PowerShell

Exemplo 1: Este exemplo exclui uma imagem

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

Saída:

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
  • Para obter detalhes da API, consulte DeleteImageem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Remove-APSImageBuilder.

Ferramentas para PowerShell

Exemplo 1: Este exemplo exclui um ImageBuilder

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

Saída:

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
  • Para obter detalhes da API, consulte DeleteImageBuilderem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Remove-APSImageBuilder.

Ferramentas para PowerShell

Exemplo 1: Este exemplo exclui um ImageBuilder

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

Saída:

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
  • Para obter detalhes da API, consulte DeleteImageBuilderem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Remove-APSImagePermission.

Ferramentas para PowerShell

Exemplo 1: Este exemplo remove as permissões de uma imagem

Remove-APSImagePermission -Name Powershell -SharedAccountId 123456789012

Saída:

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
  • Para obter detalhes da API, consulte DeleteImagePermissionsem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Remove-APSImagePermission.

Ferramentas para PowerShell

Exemplo 1: Este exemplo remove as permissões de uma imagem

Remove-APSImagePermission -Name Powershell -SharedAccountId 123456789012

Saída:

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
  • Para obter detalhes da API, consulte DeleteImagePermissionsem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Remove-APSResourceTag.

Ferramentas para PowerShell

Exemplo 1: este exemplo remove uma tag de recurso do AppStream recurso

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

Saída:

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
  • Para obter detalhes da API, consulte UntagResourceem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Remove-APSResourceTag.

Ferramentas para PowerShell

Exemplo 1: este exemplo remove uma tag de recurso do AppStream recurso

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

Saída:

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
  • Para obter detalhes da API, consulte UntagResourceem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Remove-APSStack.

Ferramentas para PowerShell

Exemplo 1: Este exemplo exclui uma pilha

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

Saída:

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
  • Para obter detalhes da API, consulte DeleteStackem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Remove-APSStack.

Ferramentas para PowerShell

Exemplo 1: Este exemplo exclui uma pilha

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

Saída:

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
  • Para obter detalhes da API, consulte DeleteStackem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Remove-APSUsageReportSubscription.

Ferramentas para PowerShell

Exemplo 1: Esse exemplo desativa a assinatura do Relatório AppStream de Uso

Remove-APSUsageReportSubscription

Saída:

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

O código de exemplo a seguir mostra como usar Remove-APSUsageReportSubscription.

Ferramentas para PowerShell

Exemplo 1: Esse exemplo desativa a assinatura do Relatório AppStream de Uso

Remove-APSUsageReportSubscription

Saída:

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

O código de exemplo a seguir mostra como usar Remove-APSUser.

Ferramentas para PowerShell

Exemplo 1: Este exemplo exclui um usuário do USERPOOL

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

Saída:

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
  • Para obter detalhes da API, consulte DeleteUserem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Remove-APSUser.

Ferramentas para PowerShell

Exemplo 1: Este exemplo exclui um usuário do USERPOOL

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

Saída:

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
  • Para obter detalhes da API, consulte DeleteUserem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Revoke-APSSession.

Ferramentas para PowerShell

Exemplo 1: Esse exemplo revoga uma sessão para a frota AppStream

Revoke-APSSession -SessionId 6cd2f9a3-f948-4aa1-8014-8a7dcde14877
  • Para obter detalhes da API, consulte ExpireSessionem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Revoke-APSSession.

Ferramentas para PowerShell

Exemplo 1: Esse exemplo revoga uma sessão para a frota AppStream

Revoke-APSSession -SessionId 6cd2f9a3-f948-4aa1-8014-8a7dcde14877
  • Para obter detalhes da API, consulte ExpireSessionem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Start-APSFleet.

Ferramentas para PowerShell

Exemplo 1: Esta amostra inicia uma frota

Start-APSFleet -Name PowershellFleet
  • Para obter detalhes da API, consulte StartFleetem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Start-APSFleet.

Ferramentas para PowerShell

Exemplo 1: Esta amostra inicia uma frota

Start-APSFleet -Name PowershellFleet
  • Para obter detalhes da API, consulte StartFleetem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Start-APSImageBuilder.

Ferramentas para PowerShell

Exemplo 1: Esta amostra inicia um ImageBuilder

Start-APSImageBuilder -Name TestImage

Saída:

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
  • Para obter detalhes da API, consulte StartImageBuilderem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Start-APSImageBuilder.

Ferramentas para PowerShell

Exemplo 1: Esta amostra inicia um ImageBuilder

Start-APSImageBuilder -Name TestImage

Saída:

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
  • Para obter detalhes da API, consulte StartImageBuilderem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Stop-APSFleet.

Ferramentas para PowerShell

Exemplo 1: Esta amostra interrompe uma frota

Stop-APSFleet -Name PowershellFleet
  • Para obter detalhes da API, consulte StopFleetem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Stop-APSFleet.

Ferramentas para PowerShell

Exemplo 1: Esta amostra interrompe uma frota

Stop-APSFleet -Name PowershellFleet
  • Para obter detalhes da API, consulte StopFleetem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Stop-APSImageBuilder.

Ferramentas para PowerShell

Exemplo 1: Esta amostra interrompe um ImageBuilder

Stop-APSImageBuilder -Name TestImage

Saída:

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
  • Para obter detalhes da API, consulte StopImageBuilderem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Stop-APSImageBuilder.

Ferramentas para PowerShell

Exemplo 1: Esta amostra interrompe um ImageBuilder

Stop-APSImageBuilder -Name TestImage

Saída:

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
  • Para obter detalhes da API, consulte StopImageBuilderem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Unregister-APSFleet.

Ferramentas para PowerShell

Exemplo 1: Este exemplo cancela o registro de uma frota da pilha

Unregister-APSFleet -StackName TestStack -FleetName TestFleet -Region us-west-2
  • Para obter detalhes da API, consulte DisassociateFleetem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Unregister-APSFleet.

Ferramentas para PowerShell

Exemplo 1: Este exemplo cancela o registro de uma frota da pilha

Unregister-APSFleet -StackName TestStack -FleetName TestFleet -Region us-west-2
  • Para obter detalhes da API, consulte DisassociateFleetem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Unregister-APSUserStackBatch.

Ferramentas para PowerShell

Exemplo 1: Este exemplo remove um usuário de uma pilha atribuída

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

O código de exemplo a seguir mostra como usar Unregister-APSUserStackBatch.

Ferramentas para PowerShell

Exemplo 1: Este exemplo remove um usuário de uma pilha atribuída

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

O código de exemplo a seguir mostra como usar Update-APSDirectoryConfig.

Ferramentas para PowerShell

Exemplo 1: Este exemplo atualiza a configuração do diretório criada no AppStream

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

Saída:

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
  • Para obter detalhes da API, consulte UpdateDirectoryConfigem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Update-APSDirectoryConfig.

Ferramentas para PowerShell

Exemplo 1: Este exemplo atualiza a configuração do diretório criada no AppStream

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

Saída:

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
  • Para obter detalhes da API, consulte UpdateDirectoryConfigem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Update-APSFleet.

Ferramentas para PowerShell

Exemplo 1: Este exemplo atualiza as propriedades de uma frota

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

Saída:

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
  • Para obter detalhes da API, consulte UpdateFleetem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Update-APSFleet.

Ferramentas para PowerShell

Exemplo 1: Este exemplo atualiza as propriedades de uma frota

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

Saída:

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
  • Para obter detalhes da API, consulte UpdateFleetem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Update-APSImagePermission.

Ferramentas para PowerShell

Exemplo 1: esta amostra compartilha uma AppStream imagem com outra conta

Update-APSImagePermission -Name Powershell -SharedAccountId 123456789012 -ImagePermissions_AllowFleet $True -ImagePermissions_AllowImageBuilder $True
  • Para obter detalhes da API, consulte UpdateImagePermissionsem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Update-APSImagePermission.

Ferramentas para PowerShell

Exemplo 1: esta amostra compartilha uma AppStream imagem com outra conta

Update-APSImagePermission -Name Powershell -SharedAccountId 123456789012 -ImagePermissions_AllowFleet $True -ImagePermissions_AllowImageBuilder $True
  • Para obter detalhes da API, consulte UpdateImagePermissionsem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Update-APSStack.

Ferramentas para PowerShell

Exemplo 1: Este exemplo atualiza (ativa) a persistência das configurações do aplicativo e as pastas pessoais em uma pilha

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

Saída:

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}
  • Para obter detalhes da API, consulte UpdateStackem Referência de Ferramentas da AWS para PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Update-APSStack.

Ferramentas para PowerShell

Exemplo 1: Este exemplo atualiza (ativa) a persistência das configurações do aplicativo e as pastas pessoais em uma pilha

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

Saída:

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}
  • Para obter detalhes da API, consulte UpdateStackem Referência de Ferramentas da AWS para PowerShell cmdlet.

PrivacidadeTermos do sitePreferências de cookies
© 2025, Amazon Web Services, Inc. ou suas afiliadas. Todos os direitos reservados.