Azure Key Vault备份脚本优化求助：函数式脚本报错排查

核心问题分析 #

• 函数调用语法错误：PowerShell中调用函数不能使用函数名(参数1,参数2)的格式，这种写法会把数组作为第一个参数传入，导致第二个参数$VaultName为空，进而让az keyvault $Item list中的$Item异常（甚至为空），触发你看到的'' is misspelled or not recognized错误。同时$Vaults是az keyvault list返回的对象集合，直接遍历拿到的是完整对象，需要取其.Name属性作为Vault名称。
• 变量名冲突：函数参数定义了$Item，但循环遍历$Items时又用$Item作为循环变量，覆盖了参数传入的类型值（secret/certificate/key），导致后续az keyvault $Item backup中的$Item变成具体的密钥/证书对象，而非命令所需的资源类型字符串。
• 文件路径错误：备份路径$Item/$Name.txt中$Name未定义，应该使用$Item.Name；另外未提前创建目录，直接写入会报错路径不存在。

修复后的脚本 #

function Get-Backup{
    [CmdletBinding()]
    param (
        [Parameter(Mandatory=$true)]
        [string]$ItemType,
        [Parameter(Mandatory=$true)]
        [string]$VaultName
    )

    # 创建分层备份目录，确保路径存在
    $backupDir = ".\KeyVaultBackups\$VaultName\$ItemType"
    if (-not (Test-Path $backupDir)) {
        New-Item -ItemType Directory -Path $backupDir | Out-Null
    }

    $Items = az keyvault $ItemType list --vault-name $VaultName | ConvertFrom-Json
    foreach ($item in $Items) {
        $backupPath = Join-Path $backupDir "$($item.Name).bak"
        az keyvault $ItemType backup --vault-name $VaultName --name $item.Name --file $backupPath
    }
}

# 遍历订阅内所有Key Vault执行备份
$Vaults = az keyvault list | ConvertFrom-Json
foreach ($vault in $Vaults) {
    $vaultName = $vault.Name
    Get-Backup -ItemType "secret" -VaultName $vaultName
    Get-Backup -ItemType "certificate" -VaultName $vaultName
    Get-Backup -ItemType "key" -VaultName $vaultName
}

关键修复点说明 #

1. 重命名函数参数为$ItemType，彻底避免与循环变量的命名冲突
2. 使用PowerShell标准的命名参数调用函数，确保参数传递准确
3. 新增目录创建逻辑，按「Vault名称+资源类型」分层存储备份文件，避免路径不存在错误
4. 用Join-Path处理路径，确保跨平台兼容性，同时用资源名称作为备份文件名
5. 给参数添加强制约束和类型限制，避免传入无效值

内容的提问来源于stack exchange，提问作者Călimanu Loredan