PowerShell函数返回变量类型异常：Int64变为Object[]

PowerShell函数的返回机制不是仅返回return语句指定的值，而是会收集所有输出到Success流的内容，将它们组合成一个数组返回（如果有多个输出的话）。

从你的运行输出可以看到，$asset_id包含两个元素：{"success":true,"message":null}和140863，说明你的one函数内部除了return $assetId的输出外，还有另一段输出（那个JSON对象）被写入了Success流，最终两者被合并成Object[]类型的数组返回。

你需要检查函数内部是否存在未被捕获的输出：

• 有没有命令的结果没有赋值给变量，也没有重定向到$null？比如如果有一行代码直接写$response.Content或者$createResponse，而没有赋值，就会输出到Success流。
• Invoke-WebRequest命令是否有额外的输出？比如是否开启了-Verbose等会产生输出的参数？
• ConvertFrom-Json处理的响应内容是否包含多个JSON对象？如果响应是多行JSON，ConvertFrom-Json会返回多个对象，若没有正确赋值处理，可能导致额外输出。

方法1：抑制所有无关输出 #

将函数内部可能产生额外输出的命令重定向到$null，或者用[void]抑制输出：

function one(){        
    # 用[void]抑制Invoke-WebRequest的潜在输出
    [void]($response = Invoke-WebRequest -Uri $finalizeUrl -Method 'POST' -Body $createResponse.Content -Headers @{"Authorization" = $authToken; "Content-Type" = "application/json" })    
    # 同样抑制ConvertFrom-Json的潜在输出
    [void]($responseObject = $response.Content | ConvertFrom-Json) 
    
    $assetId = $responseObject.asset_id
    Write-Host $assetId
    Write-Host "Type of assetId in function one: " ($assetId.GetType().Name)
    return $assetId
}

方法2：确保仅返回目标值 #

如果确认只有$assetId需要返回，可以将函数的最后一行改为仅输出$assetId，return可省略（PowerShell会将最后一行的输出作为返回值）：

function one(){        
    $response = Invoke-WebRequest -Uri $finalizeUrl -Method 'POST' -Body $createResponse.Content -Headers @{"Authorization" = $authToken; "Content-Type" = "application/json" }    
    $responseObject = $response.Content | ConvertFrom-Json 
    
    $assetId = $responseObject.asset_id
    Write-Host $assetId
    Write-Host "Type of assetId in function one: " ($assetId.GetType().Name)
    # 直接输出$assetId作为唯一返回值
    $assetId
}

方法3：明确提取目标值 #

如果需要确保接收的是单个值而非数组，可以在接收返回值时提取目标元素：

# 只取返回数组的最后一个元素（即你想要的assetId）
$asset_id = (one)[-1]
# 或者强制转换为Int64类型
$asset_id = [Int64](one)

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