在自动化中更新 Azure PowerShell 模块

默认情况下,每个自动化帐户中都提供最常见的 PowerShell 模块。 请参阅默认模块。 由于 Azure 团队会定期更新 Azure 模块,因此包含的 cmdlet 可能会发生更改。 这些更改(例如,重命名参数或完全弃用 cmdlet)可能会对 Runbook 产生负面影响。

注意

不能删除全局模块,它们是自动化开箱提供的模块。

重要

通过新的运行时环境体验,可以通过配置作业执行环境来管理模块和包。 在新体验中,“模块和包”边栏选项卡不可用。

设置自动化帐户

为了避免影响 Runbook 及其自动化过程,请在继续操作之前进行测试和验证。 如果没有用于此目的专用自动化帐户,请考虑创建一个自动化帐户,以便可以在 Runbook 开发期间测试许多不同的方案。 该测试应该包括更新 PowerShell 模块等迭代更改。

确保自动化帐户已添加系统分配的托管标识或用户分配的托管标识

如果在本地开发脚本,建议测试时在本地使用与自动化帐户中相同的模块版本,以确保收到相同的结果。 在验证结果并且应用了所需的任何更改之后,则可将更改移到生产环境。

注意

新自动化帐户可能不包含最新的模块。

更新 Az 模块

以下部分说明了如何通过“门户”(建议)或 runbook 更新 Az 模块。

通过门户更新 Az 模块

目前,仅可以通过门户更新 AZ 模块。 将来会提供通过 PowerShell 和 ARM 模板进行的更新。 执行以下步骤时,只会更新默认的 Az 模块:

  1. 登录到 Azure 门户,并导航到自动化帐户。

  2. 共享资源下,选择模块

  3. 选择更新 Az 模块

  4. 选择“要更新的模块”。 默认情况下,它将显示 Az 模块。

  5. 从下拉列表中,选择“模块版本”和“Runtype 版本”

  6. 选择“更新”,将 Az 模块更新到你所选择的版本。 在“模块”页上,可查看如下列表:

    包含选择内容的“更新 AZ 模块”页面。

如果你选择的版本低于自动化帐户中导入的现有 Az 模块版本,则更新操作将执行回退到选定的低版本的操作。

可以通过检查“PowerShell 模块”下“模块”列表中显示的更新模块的模块版本和状态属性验证更新操作 。

Azure 团队将定期更新模块版本,并通过从下拉列表中选择模块版本来提供更新默认 Az 模块的选项。

通过 runbook 更新 Az 模块

若要在自动化帐户中更新 Azure 模块:

  1. 使用开源提供的 Update-AutomationAzureModulesForAccount runbook。
  2. 从 GitHub 存储库下载,以开始使用此 runbook 更新 Azure 模块。
  3. 将其导入到自动化帐户,或将其作为脚本运行。 若要了解如何在自动化帐户中导入 Runbook,请参阅导入 Runbook

注意

建议通过 Azure 门户更新 Az 模块。 也可以使用 Update-AutomationAzureModulesForAccount 脚本执行此操作,该脚本作为开放源代码及参考提供。 但是,如果出现任何 runbook 故障,需要根据需要修改 runbook 中的参数或根据场景调试脚本。

默认情况下,Update-AutomationAzureModulesForAccount Runbook 支持更新 Azure、AzureRM 和 Az 模块。 若要详细了解如何通过此 Runbook 更新 Az.Automation 模块,请查看更新 Azure 模块 Runbook 自述文件。 在自动化帐户中使用 Az 模块时,还需要考虑其他重要因素。 若要了解更多信息,请参阅在 Azure 自动化中管理模块

使用更新 Runbook 代码作为常规 PowerShell 脚本

你可以使用 Runbook 代码作为常规 PowerShell 脚本而非 Runbook。 为此,请先使用 Connect-AzAccount cmdlet 登录到 Azure,然后将 -Login $false 传递给脚本。

使用更新 runbook

使用 AzEnvironment 参数将正确的环境传递给 runbook。 可接受的值为 AzureChinaCloud。 可通过使用 Get-AzEnvironment | select Name 来检索这些值。

使用更新 Runbook 更新特定模块版本

若要使用特定的 Azure PowerShell 模块版本而不是 PowerShell 库中的最新可用版本,请将这些版本传递给 Update-AutomationAzureModulesForAccount Runbook 的可选 ModuleVersionOverrides 参数。 有关示例,请参阅 Update-AutomationAzureModulesForAccount.ps1 Runbook。 ModuleVersionOverrides 参数中未提及的 Azure PowerShell 模块会更新为 PowerShell 库中的最新模块版本。 如果没有向 ModuleVersionOverrides 参数传递任何内容,则所有模块都会更新为 PowerShell 库中的最新模块版本。 此行为与 Azure 门户中的“更新 Azure 模块”按钮的行为相同。

后续步骤