Azure Runbook报错：订阅名称不存在 求助排查

报错详情 #

抛出'System.Exception'类型异常。
订阅名称XXXX不存在。
参数名: name

核心问题分析 #

你的脚本使用的是Azure Service Management (ASM) 模块的旧命令（如Set-AzureSubscription、Select-AzureSubscription），而当前Azure自动化环境默认适配Azure Resource Manager (ARM) 模型，且Import-AzurePublishSettingsFile这种认证方式已被废弃，这是导致订阅识别失败的主要原因。此外还有几个可能的触发点：

• Import-AzurePublishSettingsFile加载的凭据文件未包含目标订阅信息
• 订阅名称存在大小写、空格或特殊字符的匹配偏差
• 自动化账户的运行身份没有目标订阅的访问权限

解决方法及脚本修正 #

1. 核心调整方向 #

替换所有ASM命令为Az模块命令（ASM已停止官方支持），并使用自动化账户的托管身份进行认证，摒弃过时的PublishSettings文件认证方式。

2. 修正后的Runbook脚本 #

[CmdletBinding()]
param(
    [Parameter(Mandatory=$true)]
    [string]$DatabaseName
)

# 配置参数
$storageAccountName = 'xxxxxxxxxxxxxxxxxxx'
$databaseContainer = 'xxxxxxxxxxxxxxxxxxx'
$databaseServerName = 'xxxxxxxxxxxxxxxxxxx'
$databaseUserName = 'xxxxxxxxxxxxxxxxxxx'
$subscriptionId = '你的订阅ID' # 优先用订阅ID替代名称，避免匹配问题
$sqlResourceGroupName = 'SQL服务器所属资源组名称'
$storageResourceGroupName = '存储账户所属资源组名称'

$BlobName =  "${DatabaseName}_$(get-date -f yyyy-MM-dd).bacpac"

Write-Output "BlobName: $BlobName"

# 使用自动化账户托管身份认证
Connect-AzAccount -Identity

# 切换到目标订阅（ID匹配无歧义）
Set-AzContext -SubscriptionId $subscriptionId

# 从自动化凭据资产获取数据库密码（避免交互式输入）
$dbCredentialAsset = Get-AutomationPSCredential -Name '你的数据库凭据资产名称'
$databaseCredentials = [System.Management.Automation.PSCredential]::new($databaseUserName, $dbCredentialAsset.Password)

# 获取存储账户密钥并创建上下文
$storageKey = (Get-AzStorageAccountKey -ResourceGroupName $storageResourceGroupName -Name $storageAccountName).Value[0]
$storageContext = New-AzStorageContext -StorageAccountName $storageAccountName -StorageAccountKey $storageKey

# 启动SQL数据库导出任务（ARM模型命令）
$exportRequest = Start-AzSqlDatabaseExport `
    -ResourceGroupName $sqlResourceGroupName `
    -ServerName $databaseServerName `
    -DatabaseName $DatabaseName `
    -StorageKeyType StorageAccessKey `
    -StorageKey $storageKey `
    -StorageUri "https://$storageAccountName.blob.core.windows.net/$databaseContainer/$BlobName"

# 轮询导出状态
do {
    Start-Sleep -s 60
    $status = Get-AzSqlDatabaseImportExportStatus -OperationStatusLink $exportRequest.OperationStatusLink
    Write-Output "Request Status: $($status.Status)"

    if($status.Status -eq "Failed") {
        Write-Output "Error message: $($status.ErrorMessage)"
        break
    }
} while ($status.Status -ne 'Completed')

Write-Output "导出任务完成"

3. 配套配置步骤 #

• 在自动化账户中创建凭据资产，存储数据库用户名和密码，替代脚本中的交互式Get-Credential（Runbook无法弹出输入框）
• 为自动化账户的托管身份分配权限：至少需要SQL数据库的导出权限、存储账户的Blob写入权限
• 确认订阅ID的准确性，可在Azure门户订阅详情页复制获取

关键注意事项 #

• Import-AzurePublishSettingsFile已被Azure官方废弃，不再支持新订阅的认证需求
• ASM模块命令仅适配经典部署模型的资源，若你的SQL数据库是ARM模型，必须使用Az模块命令

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