Azure 自动化的 Runbook 和模块库

无需在 Azure 自动化中创建自己的 Runbook 和模块,即可访问 Microsoft 和社区构建的各种方案。 可以在不加以修改的情况下直接使用这些方案,或者使用它们作为起点并根据具体的要求进行编辑。

可以从 Runbook 库获取 Runbook,并从PowerShell 库获取模块。 还可以通过共享开发的方案来为社区做出贡献。

Runbook 库提供各种来自 Microsoft 和社区的 Runbook,可将其导入 Azure 自动化中。 可以从 TechNet 脚本中心托管的库下载 Runbook,也可以在 Azure 门户中直接从该库导入 Runbook。

直接从 Runbook 库导入只能使用 Azure 门户来完成。 而不能使用 Windows PowerShell 执行此功能。

Note

应验证从 Runbook 库获取的任何 Runbook 的内容,在生产环境中安装和运行这些 Runbook 时,请谨慎操作。

  1. 在 Azure 门户中,打开自动化帐户。
  2. 在“流程自动化”下,单击“Runbook 库”
  3. 找到所需的库项,选择它以查看其详细信息。 在左侧可以输入发布者和类型的其他搜索参数。

    浏览库

  4. 单击“查看源项目”以在 TechNet 脚本中心查看该项。
  5. 要导入项,请单击它以查看其详细信息,并单击“导入”按钮。

    “导入”按钮

  6. 可选择更改 Runbook 的名称,并单击“确定”导入该 Runbook。
  7. Runbook 将出现在自动化帐户的“Runbook”选项卡中。

将 Runbook 添加到 Runbook 库

Microsoft 建议你将 Runbook 添加到你认为对其他客户有用的 Runbook 库中。 可以通过连同以下详细信息将 Runbook 上传到脚本中心,来添加 Runbook。

  • 必须为向导中要显示的 Runbook 指定“Microsoft Azure”作为“类别”,指定“自动化”作为“子类别”。
  • 上传内容必须是单个 .ps1 或 .graphrunbook 文件。 如果 Runbook 需要任何模块、子 Runbook 或资产,则你应该在提交内容的说明和 Runbook 的注释部分列出这些内容。 如果方案需要多个 Runbook,请单独上传每个 Runbook 并在各自的说明中列出相关 Runbook 的名称。 请确保使用相同的标记,以便它们在同一类别中显示。 用户阅读说明后才会知道,方案要正常工作需要其他 Runbook。
  • 如果要发布“图形 Runbook”(非图形工作流),则添加标记“GraphicalPS”。
  • 使用“插入代码段”图标将 PowerShell 或 PowerShell 工作流代码片段插入说明中。
  • Runbook 库结果中会显示上传摘要,因此,应该提供详细信息,以帮助用户明确 Runbook 的功能。
  • 应该为上传内容分配一到三个以下标记。 Runbook 会在向导中与标记匹配的类别下列出。 该向导忽略不在此列表中的所有标记。 如果未指定任何匹配的标记,则 Runbook 会在“其他”类别下列出。

    • Backup
    • 容量管理
    • 更改控制
    • 合规性
    • 开发/测试环境
    • 灾难恢复
    • 监视
    • 修补
    • 设置
    • 补救
    • VM 生命周期管理
  • 自动化每小时更新一次该库,因此,无法立即看见上传内容。

PowerShell 模块包含可以在 Runbook 中使用的 cmdlet,并可以在 PowerShell 库中找到可在 Azure 自动化中安装的现有模块。 可以从 Azure 门户启动此库,并将这些模块直接安装到 Azure 自动化中,也可以下载并手动安装这些模块。

  1. 在 Azure 门户中,打开自动化帐户。
  2. 在“共享资源”中选择“模块”,打开模块列表。
  3. 请单击页面顶部的“浏览全部”。

    模块库

  4. 在“浏览库”页,可以按以下字段进行搜索:

    • 模块名称
    • 标记
    • 作者
    • Cmdlet/DSC 资源名称
  5. 找到感兴趣的模块并选择它以查看其详细信息。
    当钻取到特定模块时,可以查看有关该模块的详细信息,其中包含返回 PowerShell 库的链接、任何必需的依赖项,以及该模块包含的所有 cmdlet 和/或 DSC 资源。

    PowerShell 模块详细信息

  6. 要直接将模块安装到 Azure 自动化中,请单击“导入”按钮。
  7. 在“导入”页中单击“导入”按钮时,会看到将要导入的模块名称。 如果安装了所有依赖项,“确定”按钮将处于活动状态。 如果缺少依赖项,则需要在导入此模块前导入这些依赖项。
  8. 在“导入”页上,单击“确定”导入模块。 Azure 自动化将模块导入帐户时,它提取有关该模块和 cmdlet 的元数据。 这可能需要几分钟才能完成,因为需要提取每个活动。
  9. 将收到正在部署该模块的初始通知;完成此过程后,还会收到另一通知。
  10. 导入模块后,会看到可用的活动,并可以在 Runbook 和 Desired State Configuration 中使用其资源。

后续步骤