EC2Launch を使用した Windows インスタンスの設定 - Amazon Elastic Compute Cloud
EC2Launch タスクEC2Launch のバージョンを確認します。EC2Launch のディレクトリ構造EC2Launch の設定

EC2Launch を使用した Windows インスタンスの設定

EC2Launch は、Windows Server 2016 以降の AMI で EC2Config サービスを置き換えた Windows PowerShell スクリプトのセットです。すべてのサポートされている Windows Server バージョンの最新の起動サービスは EC2Launch v2 です。これは、EC2Config と EC2Launch の両方を置き換えます。

目次

EC2Launch タスク

EC2Launch は最初のインスタンスの起動中に、デフォルトで以下のタスクを実行します。

  • インスタンスに関する情報をレンダリングする新しい壁紙を設定します。

  • コンピュータ名を設定します。

  • Amazon EC2 コンソールにインスタンス情報を送信します。

  • EC2 コンソールに RDP 証明書のサムプリントを送信します。

  • 管理者アカウントに、ランダムなパスワードを設定します。

  • DNS サフィックスを追加します。

  • オペレーティングシステムパーティションを動的に拡張して、未使用の領域が含まれるようにします。

  • ユーザーデータを実行します (指定された場合)。ユーザーデータを指定する方法については、「インスタンスユーザーデータの使用」を参照してください。

  • メタデータサービスと KMS サーバーに到達するために永続的な静的ルートを設定します。

    重要

    このインスタンスからカスタム AMI を作成している場合、これらのルートは OS 設定の一部としてキャプチャされます。また、AMI から起動された新しいインスタンスは、サブネットの位置に関係なく、同じルートを保持します。ルートを更新するには、「カスタム AMI の起動時に Server 2016 以降のメタデータ/KMS ルートを更新する」を参照してください。

以下のタスクは、EC2Config サービスとの下位互換性を維持するために役立ちます。また、起動中にこれらのタスクを実行するように EC2Launch を設定することもできます。

  • セカンダリ EBS ボリュームを初期化します。

  • EC2 コンソールのログに Windows イベントログを送信します。

  • Windows の使用準備ができている旨のメッセージを EC2 コンソールに送信します。

Windows Server 2019 の詳細については、Microsoft.com にある「Compare Features in Windows Server Versions (Windows Server 各バージョンの機能の比較)」を参照してください。

EC2Launch のバージョンを確認します。

インストールされている EC2Launch のバージョンを確認するには、次の Windows PowerShell コマンドを使用します。

PS C:\> Test-ModuleManifest -Path "C:\ProgramData\Amazon\EC2-Windows\Launch\Module\Ec2Launch.psd1" | Select Version

EC2Launch のディレクトリ構造

EC2Launch はデフォルトでは、Windows Server 2016 以降の AMI のルートディレクトリ C:\ProgramData\Amazon\EC2-Windows\Launch にインストールされます。

注記

Windows では、デフォルトで C:\ProgramData 以下のファイルとフォルダは非表示になります。EC2Launch のディレクトリとファイルを表示するには、Windows エクスプローラーにパスを入力するか、フォルダのプロパティを変更して、非表示のファイルとフォルダを表示する必要があります。

Launch ディレクトリには以下のサブディレクトリがあります。

  • Scripts — EC2Launch を構成する PowerShell スクリプトが格納されます。

  • Module — Amazon EC2 関連するスクリプトを構築するためのモジュールが格納されます。

  • Config — カスタマイズ可能なスクリプト設定ファイルが格納されます。

  • Sysprep — Sysprep リソースが格納されます。

  • Settings — Sysprep グラフィカルユーザーインターフェイスのアプリケーションが格納されます。

  • Logs — スクリプトによって生成されたログファイルが格納されます。

EC2Launch の設定

インスタンスが最初に初期化された後で、EC2Launch を再実行し、別の起動タスクを実行するよう EC2Launch を設定できます。

初期化タスクの設定

次の初期化タスクを有効または無効にするには、LaunchConfig.json ファイルで設定を指定します。

  • コンピュータ名を設定します。

  • 新しい壁紙を設定します。

  • DNS サフィックス一覧を追加します。

  • ブートボリュームサイズを拡大します。

  • 管理者パスワードを設定します。

初期設定を行うには

  1. 設定するインスタンスで、C:\ProgramData\Amazon\EC2-Windows\Launch\Config\LaunchConfig.json ファイルをテキストエディタで開きます。

  2. 必要に応じて次の設定を更新し、変更を保存します。adminPasswordtype が Specify である場合のみ、adminPasswordにパスワードを入力します。 

    {
  "setComputerName": false,
  "setWallpaper": true,
  "addDnsSuffixList": true,
  "extendBootVolumeSize": true,
  "handleUserData": true,                      
  "adminPasswordType": "Random | Specify | DoNothing",
  "adminPassword":  "password that adheres to your security policy (optional)"
}

    パスワードの種類は次のとおりです。

    Random

    EC2Launch は、ユーザーのキーを使用してパスワードを生成し、暗号化します。この設定はインスタンス起動後に無効になるため、インスタンスを再起動したり、停止して起動した場合でもパスワードは保持されます。

    Specify

    EC2Launch は、adminPassword で指定したパスワードを使用します。指定したパスワードがシステム要件を満たさない場合は、代わりに EC2Launch によってランダムなパスワードが生成されます。このパスワードはクリアテキストとして LaunchConfig.json に保存され、Sysprep で管理者パスワードが設定されると削除されます。EC2Launch は、ユーザーのキーを使用してパスワードを暗号化します。

    DoNothing

    EC2Launch は、unattend.xml ファイルで指定したパスワードを使用します。unattend.xml でパスワードを指定しない場合、管理者アカウントは無効になります。

  3. Windows PowerShell で次のコマンドを実行し、Windows のスケジュールされたタスクとしてスクリプトの実行をスケジュールします。スクリプトは次回の起動時に 1 回のみ実行され、以降、これらのタスクは再実行されなくなります。 

    PS C:\> C:\ProgramData\Amazon\EC2-Windows\Launch\Scripts\InitializeInstance.ps1 -Schedule

