PowerShell自定义属性width键未生效，如何修改输出列宽？

在PowerShell 7.3.4环境下，使用Format-Table时，自定义属性哈希表中指定的width键完全不生效，尝试重命名列、格式化日期、省略列名等操作均无法按指定宽度调整列宽；同时在Select-Object中使用width键会直接报错。

测试脚本 #

# 目录'C:\src\t\rrr\'包含3个子目录
Get-ChildItem | Format-Table -Property Parent,LastWriteTime,FullName
# 使用自定义属性将LastWriteTime重命名为LWT
Get-ChildItem | Format-Table -Property Parent,@{n='LWT';e={$_.LastWriteTime}},FullName
# 指定width键似乎被忽略
Get-ChildItem | Format-Table -Property Parent,@{n='LWT';e={$_.LastWriteTime};width=50},FullName
# 重新格式化LastWriteTime日期时间
Get-ChildItem | Format-Table -Property Parent,@{n='LWT';e={$_.LastWriteTime.ToString('MMM yyyy')}},FullName
# 但自定义属性哈希表中指定width键仍无效
Get-ChildItem | Format-Table -Property Parent,@{n='LWT';e={$_.LastWriteTime.ToString('MMM yyyy')};width=50},FullName
# 省略name键会将列宽扩展到表达式长度，但不匹配指定width值
Get-ChildItem | Format-Table -Property Parent,@{e={$_.LastWriteTime.ToString('MMM yyyy')};width=50},FullName
# 在Select-Object属性中使用width键无效
Get-ChildItem | Select-Object -Property Parent,@{n='LWT';e={$_.LastWriteTime};width=50},FullName

脚本执行结果 #

PS C:\src\t\rrr> # 目录'C:\src\t\rrr\'包含3个子目录
PS C:\src\t\rrr> Get-ChildItem | Format-Table -Property Parent,LastWriteTime,FullName

Parent       LastWriteTime       FullName
------       -------------       --------
C:\src\t\rrr 2020-05-11 10:50:39 C:\src\t\rrr\a
C:\src\t\rrr 2023-05-16 12:41:00 C:\src\t\rrr\b
C:\src\t\rrr 2020-05-11 10:51:00 C:\src\t\rrr\c

PS C:\src\t\rrr> # 使用自定义属性将LastWriteTime重命名为LWT
PS C:\src\t\rrr> Get-ChildItem | Format-Table -Property Parent,@{n='LWT';e={$_.LastWriteTime}},FullName

Parent       LWT                 FullName
------       ---                 --------
C:\src\t\rrr 2020-05-11 10:50:39 C:\src\t\rrr\a
C:\src\t\rrr 2023-05-16 12:41:00 C:\src\t\rrr\b
C:\src\t\rrr 2020-05-11 10:51:00 C:\src\t\rrr\c

PS C:\src\t\rrr> # 指定width键似乎被忽略
PS C:\src\t\rrr> Get-ChildItem | Format-Table -Property Parent,@{n='LWT';e={$_.LastWriteTime};width=50},FullName

Parent       LWT                 FullName
------       ---                 --------
C:\src\t\rrr 2020-05-11 10:50:39 C:\src\t\rrr\a
C:\src\t\rrr 2023-05-16 12:41:00 C:\src\t\rrr\b
C:\src\t\rrr 2020-05-11 10:51:00 C:\src\t\rrr\c

PS C:\src\t\rrr> # 重新格式化LastWriteTime日期时间
PS C:\src\t\rrr> Get-ChildItem | Format-Table -Property Parent,@{n='LWT';e={$_.LastWriteTime.ToString('MMM yyyy')}},FullName

Parent       LWT      FullName
------       ---      --------
C:\src\t\rrr May 2020 C:\src\t\rrr\a
C:\src\t\rrr May 2023 C:\src\t\rrr\b
C:\src\t\rrr May 2020 C:\src\t\rrr\c

PS C:\src\t\rrr> # 但自定义属性哈希表中指定width键仍无效
PS C:\src\t\rrr> Get-ChildItem | Format-Table -Property Parent,@{n='LWT';e={$_.LastWriteTime.ToString('MMM yyyy')};width=50},FullName

Parent       LWT      FullName
------       ---      --------
C:\src\t\rrr May 2020 C:\src\t\rrr\a
C:\src\t\rrr May 2023 C:\src\t\rrr\b
C:\src\t\rrr May 2020 C:\src\t\rrr\c

PS C:\src\t\rrr> # 省略name键会将列宽扩展到表达式长度，但不匹配指定width值
PS C:\src\t\rrr> Get-ChildItem | Format-Table -Property Parent,@{e={$_.LastWriteTime.ToString('MMM yyyy')};width=50},FullName

Parent       $_.LastWriteTime.ToString('MMM yyyy') FullName
------       ------------------------------------- --------
C:\src\t\rrr May 2020                              C:\src\t\rrr\a
C:\src\t\rrr May 2023                              C:\src\t\rrr\b
C:\src\t\rrr May 2020                              C:\src\t\rrr\c

PS C:\src\t\rrr> # 在Select-Object属性中使用width键无效
PS C:\src\t\rrr> Get-ChildItem | Select-Object -Property Parent,@{n='LWT';e={$_.LastWriteTime};width=50},FullName
Select-Object: The width key is not valid.

PS C:\src\t\rrr> $PSVersionTable.PSVersion.ToString()
7.3.4

解决方案 #

1. 自定义表达式时手动固定列宽 #

Format-Table的自定义属性哈希表不支持width键，需在表达式内部通过字符串格式化方法（如PadRight、Substring）强制固定列宽，再结合-AutoSize参数让表格适配：

# 强制LWT列宽度为50，不足补空格
Get-ChildItem | Format-Table -AutoSize -Property Parent,
    @{n='LWT';e={$_.LastWriteTime.ToString('MMM yyyy').PadRight(50)}},
    FullName

# 限制最大宽度为50，超长内容截断
Get-ChildItem | Format-Table -AutoSize -Property Parent,
    @{n='LWT';e={
        $formatted = $_.LastWriteTime.ToString('MMM yyyy')
        if ($formatted.Length -gt 50) { $formatted.Substring(0, 47) + '...' }
        else { $formatted.PadRight(50) }
    }},
    FullName

2. 原生属性直接指定列宽 #

对于对象原生属性（非自定义表达式），可通过属性名;宽度的格式直接在-Property参数中指定列宽：

# 给原生LastWriteTime列指定宽度50
Get-ChildItem | Format-Table -Property Parent, 'LastWriteTime;50', FullName

3. 手动构建输出字符串完全控制格式 #

如果需要极致的格式控制，可遍历对象手动拼接每一行的输出字符串：

Get-ChildItem | ForEach-Object {
    # 分别固定各列宽度
    $parentCol = $_.Parent.FullName.PadRight(20)
    $lwtCol = $_.LastWriteTime.ToString('MMM yyyy').PadRight(50)
    $fullNameCol = $_.FullName
    # 输出拼接后的字符串
    Write-Host "$parentCol $lwtCol $fullNameCol"
}

关键说明 #

• Select-Object的自定义属性哈希表不支持width键，该参数仅适用于格式化命令，但Format-Table的自定义表达式也无法通过哈希表的width键指定宽度，必须在表达式内处理。
• -AutoSize参数会让Format-Table根据内容自动调整列宽，但结合手动格式化的固定宽度字符串，可强制列宽符合预期。

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