本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# `AWS-CreateWorkSpace`
<a name="aws-create-workspace"></a>

 **Description** 

 `AWS-CreateWorkSpace` Runbook 會根據您為輸入參數指定的值，建立新的 Amazon WorkSpaces 虛擬桌面，稱為 WorkSpace。如需 WorkSpaces 的相關資訊，請參閱[什麼是 Amazon WorkSpaces？](https://docs.aws.amazon.com/workspaces/latest/adminguide/amazon-workspaces.html) *Amazon WorkSpaces 管理指南*中的 。

 [執行此自動化 （主控台）](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-CreateWorkspace) 

**文件類型**

 自動化

**擁有者**

Amazon

**平台**

Linux、macOS、 Windows

**參數**
+ AutomationAssumeRole

  類型：字串

  描述：（選用） 允許 Systems Manager Automation 代表您執行動作的 (IAM) 角色的 AWS Identity and Access Management Amazon Resource Name (ARN)。如果未指定角色，Systems Manager Automation 會使用啟動此 Runbook 之使用者的許可。
+ BundleId

  類型：字串

  描述：（必要） 用於 WorkSpace 的套件 ID。
+ ComputeTypeName

  類型：字串

  有效值：VALUE \| STANDARD \| PERFORMANCE \| POWER \| GRAPHICS \| POWERPRO \| GRAPHICSPRO

  描述：（選用） WorkSpace 的運算類型。
+ DirectoryId

  類型：字串

  描述：（必要） 要新增 WorkSpace 的目錄 ID。
+ RootVolumeEncryptionEnabled

  類型：布林值

  有效值：true \| false

  預設：false

  描述：（選用） 判斷 WorkSpace 的根磁碟區是否已加密。
+ RootVolumeSizeGib

  類型：整數

  描述：（必要） WorkSpace 根磁碟區的大小。
+ RunningMode

  類型：字串

  有效值：ALWAYS\_ON \| AUTO\_STOP

  描述：（必要） WorkSpace 的執行模式。
+ RunningModeAutoStopTimeoutInMinutes

  類型：整數

  描述：（選用） 使用者在 WorkSpaces 停止時登出後的時間。以 60 分鐘的間隔指定值。
+ Tags (標籤)

  類型：字串

  描述：（選用） 您要套用至 WorkSpace 的標籤。
+ UserName

  類型：字串

  描述：（必要） 要與 WorkSpace 建立關聯的使用者名稱。
+ UserVolumeEncryptionEnabled

  類型：布林值

  有效值：true \| false

  預設：false

  描述：（選用） 判斷 WorkSpace 的使用者磁碟區是否已加密。
+ UserVolumeSizeGib

  類型：整數

  描述：（必要） WorkSpace 的使用者磁碟區大小。
+ VolumeEncryptionKey

  類型：字串

  描述：（選用） 您要用來加密 WorkSpace 上存放資料的對稱 AWS Key Management Service 金鑰。

**必要的 IAM 許可**

`AutomationAssumeRole` 參數需要下列動作才能成功使用 Runbook。
+  `workspaces:CreateWorkspaces` 
+  `workspaces:DescribeWorkspaces` 

 **文件步驟** 
+  `aws:executeScript` - 根據您為輸入參數指定的值建立 WorkSpace。
+  `aws:waitForAwsResourceProperty` - 驗證 WorkSpace 的狀態為 `AVAILABLE`。

 **輸出** 

`CreateWorkspace.WorkspaceId`