

D'autres exemples de AWS SDK sont disponibles dans le référentiel [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .

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

# WorkSpaces exemples d'utilisation de Tools for PowerShell V4
<a name="powershell_4_workspaces_code_examples"></a>

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants en utilisant le Outils AWS pour PowerShell V4 avec WorkSpaces.

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

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

**Topics**
+ [Actions](#actions)

## Actions
<a name="actions"></a>

### `Approve-WKSIpRule`
<a name="workspaces_AuthorizeIpRules_powershell_4_topic"></a>

L'exemple de code suivant montre comment utiliser`Approve-WKSIpRule`.

**Outils pour PowerShell V4**  
**Exemple 1 : cet exemple ajoute des règles à un groupe IP existant**  

```
$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
```
+  Pour plus de détails sur l'API, reportez-vous [AuthorizeIpRules](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*. 

### `Copy-WKSWorkspaceImage`
<a name="workspaces_CopyWorkspaceImage_powershell_4_topic"></a>

L'exemple de code suivant montre comment utiliser`Copy-WKSWorkspaceImage`.

**Outils pour PowerShell V4**  
**Exemple 1 : Cet exemple copie l'image de l'espace de travail avec l'ID spécifié de us-west-2 vers la région actuelle avec le nom « » CopiedImageTest**  

```
Copy-WKSWorkspaceImage -Name CopiedImageTest -SourceRegion us-west-2 -SourceImageId wsi-djfoedhw6
```
**Sortie** :  

```
wsi-456abaqfe
```
+  Pour plus de détails sur l'API, reportez-vous [CopyWorkspaceImage](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*. 

### `Edit-WKSClientProperty`
<a name="workspaces_ModifyClientProperties_powershell_4_topic"></a>

L'exemple de code suivant montre comment utiliser`Edit-WKSClientProperty`.

**Outils pour PowerShell V4**  
**Exemple 1 : cet exemple active la reconnexion pour le client Workspaces**  

```
Edit-WKSClientProperty -Region us-west-2 -ClientProperties_ReconnectEnabled "ENABLED" -ResourceId d-123414a369
```
+  Pour plus de détails sur l'API, reportez-vous [ModifyClientProperties](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*. 

### `Edit-WKSSelfServicePermission`
<a name="workspaces_ModifySelfservicePermissions_powershell_4_topic"></a>

L'exemple de code suivant montre comment utiliser`Edit-WKSSelfServicePermission`.

**Outils pour PowerShell V4**  
**Exemple 1 : cet exemple active les autorisations en libre-service pour modifier le type de calcul et augmenter la taille du volume pour le répertoire spécifié**  

```
Edit-WKSSelfservicePermission -Region us-west-2 -ResourceId d-123454a369 -SelfservicePermissions_ChangeComputeType ENABLED -SelfservicePermissions_IncreaseVolumeSize ENABLED
```
+  Pour plus de détails sur l'API, reportez-vous [ModifySelfservicePermissions](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*. 

### `Edit-WKSWorkspaceAccessProperty`
<a name="workspaces_ModifyWorkspaceAccessProperties_powershell_4_topic"></a>

L'exemple de code suivant montre comment utiliser`Edit-WKSWorkspaceAccessProperty`.

**Outils pour PowerShell V4**  
**Exemple 1 : cet exemple active l’accès à l’espace de travail sur Android et Chrome OS pour le répertoire spécifié**  

```
Edit-WKSWorkspaceAccessProperty -Region us-west-2 -ResourceId d-123454a369 -WorkspaceAccessProperties_DeviceTypeAndroid ALLOW -WorkspaceAccessProperties_DeviceTypeChromeOs ALLOW
```
+  Pour plus de détails sur l'API, reportez-vous [ModifyWorkspaceAccessProperties](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*. 

### `Edit-WKSWorkspaceCreationProperty`
<a name="workspaces_ModifyWorkspaceCreationProperties_powershell_4_topic"></a>

L'exemple de code suivant montre comment utiliser`Edit-WKSWorkspaceCreationProperty`.

**Outils pour PowerShell V4**  
**Exemple 1 : cet exemple active l’accès à Internet et le mode de maintenance sur true comme valeurs par défaut lors de la création d’un espace de travail**  

```
Edit-WKSWorkspaceCreationProperty -Region us-west-2 -ResourceId d-123454a369 -WorkspaceCreationProperties_EnableInternetAccess $true -WorkspaceCreationProperties_EnableMaintenanceMode $true
```
+  Pour plus de détails sur l'API, reportez-vous [ModifyWorkspaceCreationProperties](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*. 

### `Edit-WKSWorkspaceProperty`
<a name="workspaces_ModifyWorkspaceProperties_powershell_4_topic"></a>

L'exemple de code suivant montre comment utiliser`Edit-WKSWorkspaceProperty`.

**Outils pour PowerShell V4**  
**Exemple 1 : cet exemple modifie la propriété Workspace Running Mode sur Auto Stop pour l’espace de travail spécifié**  

```
Edit-WKSWorkspaceProperty -WorkspaceId ws-w361s100v -Region us-west-2 -WorkspaceProperties_RunningMode AUTO_STOP
```
+  Pour plus de détails sur l'API, reportez-vous [ModifyWorkspaceProperties](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*. 

### `Edit-WKSWorkspaceState`
<a name="workspaces_ModifyWorkspaceState_powershell_4_topic"></a>

L'exemple de code suivant montre comment utiliser`Edit-WKSWorkspaceState`.

**Outils pour PowerShell V4**  
**Exemple 1 : cet exemple fait passer l’état de l’espace de travail spécifié sur Disponible**  

```
Edit-WKSWorkspaceState -WorkspaceId ws-w361s100v -Region us-west-2 -WorkspaceState AVAILABLE
```
+  Pour plus de détails sur l'API, reportez-vous [ModifyWorkspaceState](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*. 

### `Get-WKSClientProperty`
<a name="workspaces_DescribeClientProperties_powershell_4_topic"></a>

L'exemple de code suivant montre comment utiliser`Get-WKSClientProperty`.

**Outils pour PowerShell V4**  
**Exemple 1 : cet exemple obtient les propriétés du client de l’espace de travail pour le répertoire spécifié**  

```
Get-WKSClientProperty -ResourceId d-223562a123
```
+  Pour plus de détails sur l'API, reportez-vous [DescribeClientProperties](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*. 

### `Get-WKSIpGroup`
<a name="workspaces_DescribeIpGroups_powershell_4_topic"></a>

L'exemple de code suivant montre comment utiliser`Get-WKSIpGroup`.

**Outils pour PowerShell V4**  
**Exemple 1 : cet exemple obtient les détails du groupe IP spécifié dans la région spécifiée**  

```
Get-WKSIpGroup -Region us-east-1 -GroupId wsipg-8m1234v45
```
**Sortie** :  

```
GroupDesc GroupId         GroupName UserRules
--------- -------         --------- ---------
          wsipg-8m1234v45 TestGroup {Amazon.WorkSpaces.Model.IpRuleItem, Amazon.WorkSpaces.Model.IpRuleItem}
```
+  Pour plus de détails sur l'API, reportez-vous [DescribeIpGroups](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*. 

### `Get-WKSTag`
<a name="workspaces_DescribeTags_powershell_4_topic"></a>

L'exemple de code suivant montre comment utiliser`Get-WKSTag`.

**Outils pour PowerShell V4**  
**Exemple 1 : cet exemple récupère la balise pour l’espace de travail donné**  

```
Get-WKSTag -WorkspaceId ws-w361s234r -Region us-west-2
```
**Sortie** :  

```
Key         Value
---         -----
auto-delete no
purpose     Workbench
```
+  Pour plus de détails sur l'API, reportez-vous [DescribeTags](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*. 

### `Get-WKSWorkspace`
<a name="workspaces_DescribeWorkspaces_powershell_4_topic"></a>

L'exemple de code suivant montre comment utiliser`Get-WKSWorkspace`.

**Outils pour PowerShell V4**  
**Exemple 1 : récupère les détails de toutes vos connexions WorkSpaces au pipeline.**  

```
Get-WKSWorkspace
```
**Sortie** :  

```
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
```
**Exemple 2 : cette commande affiche les valeurs des propriétés enfant de `WorkSpaceProperties` pour un espace de travail dans la région `us-west-2`. Pour plus d'informations sur les propriétés enfant de`WorkSpaceProperties`, consultez https://docs.aws.amazon.com/workspaces/ latest/api/API \$1 WorkspaceProperties .html.**  

```
(Get-WKSWorkspace -Region us-west-2 -WorkSpaceId ws-xdaf7hc9s).WorkspaceProperties
```
**Sortie** :  

```
        ComputeTypeName                     : STANDARD
        RootVolumeSizeGib                   : 80
        RunningMode                         : AUTO_STOP
        RunningModeAutoStopTimeoutInMinutes : 60
        UserVolumeSizeGib                   : 50
```
**Exemple 3 : cette commande indique la valeur de la propriété enfant `RootVolumeSizeGib` de `WorkSpaceProperties` pour un espace de travail dans la région `us-west-2`. La taille du volume racine, en GiO, est de 80.**  

```
(Get-WKSWorkspace -Region us-west-2 -WorkSpaceId ws-xdaf7hc9s).WorkspaceProperties.RootVolumeSizeGib
```
**Sortie** :  

```
        80
```
+  Pour plus de détails sur l'API, reportez-vous [DescribeWorkspaces](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*. 

### `Get-WKSWorkspaceBundle`
<a name="workspaces_DescribeWorkspaceBundles_powershell_4_topic"></a>

L'exemple de code suivant montre comment utiliser`Get-WKSWorkspaceBundle`.

**Outils pour PowerShell V4**  
**Exemple 1 : cet exemple récupère les détails de toutes les offres de l’espace de travail dans la région actuelle**  

```
Get-WKSWorkspaceBundle
```
**Sortie** :  

```
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
```
+  Pour plus de détails sur l'API, reportez-vous [DescribeWorkspaceBundles](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*. 

### `Get-WKSWorkspaceDirectory`
<a name="workspaces_DescribeWorkspaceDirectories_powershell_4_topic"></a>

L'exemple de code suivant montre comment utiliser`Get-WKSWorkspaceDirectory`.

**Outils pour PowerShell V4**  
**Exemple 1 : cet exemple répertorie les détails des répertoires enregistrés**  

```
Get-WKSWorkspaceDirectory
```
**Sortie** :  

```
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
```
+  Pour plus de détails sur l'API, reportez-vous [DescribeWorkspaceDirectories](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*. 

### `Get-WKSWorkspaceImage`
<a name="workspaces_DescribeWorkspaceImages_powershell_4_topic"></a>

L'exemple de code suivant montre comment utiliser`Get-WKSWorkspaceImage`.

**Outils pour PowerShell V4**  
**Exemple 1 : cet exemple récupère tous les détails de toutes les images de la région**  

```
Get-WKSWorkspaceImage
```
**Sortie** :  

```
Description     :This image is copied from another image
ErrorCode       :
ErrorMessage    :
ImageId         : wsi-345ahdjgo
Name            : CopiedImageTest
OperatingSystem : Amazon.WorkSpaces.Model.OperatingSystem
RequiredTenancy : DEFAULT
State           : AVAILABLE
```
+  Pour plus de détails sur l'API, reportez-vous [DescribeWorkspaceImages](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*. 

### `Get-WKSWorkspaceSnapshot`
<a name="workspaces_DescribeWorkspaceSnapshots_powershell_4_topic"></a>

L'exemple de code suivant montre comment utiliser`Get-WKSWorkspaceSnapshot`.

**Outils pour PowerShell V4**  
**Exemple 1 : cet exemple montre l’horodatage du dernier instantané créé pour l’espace de travail spécifié**  

```
Get-WKSWorkspaceSnapshot -WorkspaceId ws-w361s100v
```
**Sortie** :  

```
RebuildSnapshots                   RestoreSnapshots
----------------                   ----------------
{Amazon.WorkSpaces.Model.Snapshot} {Amazon.WorkSpaces.Model.Snapshot}
```
+  Pour plus de détails sur l'API, reportez-vous [DescribeWorkspaceSnapshots](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*. 

### `Get-WKSWorkspacesConnectionStatus`
<a name="workspaces_DescribeWorkspacesConnectionStatus_powershell_4_topic"></a>

L'exemple de code suivant montre comment utiliser`Get-WKSWorkspacesConnectionStatus`.

**Outils pour PowerShell V4**  
**Exemple 1 : cet exemple récupère le statut de la connexion pour l’espace de travail spécifié**  

```
Get-WKSWorkspacesConnectionStatus -WorkspaceId ws-w123s234r
```
+  Pour plus de détails sur l'API, reportez-vous [DescribeWorkspacesConnectionStatus](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*. 

### `New-WKSIpGroup`
<a name="workspaces_CreateIpGroup_powershell_4_topic"></a>

L'exemple de code suivant montre comment utiliser`New-WKSIpGroup`.

**Outils pour PowerShell V4**  
**Exemple 1 : Cet exemple crée un groupe d'adresses IP vide nommé FreshEmptyIpGroup**  

```
New-WKSIpGroup -GroupName "FreshNewIPGroup"
```
**Sortie** :  

```
wsipg-w45rty4ty
```
+  Pour plus de détails sur l'API, reportez-vous [CreateIpGroup](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*. 

### `New-WKSTag`
<a name="workspaces_CreateTags_powershell_4_topic"></a>

L'exemple de code suivant montre comment utiliser`New-WKSTag`.

**Outils pour PowerShell V4**  
**Exemple 1 : cet exemple ajoute une balise à un espace de travail nommé `ws-wsname`. La balise possède une clé de « Nom » et une valeur de clé 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
```
**Exemple 2 : cet exemple ajoute plusieurs balises à un espace de travail nommé `ws-wsname`. Une balise possède une clé « Nom » et une valeur clé de `AWS_Workspace` ; l’autre balise a une clé « Stage » et une valeur clé « 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
```
+  Pour plus de détails sur l'API, reportez-vous [CreateTags](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*. 

### `New-WKSWorkspace`
<a name="workspaces_CreateWorkspaces_powershell_4_topic"></a>

L'exemple de code suivant montre comment utiliser`New-WKSWorkspace`.

**Outils pour PowerShell V4**  
**Exemple 1 : créez un WorkSpace pour le bundle, le répertoire et l'utilisateur fournis.**  

```
New-WKSWorkspace -Workspace @{"BundleID" = "wsb-1a2b3c4d"; "DirectoryId" = "d-1a2b3c4d"; "UserName" = "USERNAME"}
```
**Exemple 2 : Cet exemple crée plusieurs WorkSpaces**  

```
New-WKSWorkspace -Workspace @{"BundleID" = "wsb-1a2b3c4d"; "DirectoryId" = "d-1a2b3c4d"; "UserName" = "USERNAME_1"},@{"BundleID" = "wsb-1a2b3c4d"; "DirectoryId" = "d-1a2b3c4d"; "UserName" = "USERNAME_2"}
```
+  Pour plus de détails sur l'API, reportez-vous [CreateWorkspaces](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*. 

### `Register-WKSIpGroup`
<a name="workspaces_AssociateIpGroups_powershell_4_topic"></a>

L'exemple de code suivant montre comment utiliser`Register-WKSIpGroup`.

**Outils pour PowerShell V4**  
**Exemple 1 : cet exemple enregistre le groupe IP spécifié dans le répertoire spécifié**  

```
Register-WKSIpGroup -GroupId wsipg-23ahsdres -DirectoryId d-123412e123
```
+  Pour plus de détails sur l'API, reportez-vous [AssociateIpGroups](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*. 

### `Register-WKSWorkspaceDirectory`
<a name="workspaces_RegisterWorkspaceDirectory_powershell_4_topic"></a>

L'exemple de code suivant montre comment utiliser`Register-WKSWorkspaceDirectory`.

**Outils pour PowerShell V4**  
**Exemple 1 : cet exemple enregistre le répertoire spécifié pour le service Workspaces**  

```
Register-WKSWorkspaceDirectory -DirectoryId d-123412a123 -EnableWorkDoc $false
```
+  Pour plus de détails sur l'API, reportez-vous [RegisterWorkspaceDirectory](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*. 

### `Remove-WKSIpGroup`
<a name="workspaces_DeleteIpGroup_powershell_4_topic"></a>

L'exemple de code suivant montre comment utiliser`Remove-WKSIpGroup`.

**Outils pour PowerShell V4**  
**Exemple 1 : cet exemple supprime le groupe IP spécifié**  

```
Remove-WKSIpGroup -GroupId wsipg-32fhgtred
```
**Sortie** :  

```
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
```
+  Pour plus de détails sur l'API, reportez-vous [DeleteIpGroup](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*. 

### `Remove-WKSTag`
<a name="workspaces_DeleteTags_powershell_4_topic"></a>

L'exemple de code suivant montre comment utiliser`Remove-WKSTag`.

**Outils pour PowerShell V4**  
**Exemple 1 : cet exemple supprime la balise associée à l’espace de travail**  

```
Remove-WKSTag -ResourceId ws-w10b3abcd -TagKey "Type"
```
**Sortie** :  

```
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
```
+  Pour plus de détails sur l'API, reportez-vous [DeleteTags](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*. 

### `Remove-WKSWorkspace`
<a name="workspaces_TerminateWorkspaces_powershell_4_topic"></a>

L'exemple de code suivant montre comment utiliser`Remove-WKSWorkspace`.

**Outils pour PowerShell V4**  
**Exemple 1 : met fin à plusieurs WorkSpaces. L'utilisation du commutateur -Force empêche l'applet de commande de demander une confirmation.**  

```
Remove-WKSWorkspace -WorkspaceId "ws-1a2b3c4d5","ws-6a7b8c9d0" -Force
```
**Exemple 2 : Récupère la collection de tous vos WorkSpaces et les dirige IDs vers le WorkSpaceId paramètre - de Remove-WKSWorkspace, en mettant fin à tous les. WorkSpaces L'applet de commande affiche un message avant de terminer chacune d'entre elles WorkSpace . Pour supprimer l’invite de confirmation, ajoutez le commutateur -Force.**  

```
Get-WKSWorkspaces | Remove-WKSWorkspace
```
**Exemple 3 : Cet exemple montre comment transmettre TerminateRequest des objets définissant le WorkSpaces à terminer. L’applet de commande vous invitera à confirmer avant de poursuivre, à moins que l’option -Force ne soit spécifiée.**  

```
$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
```
+  Pour plus de détails sur l'API, reportez-vous [TerminateWorkspaces](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*. 

### `Reset-WKSWorkspace`
<a name="workspaces_RebuildWorkspaces_powershell_4_topic"></a>

L'exemple de code suivant montre comment utiliser`Reset-WKSWorkspace`.

**Outils pour PowerShell V4**  
**Exemple 1 : reconstruit le fichier spécifié WorkSpace.**  

```
Reset-WKSWorkspace -WorkspaceId "ws-1a2b3c4d"
```
**Exemple 2 : récupère la collection de tous vos fichiers WorkSpaces et les redirige IDs vers le WorkSpaceId paramètre - de Reset-WKSWorkspace, ce qui entraîne WorkSpaces leur reconstruction.**  

```
Get-WKSWorkspaces | Reset-WKSWorkspace
```
+  Pour plus de détails sur l'API, reportez-vous [RebuildWorkspaces](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*. 

### `Restart-WKSWorkspace`
<a name="workspaces_RebootWorkspaces_powershell_4_topic"></a>

L'exemple de code suivant montre comment utiliser`Restart-WKSWorkspace`.

**Outils pour PowerShell V4**  
**Exemple 1 : redémarre le paramètre spécifié WorkSpace.**  

```
Restart-WKSWorkspace -WorkspaceId "ws-1a2b3c4d"
```
**Exemple 2 : redémarre plusieurs WorkSpaces fois.**  

```
Restart-WKSWorkspace -WorkspaceId "ws-1a2b3c4d","ws-5a6b7c8d"
```
**Exemple 3 : récupère la collection de tous vos fichiers WorkSpaces et les redirige IDs vers le WorkSpaceId paramètre - de Restart-WKSWorkspace, provoquant le WorkSpaces redémarrage du.**  

```
Get-WKSWorkspaces | Restart-WKSWorkspace
```
+  Pour plus de détails sur l'API, reportez-vous [RebootWorkspaces](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*. 

### `Stop-WKSWorkspace`
<a name="workspaces_StopWorkspaces_powershell_4_topic"></a>

L'exemple de code suivant montre comment utiliser`Stop-WKSWorkspace`.

**Outils pour PowerShell V4**  
**Exemple 1 : arrête plusieurs WorkSpaces**  

```
Stop-WKSWorkspace -WorkspaceId "ws-1a2b3c4d5","ws-6a7b8c9d0"
```
**Exemple 2 : récupère la collection de tous vos WorkSpaces fichiers et les dirige IDs vers le WorkSpaceId paramètre - de Stop- WKSWorkspace provoquant WorkSpaces leur arrêt.**  

```
Get-WKSWorkspaces | Stop-WKSWorkspace
```
**Exemple 3 : Cet exemple montre comment transmettre StopRequest des objets définissant le WorkSpaces à arrêter.**  

```
$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
```
+  Pour plus de détails sur l'API, reportez-vous [StopWorkspaces](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*. 

### `Unregister-WKSIpGroup`
<a name="workspaces_DisassociateIpGroups_powershell_4_topic"></a>

L'exemple de code suivant montre comment utiliser`Unregister-WKSIpGroup`.

**Outils pour PowerShell V4**  
**Exemple 1 : cet exemple annule l’enregistrement du groupe IP spécifié dans le répertoire spécifié**  

```
Unregister-WKSIpGroup -GroupId wsipg-12abcdphq -DirectoryId d-123454b123
```
+  Pour plus de détails sur l'API, reportez-vous [DisassociateIpGroups](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*. 