如何从PowerShell函数返回多个变量（HTML表与布尔值）

下面提供三种可行的方式，解决你的函数需要同时返回HTML表格和布尔变量的问题：

1. 返回自定义PSObject（推荐） #

这是最清晰直观的方式，将两个结果封装为自定义对象的属性，调用后通过属性直接访问。

function Request-API {
    param(
        [Parameter(Mandatory)]
        [string]$TagName
    )

    # 调用API获取JSON数据（替换为你的实际API调用逻辑）
    $apiData = Invoke-RestMethod -Uri "https://your-api-endpoint/tags/$TagName" -Method Get

    # 生成HTML表格
    $htmlTable = $apiData | ConvertTo-Html -As Table -Fragment

    # 判断是否存在小于1的值
    $hasLowValue = [bool]($apiData | Where-Object { $_ -lt 1 } | Select-Object -First 1)

    # 返回包含两个结果的自定义对象
    [PSCustomObject]@{
        HtmlTable = $htmlTable
        SubjectCheck = $hasLowValue
    }
}

# 调用示例
$apiResult = Request-API -TagName "your-tag"
# 获取HTML表格
$apiResult.HtmlTable
# 获取布尔判断结果
$apiResult.SubjectCheck

2. 返回结果数组 #

将多个结果按顺序放入数组返回，调用时按对应顺序接收变量。

function Request-API {
    param(
        [Parameter(Mandatory)]
        [string]$TagName
    )

    $apiData = Invoke-RestMethod -Uri "https://your-api-endpoint/tags/$TagName" -Method Get
    $htmlTable = $apiData | ConvertTo-Html -As Table -Fragment
    $hasLowValue = [bool]($apiData | Where-Object { $_ -lt 1 })

    # 按顺序返回两个结果
    return $htmlTable, $hasLowValue
}

# 调用示例（注意变量顺序要和返回顺序一致）
$htmlOutput, $subjectCheck = Request-API -TagName "your-tag"

3. 使用引用参数（[ref]） #

通过引用参数传递布尔变量，函数内部直接修改其值，同时返回HTML表格。

function Request-API {
    param(
        [Parameter(Mandatory)]
        [string]$TagName,
        [Parameter(Mandatory)]
        [ref]$SubjectCheck
    )

    $apiData = Invoke-RestMethod -Uri "https://your-api-endpoint/tags/$TagName" -Method Get
    $htmlTable = $apiData | ConvertTo-Html -As Table -Fragment

    # 修改引用参数的Value属性，外部变量会同步更新
    $SubjectCheck.Value = [bool]($apiData | Where-Object { $_ -lt 1 })

    # 返回HTML表格
    return $htmlTable
}

# 调用示例
$checkResult = $false
$htmlOutput = Request-API -TagName "your-tag" -SubjectCheck ([ref]$checkResult)
# 此时$checkResult已被函数更新为实际判断结果

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