Azure Runbook通过托管身份导出Exchange配置至Blob遇错求助

错误原因分析 #

• Az模块版本冲突：报错提示的get_SerializationSettings方法未实现，是Azure PowerShell（Az）模块版本不兼容或部分模块缺失导致的，自动化账户中默认的Az模块可能存在版本不一致的情况。
• 存储上下文获取失败：受模块问题影响，Get-AzStorageAccount返回的对象无法正确生成存储上下文，导致后续Blob上传操作报错。
• 本地文件路径问题：Runbook中直接使用Out-File "Get-OrganizationConfig.txt"会将文件写入自动化账户默认工作目录，可能存在权限或路径识别异常。

修复步骤 #

1. 统一自动化账户Az模块版本 #

在Azure自动化账户的模块页面，确保所有Az相关模块（尤其是Az.Resources、Az.Storage）版本一致：

• 删除冲突的旧版本模块，保留同一大版本的Az模块（例如全部使用Az 10.x系列）
• 若需手动导入，可通过Azure门户或PowerShell导入完整的Az模块包

2. 修改Runbook脚本 #

替换原脚本为以下版本，解决模块兼容、路径和上下文问题：

# 连接Exchange Online（托管身份）
Connect-ExchangeOnline -ManagedIdentity -Organization "empaysys.onmicrosoft.com"

# 定义变量
$resourceGroupName = "CGTraining"
$storageAccountName = "cjdesiredstateconfig"
$containerName = "config-exchange"
$blobName = "Get-OrganizationConfig-withMI.txt"
# 使用自动化账户临时目录存储文件
$tempFilePath = Join-Path -Path $env:TEMP -ChildPath "Get-OrganizationConfig.txt"

# 导出Exchange配置到临时文件
Get-OrganizationConfig | Out-File -Path $tempFilePath -Encoding UTF8

# 用托管身份连接Azure并设置上下文
Connect-AzAccount -Identity
Set-AzContext -Subscription "Pay-As-You-Go"

# 直接创建存储上下文（绕过Get-AzStorageAccount的模块兼容问题）
$storageContext = New-AzStorageContext -StorageAccountName $storageAccountName -UseConnectedAccount

# 上传Blob到存储账户
Set-AzStorageBlobContent -File $tempFilePath -Container $containerName -Blob $blobName -Context $storageContext -Force

# 清理临时文件
Remove-Item -Path $tempFilePath -Force

# 断开Exchange Online连接
Disconnect-ExchangeOnline -Confirm:$false

3. 验证权限与配置 #

• 确认自动化账户的系统托管身份已拥有目标存储账户的Blob Storage Data Contributor权限
• 确认Exchange Online的Exchange.ManageAsApp权限已正确授予（可通过Get-EXOMailbox等cmdlet测试权限有效性）

关键优化点 #

• 使用$env:TEMP指定临时文件路径，避免自动化账户工作目录的权限问题
• 改用New-AzStorageContext -UseConnectedAccount直接生成存储上下文，绕过Get-AzStorageAccount的模块兼容bug
• 添加文件清理步骤，避免Runbook重复执行时的文件冲突

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