A versão 5 (V5) do Ferramentas da AWS para PowerShell foi lançada\$1
Para obter informações sobre mudanças significativas e migrar seus aplicativos, consulte o [tópico de migração](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html).
[https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html)
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á.
# WorkSpaces exemplos usando o Tools for PowerShell V5
Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o Ferramentas da AWS para PowerShell V5 com WorkSpaces.
*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.
**Topics**
+ [Ações](#actions)
## Ações
### `Approve-WKSIpRule`
O código de exemplo a seguir mostra como usar `Approve-WKSIpRule`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo adiciona regras a um grupo de IP existente**
```
$Rule = @(
@{IPRule = "10.1.0.0/0"; RuleDesc = "First Rule Added"},
@{IPRule = "10.2.0.0/0"; RuleDesc = "Second Rule Added"}
)
Approve-WKSIpRule -GroupId wsipg-abcnx2fcw -UserRule $Rule
```
+ Para obter detalhes da API, consulte [AuthorizeIpRules](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Copy-WKSWorkspaceImage`
O código de exemplo a seguir mostra como usar `Copy-WKSWorkspaceImage`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Este exemplo copia a imagem do espaço de trabalho com o ID especificado de us-west-2 para a região atual com o nome "" CopiedImageTest**
```
Copy-WKSWorkspaceImage -Name CopiedImageTest -SourceRegion us-west-2 -SourceImageId wsi-djfoedhw6
```
**Saída**:
```
wsi-456abaqfe
```
+ Para obter detalhes da API, consulte [CopyWorkspaceImage](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Edit-WKSClientProperty`
O código de exemplo a seguir mostra como usar `Edit-WKSClientProperty`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo permite a reconexão para o cliente do Workspaces**
```
Edit-WKSClientProperty -Region us-west-2 -ClientProperties_ReconnectEnabled "ENABLED" -ResourceId d-123414a369
```
+ Para obter detalhes da API, consulte [ModifyClientProperties](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Edit-WKSSelfServicePermission`
O código de exemplo a seguir mostra como usar `Edit-WKSSelfServicePermission`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo concede permissões de autoatendimento para alterar o tipo de computação e aumentar o tamanho do volume para o diretório especificado**
```
Edit-WKSSelfservicePermission -Region us-west-2 -ResourceId d-123454a369 -SelfservicePermissions_ChangeComputeType ENABLED -SelfservicePermissions_IncreaseVolumeSize ENABLED
```
+ Para obter detalhes da API, consulte [ModifySelfservicePermissions](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Edit-WKSWorkspaceAccessProperty`
O código de exemplo a seguir mostra como usar `Edit-WKSWorkspaceAccessProperty`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo permite o acesso ao Workspace no Android e no Chrome OS para o diretório especificado**
```
Edit-WKSWorkspaceAccessProperty -Region us-west-2 -ResourceId d-123454a369 -WorkspaceAccessProperties_DeviceTypeAndroid ALLOW -WorkspaceAccessProperties_DeviceTypeChromeOs ALLOW
```
+ Para obter detalhes da API, consulte [ModifyWorkspaceAccessProperties](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Edit-WKSWorkspaceCreationProperty`
O código de exemplo a seguir mostra como usar `Edit-WKSWorkspaceCreationProperty`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo permite que o Modo de Manutenção e Acesso à Internet seja verdadeiro como valores padrão ao criar um espaço de trabalho**
```
Edit-WKSWorkspaceCreationProperty -Region us-west-2 -ResourceId d-123454a369 -WorkspaceCreationProperties_EnableInternetAccess $true -WorkspaceCreationProperties_EnableMaintenanceMode $true
```
+ Para obter detalhes da API, consulte [ModifyWorkspaceCreationProperties](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Edit-WKSWorkspaceProperty`
O código de exemplo a seguir mostra como usar `Edit-WKSWorkspaceProperty`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo altera a propriedade do modo de execução do espaço de trabalho para interrupção automática referente ao espaço de trabalho especificado**
```
Edit-WKSWorkspaceProperty -WorkspaceId ws-w361s100v -Region us-west-2 -WorkspaceProperties_RunningMode AUTO_STOP
```
+ Para obter detalhes da API, consulte [ModifyWorkspaceProperties](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Edit-WKSWorkspaceState`
O código de exemplo a seguir mostra como usar `Edit-WKSWorkspaceState`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo altera o estado do espaço de trabalho especificado para Disponível**
```
Edit-WKSWorkspaceState -WorkspaceId ws-w361s100v -Region us-west-2 -WorkspaceState AVAILABLE
```
+ Para obter detalhes da API, consulte [ModifyWorkspaceState](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-WKSClientProperty`
O código de exemplo a seguir mostra como usar `Get-WKSClientProperty`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo obtém as propriedades do cliente do Workspace Client para o diretório especificado**
```
Get-WKSClientProperty -ResourceId d-223562a123
```
+ Para obter detalhes da API, consulte [DescribeClientProperties](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-WKSIpGroup`
O código de exemplo a seguir mostra como usar `Get-WKSIpGroup`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo obtém os detalhes do grupo de IP especificado na região especificada**
```
Get-WKSIpGroup -Region us-east-1 -GroupId wsipg-8m1234v45
```
**Saída**:
```
GroupDesc GroupId GroupName UserRules
--------- ------- --------- ---------
wsipg-8m1234v45 TestGroup {Amazon.WorkSpaces.Model.IpRuleItem, Amazon.WorkSpaces.Model.IpRuleItem}
```
+ Para obter detalhes da API, consulte [DescribeIpGroups](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-WKSTag`
O código de exemplo a seguir mostra como usar `Get-WKSTag`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo busca a tag para o espaço de trabalho fornecido**
```
Get-WKSTag -WorkspaceId ws-w361s234r -Region us-west-2
```
**Saída**:
```
Key Value
--- -----
auto-delete no
purpose Workbench
```
+ Para obter detalhes da API, consulte [DescribeTags](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-WKSWorkspace`
O código de exemplo a seguir mostra como usar `Get-WKSWorkspace`.
**Ferramentas para PowerShell V5**
**Exemplo 1: recupera detalhes de todos os seus WorkSpaces para o pipeline.**
```
Get-WKSWorkspace
```
**Saída**:
```
BundleId : wsb-1a2b3c4d
ComputerName :
DirectoryId : d-1a2b3c4d
ErrorCode :
ErrorMessage :
IpAddress :
RootVolumeEncryptionEnabled : False
State : PENDING
SubnetId :
UserName : myuser
UserVolumeEncryptionEnabled : False
VolumeEncryptionKey :
WorkspaceId : ws-1a2b3c4d
WorkspaceProperties : Amazon.WorkSpaces.Model.WorkspaceProperties
```
**Exemplo 2: esse comando mostra os valores das propriedades secundárias de `WorkSpaceProperties` para um espaço de trabalho na região `us-west-2`. Para obter mais informações sobre as propriedades secundárias de`WorkSpaceProperties`, consulte https://docs.aws.amazon.com/workspaces/ latest/api/API \$1 WorkspaceProperties .html.**
```
(Get-WKSWorkspace -Region us-west-2 -WorkSpaceId ws-xdaf7hc9s).WorkspaceProperties
```
**Saída**:
```
ComputeTypeName : STANDARD
RootVolumeSizeGib : 80
RunningMode : AUTO_STOP
RunningModeAutoStopTimeoutInMinutes : 60
UserVolumeSizeGib : 50
```
**Exemplo 3: esse comando mostra o valor da propriedade secundária `RootVolumeSizeGib` de `WorkSpaceProperties` para um espaço de trabalho na região `us-west-2`. O tamanho do volume raiz, em GiB, é 80.**
```
(Get-WKSWorkspace -Region us-west-2 -WorkSpaceId ws-xdaf7hc9s).WorkspaceProperties.RootVolumeSizeGib
```
**Saída**:
```
80
```
+ Para obter detalhes da API, consulte [DescribeWorkspaces](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-WKSWorkspaceBundle`
O código de exemplo a seguir mostra como usar `Get-WKSWorkspaceBundle`.
**Ferramentas para PowerShell V5**
**Exemplo 1: essa amostra busca detalhes de todos os pacotes do Workspace na região atual**
```
Get-WKSWorkspaceBundle
```
**Saída**:
```
BundleId : wsb-sfhdgv342
ComputeType : Amazon.WorkSpaces.Model.ComputeType
Description : This bundle is custom
ImageId : wsi-235aeqges
LastUpdatedTime : 12/26/2019 06:44:07
Name : CustomBundleTest
Owner : 233816212345
RootStorage : Amazon.WorkSpaces.Model.RootStorage
UserStorage : Amazon.WorkSpaces.Model.UserStorage
```
+ Para obter detalhes da API, consulte [DescribeWorkspaceBundles](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-WKSWorkspaceDirectory`
O código de exemplo a seguir mostra como usar `Get-WKSWorkspaceDirectory`.
**Ferramentas para PowerShell V5**
**Exemplo 1: essa amostra lista os detalhes do diretório para diretórios registrados**
```
Get-WKSWorkspaceDirectory
```
**Saída**:
```
Alias : TestWorkspace
CustomerUserName : Administrator
DirectoryId : d-123414a369
DirectoryName : TestDirectory.com
DirectoryType : MicrosoftAD
DnsIpAddresses : {172.31.43.45, 172.31.2.97}
IamRoleId : arn:aws:iam::761234567801:role/workspaces_RoleDefault
IpGroupIds : {}
RegistrationCode : WSpdx+4RRT43
SelfservicePermissions : Amazon.WorkSpaces.Model.SelfservicePermissions
State : REGISTERED
SubnetIds : {subnet-1m3m7b43, subnet-ard11aba}
Tenancy : SHARED
WorkspaceAccessProperties : Amazon.WorkSpaces.Model.WorkspaceAccessProperties
WorkspaceCreationProperties : Amazon.WorkSpaces.Model.DefaultWorkspaceCreationProperties
WorkspaceSecurityGroupId : sg-0ed2441234a123c43
```
+ Para obter detalhes da API, consulte [DescribeWorkspaceDirectories](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-WKSWorkspaceImage`
O código de exemplo a seguir mostra como usar `Get-WKSWorkspaceImage`.
**Ferramentas para PowerShell V5**
**Exemplo 1: essa amostra busca todos os detalhes de todas as imagens na região**
```
Get-WKSWorkspaceImage
```
**Saída**:
```
Description :This image is copied from another image
ErrorCode :
ErrorMessage :
ImageId : wsi-345ahdjgo
Name : CopiedImageTest
OperatingSystem : Amazon.WorkSpaces.Model.OperatingSystem
RequiredTenancy : DEFAULT
State : AVAILABLE
```
+ Para obter detalhes da API, consulte [DescribeWorkspaceImages](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-WKSWorkspaceSnapshot`
O código de exemplo a seguir mostra como usar `Get-WKSWorkspaceSnapshot`.
**Ferramentas para PowerShell V5**
**Exemplo 1: essa amostra mostra o carimbo de data/hora do snapshot mais recente criado para o espaço de trabalho especificado**
```
Get-WKSWorkspaceSnapshot -WorkspaceId ws-w361s100v
```
**Saída**:
```
RebuildSnapshots RestoreSnapshots
---------------- ----------------
{Amazon.WorkSpaces.Model.Snapshot} {Amazon.WorkSpaces.Model.Snapshot}
```
+ Para obter detalhes da API, consulte [DescribeWorkspaceSnapshots](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-WKSWorkspacesConnectionStatus`
O código de exemplo a seguir mostra como usar `Get-WKSWorkspacesConnectionStatus`.
**Ferramentas para PowerShell V5**
**Exemplo 1: essa amostra busca o status da conexão para o espaço de trabalho especificado**
```
Get-WKSWorkspacesConnectionStatus -WorkspaceId ws-w123s234r
```
+ Para obter detalhes da API, consulte [DescribeWorkspacesConnectionStatus](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `New-WKSIpGroup`
O código de exemplo a seguir mostra como usar `New-WKSIpGroup`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Esse exemplo cria um grupo de IP vazio chamado FreshEmptyIpGroup**
```
New-WKSIpGroup -GroupName "FreshNewIPGroup"
```
**Saída**:
```
wsipg-w45rty4ty
```
+ Para obter detalhes da API, consulte [CreateIpGroup](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `New-WKSTag`
O código de exemplo a seguir mostra como usar `New-WKSTag`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo adiciona uma nova tag a um espaço de trabalho chamado `ws-wsname`. A tag tem uma chave de “Name” e um valor-chave de `AWS_Workspace`.**
```
$tag = New-Object Amazon.WorkSpaces.Model.Tag
$tag.Key = "Name"
$tag.Value = "AWS_Workspace"
New-WKSTag -Region us-west-2 -WorkspaceId ws-wsname -Tag $tag
```
**Exemplo 2: esse exemplo adiciona várias tags a um espaço de trabalho chamado `ws-wsname`. Uma tag tem uma chave de “Name” e um valor-chave de `AWS_Workspace`; a outra tag tem uma chave de tag de “Stage” e um valor-chave de “Test”.**
```
$tag = New-Object Amazon.WorkSpaces.Model.Tag
$tag.Key = "Name"
$tag.Value = "AWS_Workspace"
$tag2 = New-Object Amazon.WorkSpaces.Model.Tag
$tag2.Key = "Stage"
$tag2.Value = "Test"
New-WKSTag -Region us-west-2 -WorkspaceId ws-wsname -Tag $tag,$tag2
```
+ Para obter detalhes da API, consulte [CreateTags](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `New-WKSWorkspace`
O código de exemplo a seguir mostra como usar `New-WKSWorkspace`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Crie um WorkSpace para o pacote, o diretório e o usuário fornecidos.**
```
New-WKSWorkspace -Workspace @{"BundleID" = "wsb-1a2b3c4d"; "DirectoryId" = "d-1a2b3c4d"; "UserName" = "USERNAME"}
```
**Exemplo 2: Este exemplo cria vários WorkSpaces**
```
New-WKSWorkspace -Workspace @{"BundleID" = "wsb-1a2b3c4d"; "DirectoryId" = "d-1a2b3c4d"; "UserName" = "USERNAME_1"},@{"BundleID" = "wsb-1a2b3c4d"; "DirectoryId" = "d-1a2b3c4d"; "UserName" = "USERNAME_2"}
```
+ Para obter detalhes da API, consulte [CreateWorkspaces](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Register-WKSIpGroup`
O código de exemplo a seguir mostra como usar `Register-WKSIpGroup`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo registra o grupo de IP especificado com o diretório especificado**
```
Register-WKSIpGroup -GroupId wsipg-23ahsdres -DirectoryId d-123412e123
```
+ Para obter detalhes da API, consulte [AssociateIpGroups](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Register-WKSWorkspaceDirectory`
O código de exemplo a seguir mostra como usar `Register-WKSWorkspaceDirectory`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo registra o diretório especificado para o Workspaces Service**
```
Register-WKSWorkspaceDirectory -DirectoryId d-123412a123 -EnableWorkDoc $false
```
+ Para obter detalhes da API, consulte [RegisterWorkspaceDirectory](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Remove-WKSIpGroup`
O código de exemplo a seguir mostra como usar `Remove-WKSIpGroup`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo exclui o grupo de IP especificado**
```
Remove-WKSIpGroup -GroupId wsipg-32fhgtred
```
**Saída**:
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-WKSIpGroup (DeleteIpGroup)" on target "wsipg-32fhgtred".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y
```
+ Para obter detalhes da API, consulte [DeleteIpGroup](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Remove-WKSTag`
O código de exemplo a seguir mostra como usar `Remove-WKSTag`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo remove a tag associada ao espaço de trabalho**
```
Remove-WKSTag -ResourceId ws-w10b3abcd -TagKey "Type"
```
**Saída**:
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-WKSTag (DeleteTags)" on target "ws-w10b3abcd".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y
```
+ Para obter detalhes da API, consulte [DeleteTags](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Remove-WKSWorkspace`
O código de exemplo a seguir mostra como usar `Remove-WKSWorkspace`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Encerra vários WorkSpaces. O uso da opção -Force impede que o cmdlet solicite confirmação.**
```
Remove-WKSWorkspace -WorkspaceId "ws-1a2b3c4d5","ws-6a7b8c9d0" -Force
```
**Exemplo 2: Recupera a coleção de todas as suas WorkSpaces e canaliza IDs para o WorkSpaceId parâmetro - de Remove-WKSWorkspace, encerrando todas as. WorkSpaces O cmdlet avisará antes que cada um WorkSpace seja encerrado. Para ignorar a solicitação de confirmação, adicione a opção -Force.**
```
Get-WKSWorkspaces | Remove-WKSWorkspace
```
**Exemplo 3: Este exemplo mostra como passar TerminateRequest objetos definindo o WorkSpaces a ser encerrado. O cmdlet solicitará a confirmação antes de continuar, a menos que o parâmetro da opção -Force também seja especificado.**
```
$arrRequest = @()
$request1 = New-Object Amazon.WorkSpaces.Model.TerminateRequest
$request1.WorkspaceId = 'ws-12345678'
$arrRequest += $request1
$request2 = New-Object Amazon.WorkSpaces.Model.TerminateRequest
$request2.WorkspaceId = 'ws-abcdefgh'
$arrRequest += $request2
Remove-WKSWorkspace -Request $arrRequest
```
+ Para obter detalhes da API, consulte [TerminateWorkspaces](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Reset-WKSWorkspace`
O código de exemplo a seguir mostra como usar `Reset-WKSWorkspace`.
**Ferramentas para PowerShell V5**
**Exemplo 1: reconstrói o especificado. WorkSpace**
```
Reset-WKSWorkspace -WorkspaceId "ws-1a2b3c4d"
```
**Exemplo 2: Recupera a coleção de todos os seus WorkSpaces e os canaliza IDs para o WorkSpaceId parâmetro - de Reset-WKSWorkspace, fazendo com que o WorkSpaces seja reconstruído.**
```
Get-WKSWorkspaces | Reset-WKSWorkspace
```
+ Para obter detalhes da API, consulte [RebuildWorkspaces](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Restart-WKSWorkspace`
O código de exemplo a seguir mostra como usar `Restart-WKSWorkspace`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Reinicializa o especificado WorkSpace.**
```
Restart-WKSWorkspace -WorkspaceId "ws-1a2b3c4d"
```
**Exemplo 2: Reinicializa várias WorkSpaces.**
```
Restart-WKSWorkspace -WorkspaceId "ws-1a2b3c4d","ws-5a6b7c8d"
```
**Exemplo 3: recupera a coleção de todos os seus WorkSpaces e os canaliza IDs para o WorkSpaceId parâmetro - de Restart-WKSWorkspace, fazendo com que o WorkSpaces seja reiniciado.**
```
Get-WKSWorkspaces | Restart-WKSWorkspace
```
+ Para obter detalhes da API, consulte [RebootWorkspaces](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Stop-WKSWorkspace`
O código de exemplo a seguir mostra como usar `Stop-WKSWorkspace`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Interrompe várias WorkSpaces.**
```
Stop-WKSWorkspace -WorkspaceId "ws-1a2b3c4d5","ws-6a7b8c9d0"
```
**Exemplo 2: Recupera a coleção de todos os seus WorkSpaces e canaliza o IDs WorkSpaceId parâmetro - de Stop- WKSWorkspace fazendo com que o WorkSpaces seja interrompido.**
```
Get-WKSWorkspaces | Stop-WKSWorkspace
```
**Exemplo 3: Este exemplo mostra como passar StopRequest objetos definindo o WorkSpaces a ser parado.**
```
$arrRequest = @()
$request1 = New-Object Amazon.WorkSpaces.Model.StopRequest
$request1.WorkspaceId = 'ws-12345678'
$arrRequest += $request1
$request2 = New-Object Amazon.WorkSpaces.Model.StopRequest
$request2.WorkspaceId = 'ws-abcdefgh'
$arrRequest += $request2
Stop-WKSWorkspace -Request $arrRequest
```
+ Para obter detalhes da API, consulte [StopWorkspaces](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Unregister-WKSIpGroup`
O código de exemplo a seguir mostra como usar `Unregister-WKSIpGroup`.
**Ferramentas para PowerShell V5**
**Exemplo 1: essa amostra cancela o registro do grupo de IP especificado do diretório especificado**
```
Unregister-WKSIpGroup -GroupId wsipg-12abcdphq -DirectoryId d-123454b123
```
+ Para obter detalhes da API, consulte [DisassociateIpGroups](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.