使用文件和 Windows 注册表清单 - AWS Systems Manager

使用文件和 Windows 注册表清单

借助 AWS Systems Manager Inventory 清单可以搜索和清点 Windows、Linux 及 macOS 操作系统上的文件。您还可以搜索并清点 Windows 注册表。

文件：您可以收集关于文件的元数据信息，包括文件名称、文件创建时间、文件上次修改和访问时间以及文件大小等等。要开始收集文件清单，您需要指定要执行清点的文件路径、用于定义要清点的文件类型的一个或多个模式，以及是否应以递归的方式遍历路径。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"]}