如何让PowerShell脚本按调用上下文输出可读文本或PSCustomObject

你描述的特性是PowerShell**格式化渲染系统（Formatting Rendering System）**的默认行为，所有原生PowerShell cmdlet都遵循该逻辑：命令本身仅输出结构化的.NET/PSCustomObject对象，当PowerShell引擎检测到输出最终流向交互控制台（供人类阅读）时，会自动根据预定义的类型格式化规则将对象渲染为易读的表格/列表文本；如果输出流向管道、变量赋值、或其他命令参数时，会直接传递原始结构化对象，全程不需要命令自身判断调用上下文。

你之前需要加-AsObject参数的实现是反模式，本质是混淆了「命令输出结构化数据」和「引擎负责渲染格式化内容」的责任边界，正确实现不需要手动判断上下文，只需要做两步：

• 第一步：脚本全程仅输出PSCustomObject（或自定义强类型）对象，绝对不要主动输出格式化字符串、使用Write-Host打印文本、或手动拼接表格内容
• 第二步（可选，用于自定义友好展示效果）：为你输出的自定义对象注册格式化视图，这样引擎渲染控制台输出时会按照你指定的样式展示，和Get-Process的展示效果完全一致

示例实现 #

基础版脚本（不需要自定义格式） #

# MyScript.ps1 示例代码
param()

# 构造业务数据，全部输出带PSTypeName标记的PSCustomObject
$outputList = @(
    [PSCustomObject]@{
        PSTypeName = "MyCustom.AppInfo"
        AppId = 101
        AppName = "微信"
        RunningStatus = "正常"
        CPUUsage = 12.3
        MemoryMB = 256
    },
    [PSCustomObject]@{
        PSTypeName = "MyCustom.AppInfo"
        AppId = 102
        AppName = "浏览器"
        RunningStatus = "正常"
        CPUUsage = 45.6
        MemoryMB = 512
    }
)

# 直接输出对象即可，不需要任何额外处理
$outputList

上述脚本的运行效果完全符合你的要求：

1. 直接调用.\MyScript.ps1：PowerShell自动将对象渲染为友好表格输出，供人类阅读
2. 管道调用.\MyScript.ps1 | Where-Object CPUUsage -gt 30 | Select-Object AppName,MemoryMB：管道传递原始对象，可正常做筛选、投影等操作
3. 赋值调用$appData = .\MyScript.ps1：$appData为完整的结构化对象数组，可直接访问属性和方法

进阶：自定义控制台展示格式 #

如果需要调整控制台输出的默认展示字段、对齐方式、列宽等，可以为自定义的MyCustom.AppInfo类型注册格式化规则，示例如下：

# 注册格式化规则，当前会话生效，也可存为ps1xml文件随模块永久加载
$tableColumns = @(
    @{Name="应用ID"; Expression={$_.AppId}; Width=8; Align="Right"},
    @{Name="应用名称"; Expression={$_.AppName}; Width=20; Align="Left"},
    @{Name="运行状态"; Expression={$_.RunningStatus}; Width=10; Align="Left"},
    @{Name="CPU占用(%)"; Expression={$_.CPUUsage}; Width=12; Align="Right"}
)
$viewDef = New-Object System.Management.Automation.FormatViewDefinition(
    "MyCustom.AppInfo.Default",
    [System.Management.Automation.TableControl]::Create($tableColumns)
)
Update-FormatData -ViewDefinition $viewDef

注册完成后，所有MyCustom.AppInfo类型的对象输出到控制台时，都会按照你定义的列展示，和原生cmdlet的展示效果完全一致。

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