本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

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

 **描述** 

 `AWS-CreateWorkSpace`运行手册根据您为输入参数指定的值创建一个新的 Amazon WorkSpaces 虚拟桌面，称为 a WorkSpace。有关信息 WorkSpaces，请参阅[什么是亚马逊 WorkSpaces？](https://docs.aws.amazon.com/workspaces/latest/adminguide/amazon-workspaces.html) 在《*亚马逊 WorkSpaces 管理指南》*中。

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

**文档类型**

自动化

**所有者**

Amazon

**平台**

Linux、macOS、Windows

**参数**
+ AutomationAssumeRole

  类型：字符串

  描述：（可选）允许 Systems Manager Automation 代表您执行操作 AWS Identity and Access Management (IAM) 角色的 Amazon 资源名称（ARN）。如果未指定角色，Systems Manager Automation 将使用启动此运行手册的用户的权限。
+ BundleId

  类型：字符串

  描述：（必填）要用于的捆绑包的 ID WorkSpace。
+ ComputeTypeName

  类型：字符串

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

  描述：（可选）您的计算类型 WorkSpace。
+ DirectoryId

  类型：字符串

  描述：（必填）要添加您的 WorkSpace目录的 ID。
+ RootVolumeEncryptionEnabled

  类型：布尔值

  有效值：true \$1 false

  默认：false

  描述：（可选）确定是否对的根卷进行加密。 WorkSpace 
+ RootVolumeSizeGib

  类型：整数

  描述：（必填）的根卷的大小 WorkSpace。
+ RunningMode

  类型：字符串

  有效值：ALWAYS\$1ON \$1 AUTO\$1STOP

  描述：（必填）的运行模式 WorkSpace。
+ RunningModeAutoStopTimeoutInMinutes

  类型：整数

  描述：（可选）用户注销后 WorkSpaces停止的时间。以 60 分钟为间隔指定一个值。
+ 标签

  类型：字符串

  描述：（可选）要应用于的标签 WorkSpace。
+ UserName

  类型：字符串

  描述：（必填）要与关联的用户名 WorkSpace。
+ UserVolumeEncryptionEnabled

  类型：布尔值

  有效值：true \$1 false

  默认：false

  描述：（可选）确定是否对的用户卷进行加密。 WorkSpace 
+ UserVolumeSizeGib

  类型：整数

  描述：（必填）的用户音量大小 WorkSpace。
+ VolumeEncryptionKey

  类型：字符串

  描述：（可选）您要用来加密存储在上的数据的对称密 AWS Key Management Service 钥。 WorkSpace

**所需的 IAM 权限**

`AutomationAssumeRole` 参数需要执行以下操作才能成功使用运行手册。
+  `workspaces:CreateWorkspaces` 
+  `workspaces:DescribeWorkspaces` 

 **文档步骤** 
+  `aws:executeScript`- WorkSpace 根据您为输入参数指定的值创建。
+  `aws:waitForAwsResourceProperty`-验证 is 的 WorkSpace 状态`AVAILABLE`。

 **输出** 

`CreateWorkspace.WorkspaceId`