翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# `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)

**ドキュメントタイプ**

Automation

**[所有者]**

Amazon

**[Platforms]** (プラットフォーム)

Windows

**パラメータ**
+ AllowOffline

  タイプ: 文字列

  有効な値: true \$1 false

  デフォルト: false

  説明: (オプション) オンラインのトラブルシューティングが失敗した場合や、提供されたインスタンスがマネージドインスタンスでない場合に、オフラインの Windows がアクティベーションを修復することを許可する場合は、`true` に設定します。
**重要**  
オフライン方式では、指定された EC2 インスタンスを停止してから起動する必要があります。インスタンスストアボリュームに保存されているデータは失われます。Elastic IP を使用していない場合、パブリック IP アドレスが変わります。
+ AutomationAssumeRole

  タイプ: 文字列

  説明: (オプション) Systems Manager Automation がユーザーに代わってアクションを実行できるようにする AWS Identity and Access Management (IAM) ロールの Amazon リソースネーム (ARN)。ロールを指定しない場合、Systems Manager Automation はこのランブックを開始するユーザーのアクセス許可を使用します。
+ ForceActivation

  タイプ: 文字列

  有効な値: true \$1 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` を実行して PowerShell スクリプトを実行し、Windows アクティベーションの修正を試みることができます。

   1. (オフラインアクティベーション修正) 入力インスタンスがマネージドインスタンスでない場合。

      1. `aws:assertAwsResourceProperty` - `AllowOffline` フラグが `true` に設定されていることを確認します。これが設定されている場合、オフラインでの修復が開始されます。そうでない場合、オートメーションが終了します。

      1. `aws:executeAutomation` - Windows のアクティベーションオフライン修復スクリプトで `AWSSupport-StartEC2RescueWorkflow` を呼び出します。このスクリプトは、OS のバージョンに応じて、EC2Config または EC2Launch のどちらかを使用します。

      1. `aws:executeAwsApi` - `AWSSupport-StartEC2RescueWorkflow` から結果を読み込みます。

 **出力** 

activateWindows.Output

getActivateWindowsOfflineResult.Output