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. # Amazon WorkSpaces AWS Systems Manager Automation fournit des runbooks prédéfinis pour Amazon WorkSpaces. Pour plus d’informations sur les runbooks, consultez [Travailler avec des runbooks](https://docs.aws.amazon.com/systems-manager/latest/userguide/automation-documents.html). Pour plus d'informations sur l'affichage du contenu du runbook, consultez[Afficher le contenu du runbook](automation-runbook-reference.md#view-automation-json). **Topics** + [`AWS-CreateWorkSpace`](aws-create-workspace.md) + [`AWSSupport-RecoverWorkSpace`](automation-awssupport-recover-workspace.md) # `AWS-CreateWorkSpace` **Description** Le `AWS-CreateWorkSpace` runbook crée un nouveau bureau WorkSpaces virtuel Amazon, appelé a WorkSpace, sur la base des valeurs que vous spécifiez pour les paramètres d'entrée. Pour plus d'informations WorkSpaces, consultez [Qu'est-ce qu'Amazon WorkSpaces ?](https://docs.aws.amazon.com/workspaces/latest/adminguide/amazon-workspaces.html) dans le *guide d' WorkSpaces administration Amazon*. [Exécuter cette automatisation (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-CreateWorkspace) **Type de document**  Automatisation **Propriétaire** Amazon **Plateformes** LinuxmacOS, Windows **Paramètres** + AutomationAssumeRole Type : Chaîne Description : (Facultatif) Le nom de ressource Amazon (ARN) du rôle Gestion des identités et des accès AWS (IAM) qui permet à Systems Manager Automation d'effectuer les actions en votre nom. Si aucun rôle n'est spécifié, Systems Manager Automation utilise les autorisations de l'utilisateur qui lance ce runbook. + BundleId Type : Chaîne Description : (Obligatoire) L'ID du bundle à utiliser pour WorkSpace. + ComputeTypeName Type : Chaîne Valeurs valides : VALEUR \$1 STANDARD \$1 PERFORMANCE \$1 PUISSANCE \$1 GRAPHISMES \$1 POWERPRO \$1 GRAPHICSPRO Description : (Facultatif) Type de calcul pour votre WorkSpace. + DirectoryId Type : Chaîne Description : (Obligatoire) L'ID du répertoire auquel vous souhaitez WorkSpace ajouter votre nom. + RootVolumeEncryptionEnabled Type : Boolean Valeurs valides : true \$1 false Valeur par défaut : false Description : (Facultatif) Détermine si le volume racine du WorkSpace est chiffré. + RootVolumeSizeGib Type : Integer Description : (Obligatoire) Taille du volume racine du WorkSpace. + RunningMode Type : Chaîne Valeurs valides : ALWAYS\$1ON \$1 AUTO\$1STOP Description : (Obligatoire) Le mode de fonctionnement du WorkSpace. + RunningModeAutoStopTimeoutInMinutes Type : Integer Description : (Facultatif) Temps écoulé entre la fermeture de session d'un utilisateur et son WorkSpaces arrêt. Spécifiez une valeur par intervalles de 60 minutes. + Étiquettes Type : Chaîne Description : (Facultatif) Balises que vous souhaitez appliquer au WorkSpace. + UserName Type : Chaîne Description : (Obligatoire) Le nom d'utilisateur à associer au WorkSpace. + UserVolumeEncryptionEnabled Type : Boolean Valeurs valides : true \$1 false Valeur par défaut : false Description : (Facultatif) Détermine si le volume utilisateur du WorkSpace est chiffré. + UserVolumeSizeGib Type : Integer Description : (Obligatoire) Taille du volume utilisateur pour le WorkSpace. + VolumeEncryptionKey Type : Chaîne Description : (Facultatif) La AWS Key Management Service clé symétrique que vous souhaitez utiliser pour chiffrer les données stockées sur votre. WorkSpace **Autorisations IAM requises** Le `AutomationAssumeRole` paramètre nécessite les actions suivantes pour utiliser correctement le runbook. + `workspaces:CreateWorkspaces` + `workspaces:DescribeWorkspaces` **Étapes de document** + `aws:executeScript`- Crée un WorkSpace en fonction des valeurs que vous spécifiez pour les paramètres d'entrée. + `aws:waitForAwsResourceProperty`- Vérifie l'état du système d'exploitation WorkSpace . `AVAILABLE` **Sorties** `CreateWorkspace.WorkspaceId` # `AWSSupport-RecoverWorkSpace` **Description** Le `AWSSupport-RecoverWorkSpace` runbook exécute les étapes de restauration sur le bureau WorkSpaces virtuel Amazon, connu sous le nom de WorkSpace, que vous spécifiez. Le runbook redémarre le WorkSpace, et si l'état est toujours le cas`UNHEALTHY`, le restaure ou le reconstruit en WorkSpace fonction des valeurs que vous spécifiez pour les paramètres d'entrée. Avant d'utiliser ce runbook, nous vous recommandons de consulter le *guide d' WorkSpaces administration Amazon* consacré [ WorkSpaces aux problèmes de résolution](https://docs.aws.amazon.com/workspaces/latest/adminguide/amazon-workspaces-troubleshooting.html) des problèmes. **Important** La restauration ou la reconstruction d'un WorkSpace est une action potentiellement destructrice qui peut entraîner la perte de données. Cela est dû au fait que les WorkSpace données sont restaurées à partir du dernier instantané disponible et que les données récupérées à partir des instantanés peuvent dater de 12 heures. L'option de restauration recrée à la fois le volume racine et le volume utilisateur en fonction des instantanés les plus récents. L'option de reconstruction recrée le volume utilisateur à partir de l'instantané le plus récent et le recrée WorkSpace à partir de l'image associée au bundle à partir duquel WorkSpace il a été créé. Les applications installées ou les paramètres système modifiés après leur WorkSpace création sont perdus. Pour plus d'informations sur la restauration et la reconstruction WorkSpaces, consultez [Restore a WorkSpace](https://docs.aws.amazon.com/workspaces/latest/adminguide/restore-workspace.html) et [Rebuild a WorkSpace](https://docs.aws.amazon.com/workspaces/latest/adminguide/rebuild-workspace.html) dans le *Guide d' WorkSpaces administration Amazon*. [Exécuter cette automatisation (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-RecoverWorkSpace) **Type de document**  Automatisation **Propriétaire** Amazon **Plateformes** LinuxmacOS, Windows **Paramètres** + AutomationAssumeRole Type : Chaîne Description : (Facultatif) Le nom de ressource Amazon (ARN) du rôle Gestion des identités et des accès AWS (IAM) qui permet à Systems Manager Automation d'effectuer les actions en votre nom. Si aucun rôle n'est spécifié, Systems Manager Automation utilise les autorisations de l'utilisateur qui lance ce runbook. + Reconnaître Type : Chaîne Valeurs valides : Oui Description : (Obligatoire) Si vous entrez Oui, vous comprenez que les actions de restauration et de reconstruction tenteront de récupérer les données à WorkSpace partir de l'instantané le plus récent et que les données restaurées à partir de ces instantanés peuvent dater de 12 heures seulement. + Redémarrer Type : Chaîne Valeurs valides : Oui \$1 Non Par défaut : Oui Description : (Obligatoire) Détermine si le WorkSpace est redémarré. + Reconstruire Type : Chaîne Valeurs valides : Oui \$1 Non Par défaut : Non Description : (Obligatoire) Détermine si le WorkSpace est reconstruit. + Restaurer Type : Chaîne Valeurs valides : Oui \$1 Non Par défaut : Non Description : (Obligatoire) Détermine si le WorkSpace est restauré. + WorkspaceId Type : Chaîne Description : (Obligatoire) L'ID du WorkSpace fichier que vous souhaitez récupérer. **Autorisations IAM requises** Le `AutomationAssumeRole` paramètre nécessite les actions suivantes pour utiliser correctement le runbook. + `ssm:StartAutomationExecution` + `ssm:GetAutomationExecution` + `workspaces:DescribeWorkspaces` + `workspaces:DescribeWorkspaceSnapshots` + `workspaces:RebootWorkspaces` + `workspaces:RebuildWorkspaces` + `workspaces:RestoreWorkspace` + `workspaces:StartWorkspaces` **Étapes de document** + `aws:executeAwsApi`- Rassemble l'état de ce WorkSpace que vous spécifiez dans le `WorkspaceId` paramètre. + `aws:assertAwsResourceProperty`- Vérifie l'état du WorkSpace is`AVAILABLE`,`ERROR`, `IMPAIRED``STOPPED`, ou`UNHEALTHY`. + `aws:branch`- Branches basées sur l'état du WorkSpace. + `aws:executeAwsApi`- Démarre le WorkSpace. + `aws:branch`- Branches basées sur la valeur que vous spécifiez pour le `Action` paramètre. + `aws:waitForAwsResourceProperty`- Attend le WorkSpace statut après avoir démarré. + `aws:waitForAwsResourceProperty`- Attend que l' WorkSpace état passe à `AVAILABLE` `ERROR``IMPAIRED`, ou `UNHEALTHY` après avoir été démarré. + `aws:executeAwsApi`- Recueille l'état de la machine WorkSpace après le démarrage. + `aws:branch`- Branches basées sur l'état de la WorkSpace machine après le démarrage. + `aws:executeAwsApi`- Rassemble les instantanés disponibles pour restaurer ou reconstruire le. WorkSpace + `aws:branch`- Branches basées sur la valeur que vous spécifiez pour le `Reboot` paramètre. + `aws:executeAwsApi`- Redémarre le. WorkSpace + `aws:executeAwsApi`- Recueille l'état de la machine WorkSpace après le démarrage. + `aws:waitForAwsResourceProperty`- Attend que l'état du WorkSpace passe à`REBOOTING`. + `aws:waitForAwsResourceProperty`- Attend que l' WorkSpace état passe à `AVAILABLE``ERROR`, ou `UNHEALTHY` après avoir été redémarré. + `aws:executeAwsApi`- Recueille l'état du WorkSpace après le redémarrage. + `aws:branch`- Branches basées sur l'état du WorkSpace après le redémarrage. + `aws:branch`- Branches basées sur la valeur que vous spécifiez pour le `Restore` paramètre. + `aws:executeAwsApi`- Restaure le WorkSpace. Si la restauration échoue, le runbook essaie de reconstruire le WorkSpace. + `aws:waitForAwsResourceProperty`- Attend que l'état du WorkSpace passe à`RESTORING`. + `aws:waitForAwsResourceProperty`- Attend que l' WorkSpace état passe à `AVAILABLE``ERROR`, ou `UNHEALTHY` après avoir été restauré. + `aws:executeAwsApi`- Rassemble l'état de l' WorkSpace objet restauré. + `aws:branch`- Branches basées sur l'état de l' WorkSpace après restauration. + `aws:branch`- Branches basées sur la valeur que vous spécifiez pour le `Rebuild` paramètre. + `aws:executeAwsApi`- Reconstruit le. WorkSpace + `aws:waitForAwsResourceProperty`- Attend que l'état du WorkSpace passe à`REBUILDING`. + `aws:waitForAwsResourceProperty`- Attend que l' WorkSpace État change ou `UNHEALTHY` après avoir été reconstruit. `AVAILABLE` `ERROR` + `aws:executeAwsApi`- Rassemble l'état de l' WorkSpace après sa reconstruction. + `aws:assertAwsResourceProperty`- Confirme l'état du WorkSpace si`AVAILABLE`.