기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

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

 **설명** 

 `AWS-CreateWorkSpace` 실행서는 입력 파라미터에 대해 지정하는 값을 기반으로 WorkSpace라고 하는 새로운 Amazon WorkSpaces 가상 데스크톱을 생성합니다. WorkSpaces에 대한 자세한 내용은 *Amazon WorkSpaces 관리 안내서*의 [Amazon WorkSpaces란 무엇입니까?](https://docs.aws.amazon.com/workspaces/latest/adminguide/amazon-workspaces.html)를 참조하세요.

 [이 자동화 실행(콘솔)](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

  유형: 문자열

  설명: (필수) WorkSpace에 사용할 번들의 ID입니다.
+ ComputeTypeName

  유형: 문자열

  유효한 값: VALUE \$1 STANDARD \$1 PERFORMANCE \$1 POWER \$1 GRAPHICS \$1 POWERPRO \$1 GRAPHICSPRO

  설명: (선택 사항) WorkSpace의 컴퓨팅 유형입니다.
+ DirectoryId

  유형: 문자열

  설명: (필수) WorkSpace를 추가할 디렉터리의 ID입니다.
+ RootVolumeEncryptionEnabled

  유형: Boolean

  유효한 값: true \$1 false

  기본값: false

  설명: (선택 사항) WorkSpace의 루트 볼륨이 암호화되는지 여부를 결정합니다.
+ RootVolumeSizeGib

  유형: 정수

  설명: (필수) WorkSpace에 대한 루트 볼륨의 크기입니다.
+ RunningMode

  유형: 문자열

  유효한 값: ALWAYS\$1ON \$1 AUTO\$1STOP

  설명: (필수) WorkSpace의 실행 모드입니다.
+ RunningModeAutoStopTimeoutInMinutes

  유형: 정수

  설명: (선택 사항) WorkSpaces가 중지될 때 사용자가 로그오프한 후의 시간입니다. 60분 간격으로 값을 지정합니다.
+ Tags

  유형: 문자열

  설명: (선택 사항) WorkSpace에 적용하려는 태그입니다.
+ UserName

  유형: 문자열

  설명: (필수) WorkSpace에 연결할 사용자 이름입니다.
+ UserVolumeEncryptionEnabled

  유형: Boolean

  유효한 값: true \$1 false

  기본값: false

  설명: (선택 사항) WorkSpace의 사용자 볼륨이 암호화되는지 여부를 결정합니다.
+ UserVolumeSizeGib

  유형: 정수

  설명: (필수) WorkSpace의 사용자 볼륨 크기입니다.
+ VolumeEncryptionKey

  유형: 문자열

  설명: (선택 사항) WorkSpace에 저장된 데이터를 암호화하는 데 사용할 대칭 AWS Key Management Service 키입니다.

**필수 IAM 권한**

실행서를 성공적으로 사용하려면 `AutomationAssumeRole` 파라미터에 다음 작업이 필요합니다.
+  `workspaces:CreateWorkspaces` 
+  `workspaces:DescribeWorkspaces` 

 **문서 단계** 
+  `aws:executeScript` - 입력 파라미터에 대해 지정하는 값을 기반으로 WorkSpace를 생성합니다.
+  `aws:waitForAwsResourceProperty` - WorkSpace의 상태가 `AVAILABLE`인지 확인합니다.

 **출력** 

`CreateWorkspace.WorkspaceId`