EC2Launch が起動ごとに実行されるようスケジュールします

最初の起動だけでなく、起動ごとに実行されるように EC2Launch をスケジュールすることができます。

EC2Launch を起動ごとに実行するには。

  1. Windows PowerShell を開き、次のコマンドを実行します。

    PS C:\> C:\ProgramData\Amazon\EC2-Windows\Launch\Scripts\InitializeInstance.ps1 -SchedulePerBoot

  2. または、次のコマンドを使用して、実行可能ファイルを実行します。

    PS C:\> C:\ProgramData\Amazon\EC2-Windows\Launch\Settings\Ec2LaunchSettings.exe

    次に、Run EC2Launch on every boot を選択します。You can specify that your EC2 インスタンスを Shutdown without Sysprep または Shutdown with Sysprep に指定できます。

注記

起動ごとに EC2Launch が実行されるように設定すると、次回 EC2Launch が実行されたときに LaunchConfig.json に次の変更が加えられます。

  • AdminPasswordType は、起動時にパスワードが変更されないように DoNothing に設定されます。

  • ユーザーデータの persist が true に設定されていない限り、HandleUserData は false に設定されます。ユーザーデータのスクリプトの詳細については、『Amazon EC2 ユーザーガイド』の「ユーザーデータスクリプト」を参照してください。

同様に、次の起動時にパスワードをリセットしない場合は、再起動する前に AdminPasswordType を DoNothing に設定する必要があります。

ドライブの初期化とドライブ文字のマッピング

ドライブ文字を EC2 インスタンスのボリュームにマッピングするには、DriveLetterMappingConfig.json ファイルで設定を指定します。スクリプトは、ドライブがすでに初期化およびパーティション化されていない場合、このオペレーションを実行します。

ドライブ文字をボリュームにマッピングするには

  1. テキストエディタで C:\ProgramData\Amazon\EC2-Windows\Launch\Config\DriveLetterMappingConfig.json ファイルを開きます。

  2. 次のボリューム設定を指定し、変更を保存します。

    {
  "driveLetterMapping": [
    {
      "volumeName": "sample volume",
      "driveLetter": "H"
    }
  ]
}

  3. Windows PowerShell を開き、次のコマンドを使用して、ディスクを初期化する EC2Launch スクリプトを実行します。

    PS C:\> C:\ProgramData\Amazon\EC2-Windows\Launch\Scripts\InitializeDisks.ps1

    インスタンスが起動するたびにディスクを初期化するには、-Schedule フラグを次のように追加します。 

    PS C:\> C:\ProgramData\Amazon\EC2-Windows\Launch\Scripts\InitializeDisks.ps1 -Schedule

EC2 コンソールへの Windows イベントログの送信

EC2 コンソールログに Windows イベントログを送信するには、EventLogConfig.json ファイルで設定を指定します。

Windows イベントログを送信するよう設定を指定するには

  1. インスタンスで、C:\ProgramData\Amazon\EC2-Windows\Launch\Config\EventLogConfig.json ファイルをテキストエディタで開きます。

  2. 次のログ設定を行い、変更を保存します。

    {
  "events": [
    {
      "logName": "System",
      "source": "An event source (optional)",
      "level": "Error | Warning | Information",
      "numEntries": 3
    }
  ]
}

  3. Windows PowerShell で次のコマンドを実行し、Windows のスケジュールされたタスクとして、インスタンスが起動されるたびにスクリプトの実行がスケジュールされるようにします。

    PS C:\> C:\ProgramData\Amazon\EC2-Windows\Launch\Scripts\SendEventLogs.ps1 -Schedule

    ログが EC2 コンソールログに表示されるまでには、3 分以上かかる場合があります。

正常に起動した後の Windows の準備が完了した旨のメッセージの送信

EC2Config サービスは、起動するたびに、Windows の準備が完了した旨のメッセージを EC2 コンソールに送信しました。EC2Launch は最初の起動後に、このメッセージを送信します。EC2Config サービスとの下位互換性のため、毎回の起動後にこのメッセージを送信するよう EC2Launch をスケジュールできます。インスタンスで Windows PowerShell を開き、次のコマンドを実行します。システムは、Windows のスケジュールされたタスクとして実行するようスクリプトをスケジュールします。 

PS C:\> C:\ProgramData\Amazon\EC2-Windows\Launch\Scripts\SendWindowsIsReady.ps1 -Schedule