

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

# `AWSSupport-ActivateWindowsWithAmazonLicense`
<a name="automation-awssupport-activatewindowswithamazonlicense"></a>

 **설명** 

`AWSSupport-ActivateWindowsWithAmazonLicense` 실행서는 Amazon에서 제공하는 라이선스를 사용하여 Windows Server에 대한 Amazon Elastic Compute Cloud(Amazon EC2) 인스턴스를 활성화합니다. 자동화는 필수 키 관리 서비스 운영 체제 설정을 확인 및 구성하고 활성화를 시도합니다. 여기에는 Amazon의 키 관리 서버로 라우팅되는 운영 체제 경로와 키 관리 서비스 운영 체제 설정이 포함됩니다. `AllowOffline` 파라미터를 로 설정`true`하면 자동화가에서 관리하지 AWS Systems Manager않지만 인스턴스를 중지하고 시작해야 하는 인스턴스를 성공적으로 대상으로 지정할 수 있습니다.

**참고**  
이 실행서는 기존 보유 라이선스 사용(BYOL) 모델 Windows Server 인스턴스에서 사용할 수 없습니다. 본인 소유의 라이선스 사용에 대한 자세한 내용은 [AWS에서의 Microsoft 라이선스](https://aws.amazon.com/windows/resources/licensing/)를 참조하시오.

[이 자동화 실행(콘솔)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-ActivateWindowsWithAmazonLicense)

**문서 유형**

자동화

**소유자**

Amazon

**플랫폼**

Windows

**파라미터**
+ AllowOffline

  유형: 문자열

  유효한 값: true \| false

  기본값: false

  설명: (선택 사항) 온라인 문제 해결에 실패하거나 제공된 인스턴스가 관리형 인스턴스가 아닌 경우 오프라인으로 Windows 정품 인증을 수정할 수 있도록 하려면 `true`로 설정합니다.
**중요**  
오프라인 방법을 사용하려면 제공된 EC2 인스턴스를 중지했다가 다시 시작해야 합니다. 인스턴스 스토어 볼륨에 저장되어 있는 데이터가 손실됩니다. 탄력적 IP를 사용하지 않는 경우 퍼블릭 IP 주소가 변경됩니다.
+ AutomationAssumeRole

  유형: 문자열

  설명: (선택 사항) 사용자를 대신하여 Systems Manager Automation을 통해 작업을 수행할 수 있도록 허용하는 AWS Identity and Access Management (IAM) 역할의 Amazon 리소스 이름(ARN)입니다. 역할을 지정하지 않은 경우, Systems Manager Automation에서는 이 실행서를 시작하는 사용자의 권한을 사용합니다.
+ ForceActivation

  유형: 문자열

  유효한 값: true \| false

  기본값: false

  설명: (선택 사항) Windows가 이미 정품 인증되었더라도 계속 진행하려면 `true`로 설정합니다.
+ InstanceId

  유형: 문자열

  설명: (필수) Windows Server에 대한 관리형 EC2 인스턴스의 ID입니다.
+ SubnetId

  유형: 문자열

  기본값: CreateNewVPC

  설명: (선택 사항) 오프라인 전용 - 오프라인 문제 해결을 수행하는 데 사용하는 EC2Rescue 인스턴스용 서브넷 ID. 인스턴스와 동일한 서브넷을 사용하려면 `SelectedInstanceSubnet`을 사용하고, 새 VPC를 생성하려면 `CreateNewVPC`를 사용합니다. 중요: 서브넷이 InstanceId와 동일한 가용 영역이어야 하며 SSM 엔드포인트와의 통신을 허용해야 합니다.

**필수 IAM 권한**

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

이 명령을 수신하는 EC2 인스턴스에 **AmazonSSMManagedInstanceCore** Amazon 관리형 정책이 연결된 IAM 역할이 있는 것이 좋습니다. 자동화를 실행하고 인스턴스로 명령을 전송하려면 적어도 **ssm:StartAutomationExecution** 및 **ssm:SendCommand**가 있어야 하며, 추가로 자동화 출력을 읽을 수 있으려면 **ssm:GetAutomationExecution**도 있어야 합니다. 오프라인 수정에 대해서는 `AWSSupport-StartEC2RescueWorkflow`에서 필요한 권한을 참조하세요.

 **문서 단계** 

1. `aws:assertAwsResourceProperty` - 제공된 인스턴스의 플랫폼이 Windows인지 확인합니다.

1. `aws:assertAwsResourceProperty` - 제공된 인스턴스가 관리형 인스턴스인지 확인합니다.

   1. (온라인 정품 인증 수정) 입력 인스턴스가 관리형 인스턴스인 경우 `aws:runCommand`을 실행하여 Windows 정품 인증을 수정하는 PowerShell 스크립트를 실행합니다.

   1. (오프라인 정품 인증 수정) 입력 인스턴스가 관리형 인스턴스가 아닌 경우:

      1. `aws:assertAwsResourceProperty` - `AllowOffline` 플래그가 `true`으로 설정되었는지 확인합니다. 만일 그렇다면 오프라인 수정이 시작되며, 그렇지 않은 경우 자동화가 종료됩니다.

      1. `aws:executeAutomation` - Windows 정품 인증 오프라인 수정 스크립트를 사용하여 `AWSSupport-StartEC2RescueWorkflow`를 호출합니다. 이 스크립트는 OS 버전에 따라 EC2Config 또는 EC2Launch 중 하나를 사용합니다.

      1. `aws:executeAwsApi` - `AWSSupport-StartEC2RescueWorkflow`에서 결과를 읽습니다.

 **출력** 

activateWindows.Output

getActivateWindowsOfflineResult.Output