ファイルと Windows レジストリインベントリで作業する - AWS Systems Manager

ファイルと Windows レジストリインベントリで作業する

AWS Systems Manager インベントリは、Windows、Linux、macOS オペレーティングシステムでファイルを検索し、インベントリできるようにします。Windows レジストリの検索およびインベントリもできます。

ファイル: ファイル名、ファイル作成時間、ファイルの最終変更時間および最新アクセス時間、およびファイルサイズなど多数のファイルに関するメタデータ情報を収集できます。ファイルインベントリの収集を開始するには、インベントリを実行するファイルパスを指定し、インベントリを行うファイルタイプを定義する 1 つ以上のパターン、そしてパスが再帰的にトラバースすべきかを指定します。Systems Manager は、パターンと一致する指定されたパスのファイルのすべてのファイルメタデータをインベントリします。ファイルインベントリは次の入力パラメータを使用します。

{
"Path": string,
"Pattern": array[string],
"Recursive": true,
"DirScanLimit" : number // Optional
}

  • パス: ファイルをインベントリするディレクトリパス。Windows の場合、変数が単一ディレクトリパスにマッピングする限りにおいて、%PROGRAMFILES% などの環境変数を使用できます。たとえば、複数のディレクトリパスをマッピングする %PATH% を使用すると、インベントリはエラーをスローします。

  • パターン: ファイルを識別するためのパターン配列。

  • 再帰的: インベントリが再帰的にディレクトリをトラバースすべきかを示すブール値。

  • DirScanLimit: スキャンするディレクトリ数を指定するオプションの値。このパラメータを使用して、マネージドノードのパフォーマンスへの影響を最小化します。デフォルトでは、インベントリは最大で 5000 ディレクトリまでをスキャンします。

注記

インベントリは、すべての指定したパスから最大で 500 ファイルのメタデータを収集します。

ここでは、ファイルのインベントリを実行する場合にどのようにパラメータを指定するかについての例をいくつか示します。

  • Linux および macOS では、すべてのサブディレクトリを除く、/home/ec2-user ディレクトリの .sh ファイルのメタデータを収集します。

    [{"Path":"/home/ec2-user","Pattern":["*.sh", "*.sh"],"Recursive":false}]

  • Windows では、サブディレクトリを再帰的に含む、プログラムファイルフォルダのすべての「.exe」ファイルのメタデータを収集します。

    [{"Path":"C:\Program Files","Pattern":["*.exe"],"Recursive":true}]

  • Windows では、特定のログパターンのメタデータを収集します。

    [{"Path":"C:\ProgramData\Amazon","Pattern":["*amazon*.log"],"Recursive":true}]

  • 再帰的収集を実行する場合には、ディレクトリの数を制限します。

    [{"Path":"C:\Users","Pattern":["*.ps1"],"Recursive":true, "DirScanLimit": 1000}]

Windows のレジストリ: Windows レジストリキーと値を収集することができます。キーパスを選択して、すべてのキーと値を再帰的に収集できます。指定するパスで指定するレジストリキーおよびその値を収集することもできます。インベントリは、キーパス、名前、タイプ、値を収集します。

{
"Path": string, 
"Recursive": true,
"ValueNames": array[string] // optional
}

  • パス: レジストリキーへのパス。

  • 再帰的: インベントリが再帰的にレジストリパスをトラバースすべきかを示すブール値。

  • ValueNames: レジストリキーのインベントリを実行する値名の配列。このパラメータを使用する場合、Systems Manager は指定するパスの指定する値名のみをインベントリします。

注記

インベントリは、すべての指定したパスから最大で 250 レジストリキー値を収集します。

ここでは、Windows レジストリのインベントリを実行する場合にどのようにパラメータを指定するかについての例をいくつか示します。

  • 指定したパスのすべてのキーと値を再帰的に収集します。

    [{"Path":"HKEY_LOCAL_MACHINE\SOFTWARE\Amazon","Recursive": true}]

  • 指定したパスのすべてのキーと値を収集します (再帰的検索無効)。

    [{"Path":"HKEY_LOCAL_MACHINE\SOFTWARE\Intel\PSIS\PSIS_DECODER", "Recursive": false}]

  • ValueNames オプションを使用して、指定するキーを収集します。

    {"Path":"HKEY_LOCAL_MACHINE\SOFTWARE\Amazon\MachineImage","ValueNames":["AMIName"]}