PowerShell脚本函数外正常运行，函数内$vmBackupReport变量为空

核心原因与对应解决方案 #

1. 变量作用域限制 #

PowerShell函数默认使用私有作用域，函数内定义的$vmBackupReport无法直接被外部访问。解决方式二选一：

• 在函数内使用全局作用域声明变量：$global:vmBackupReport = @()
• 让函数返回结果，外部通过赋值接收：$vmBackupReport = createReport

2. 环境上下文未正确切换 #

跨测试/预生产、生产环境查询时，函数内未切换对应Azure订阅/租户，导致查询范围错误。需在函数内根据环境参数切换上下文：

switch ($EnvironmentName) {
    'Test' { Set-AzContext -Subscription "测试订阅ID" | Out-Null }
    'Prod' { Set-AzContext -Subscription "生产订阅ID" | Out-Null }
}

3. 数据收集逻辑遗漏或参数错误 #

检查函数内是否完整保留了外部运行时的所有步骤：

• 确认Get-AzRecoveryServicesVault、Get-AzRecoveryServicesBackupContainer等命令的参数与外部一致
• 排查是否遗漏了设置恢复服务 vault 上下文的步骤：Set-AzRecoveryServicesVaultContext -Vault $vault

4. 错误被静默抑制 #

函数内若使用-ErrorAction SilentlyContinue，会掩盖查询失败的错误。可临时移除该参数，或添加Write-Verbose输出中间结果，定位哪一步未获取到数据：

Write-Verbose "当前处理Vault: $($vault.Name)"

5. 返回值被意外覆盖 #

函数最后一行的输出会作为返回值，若最后一行是其他命令（如Set-AzContext），会覆盖$vmBackupReport。需确保函数末尾明确返回目标变量：

return $vmBackupReport

修正后的示例函数 #

function createReport {
    param(
        [Parameter(Mandatory=$true)]
        [string]$EnvironmentName
    )

    # 切换对应环境的Azure上下文
    switch ($EnvironmentName) {
        'Test' { Set-AzContext -Subscription "测试订阅ID" | Out-Null }
        'Prod' { Set-AzContext -Subscription "生产订阅ID" | Out-Null }
    }

    $vmBackupReport = @()
    $vaults = Get-AzRecoveryServicesVault

    foreach ($vault in $vaults) {
        Set-AzRecoveryServicesVaultContext -Vault $vault
        $containers = Get-AzRecoveryServicesBackupContainer -ContainerType AzureVM -Status Registered
        
        foreach ($container in $containers) {
            $backups = Get-AzRecoveryServicesBackupItem -Container $container -WorkloadType AzureVM
            
            foreach ($backup in $backups) {
                $latestRestorePoint = Get-AzRecoveryServicesBackupRecoveryPoint -Item $backup | Select-Object -First 1
                $vmBackupReport += [PSCustomObject]@{
                    VMName = $backup.Name
                    VaultName = $vault.Name
                    LatestBackupTime = $latestRestorePoint.RecoveryPointTime
                    BackupStatus = $backup.ProtectionStatus
                }
            }
        }
    }

    return $vmBackupReport
}

# 调用函数获取不同环境的备份报告
$testBackupReport = createReport -EnvironmentName 'Test'
$prodBackupReport = createReport -EnvironmentName 'Prod'

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