如何通过PowerShell Runbook更新指定Az模块并解决相关报错

一、先解决NuGet提供程序缺失问题 #

PowerShell 5.1环境中常出现NuGet版本不足或提供程序未正确注册的情况，先执行以下脚本强制安装指定版本的NuGet提供程序（无交互模式）：

# 强制安装符合要求的NuGet提供程序，跳过交互确认
Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force -Scope CurrentUser

# 验证安装结果
Get-PackageProvider -Name NuGet

如果还是提示找不到提供程序，尝试用全用户权限安装：

Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force -Scope AllUsers

二、无交互更新目标Az模块 #

默认Update-Module会触发交互确认，需添加参数跳过；同时先将PSGallery设为可信源避免签名验证报错：

# 将PowerShell Gallery设为可信源（仅需执行一次）
Set-PSRepository -Name PSGallery -InstallationPolicy Trusted

# 更新Az.Accounts至2.11.0+版本（兼容PowerShell 5.1）
Update-Module -Name Az.Accounts -MinimumVersion 2.11.0 -Force -SkipPublisherCheck

# 更新Az.SecurityInsights至3.0.1+版本
Update-Module -Name Az.SecurityInsights -MinimumVersion 3.0.1 -Force -SkipPublisherCheck

如果是首次安装模块而非更新，替换为Install-Module：

Install-Module -Name Az.Accounts -MinimumVersion 2.11.0 -Force -SkipPublisherCheck
Install-Module -Name Az.SecurityInsights -MinimumVersion 3.0.1 -Force -SkipPublisherCheck

三、自动化账户Runbook额外注意事项 #

• 确认Runbook运行时版本为PowerShell 5.1（在自动化账户门户的Runbook设置中选择）
• 确保Runbook使用的托管身份拥有Microsoft.Automation/automationAccounts/modules/write权限，避免模块更新时权限不足
• 若脚本方式仍有问题，可直接在自动化账户门户的「模块」页面，手动选中目标模块点击「更新」，选择兼容PowerShell 5.1的最新版本

四、极端场景下的NuGet提供程序修复 #

如果上述安装命令仍失败，手动下载并注册NuGet提供程序：

# 下载指定版本的NuGet提供程序包
$nugetPackageUrl = "https://www.nuget.org/api/v2/package/NuGet.Provider/2.8.5.201"
$tempPath = Join-Path $env:TEMP "NuGetProvider"
New-Item -Path $tempPath -ItemType Directory -Force | Out-Null
Invoke-WebRequest -Uri $nugetPackageUrl -OutFile (Join-Path $tempPath "NuGetProvider.nupkg")

# 解压并导入提供程序
Expand-Archive -Path (Join-Path $tempPath "NuGetProvider.nupkg") -DestinationPath $tempPath -Force
$providerPath = Join-Path $tempPath "tools\NuGet.psd1"
Import-Module $providerPath -Force

内容的提问来源于stack exchange，提问作者dev333