Out-GridView (Microsoft.PowerShell.Utility)

Out-GridView

将输出发送到单独窗口中的交互式表。

句法

Out-GridView
   [-InputObject <PSObject>]
   [-Title <String>]
   [-PassThru]
   [<CommonParameters>]

Out-GridView
   [-InputObject <PSObject>]
   [-Title <String>]
   [-Wait]
   [<CommonParameters>]

Out-GridView
   [-InputObject <PSObject>]
   [-Title <String>]
   [-OutputMode <OutputModeOption>]
   [<CommonParameters>]

描述

此 cmdlet 仅适用于 Windows 平台。

Out-GridView cmdlet 将命令的输出发送到网格视图窗口，其中输出显示在交互式表格中。

由于此 cmdlet 需要用户界面，因此它不适用于 Windows Server Core 或 Windows Nano Server。

您可以使用表的以下功能来检查数据：

• 隐藏、显示和重新排序列
• 对行进行排序
• 快速过滤
• 添加条件过滤器
• 复制并粘贴

有关完整说明，请参阅本文的注释部分。

笔记

此 cmdlet 在 PowerShell 7 中重新引入。此 cmdlet 仅在支持 Windows 桌面的 Windows 系统上可用。有关此 cmdlet 的跨平台版本，请参阅 PowerShell 库中的 ConsoleGuiTools 模块。

示例

示例 1：将进程输出到网格视图

此示例获取本地计算机上运行的进程并将它们发送到网格视图窗口。

Get-Process | Out-GridView

示例 2：使用变量将流程输出到网格视图

此示例还获取本地计算机上运行的进程并将它们发送到网格视图窗口。

$P = Get-Process
$P | Out-GridView

Get-Process cmdlet 的输出保存在 $P 变量中。然后，$P 通过管道传输到 Out-GridView。

示例 3：在网格视图中显示选定的属性

此示例在网格视图中显示正在运行的进程的选定属性。

Get-Process | Select-Object -Property Name, WorkingSet, PeakWorkingSet |
  Sort-Object -Property WorkingSet -Descending | Out-GridView

Get-Process 的输出通过管道传输到 Select-Object 以选择 Name、WorkingSet 和 >PeakWorkingSet 属性。另一个管道运算符将筛选后的对象发送到 Sort-Object cmdlet，以按 WorkingSet 属性的值降序对它们进行排序。然后，排序后的结果通过管道传输到 Out-GridView。您现在可以使用网格视图的功能来搜索、排序和过滤数据。

示例 4：将输出保存到变量，然后输出网格视图

此示例将 cmdlet 输出保存在变量中，然后将其发送到 Out-GridView。

($A = Get-ChildItem -Path $PSHOME -Recurse) | Out-GridView

Get-ChildItem 使用 $PSHOME 自动变量获取 PowerShell 安装目录及其子目录中的所有文件。命令中的括号确定操作顺序。因此，Get-ChildItem 命令的输出在发送到 Out-GridView 之前会保存在 $A 变量中。

示例 5：将指定计算机的进程输出到网格视图

此示例在网格视图窗口中显示 Server01 计算机上运行的进程。

Get-Process -ComputerName "Server01" | ogv -Title "Processes - Server01"

该示例使用 ogv，它是 Out-GridView cmdlet 的别名。 Title 参数指定窗口标题。

示例 6：将数据从远程计算机输出到网格视图

此示例演示如何将从远程计算机收集的数据发送到 Out-GridView。

Invoke-Command -ComputerName S1, S2, S3 -ScriptBlock {Get-Culture} | Out-GridView

Invoke-Command 在三台远程计算机上运行 Get-Culture。生成的数据通过管道传输到 Out-GridView。请注意，在远程计算机上运行的脚本块不包含 Out-GridView 命令。如果这样做，该命令在尝试在每台远程计算机上打开网格视图窗口时将会失败。

示例 7：通过 `Out-GridView` 传递多个项目

此示例允许您从 Out-GridView 窗口中选择多个进程。您选择的进程将传递给 Export-Csv 命令并写入 ProcessLog.csv 文件。

Get-Process | Out-GridView -PassThru | Export-Csv -Path .\ProcessLog.csv

Out-GridView 的 PassThru 参数允许您沿着管道发送多个项目。 PassThru 参数相当于使用OutputMode 参数的Multiple 值。

示例 8：创建“Out-GridView”的 Windows 快捷方式

此示例演示如何使用 Out-GridView 的 Wait 参数创建 Out-GridView 窗口的 Windows 快捷方式。

pwsh -Command "Get-Service | Out-GridView -Wait"

此命令行可在 Windows 快捷方式中使用。如果没有 Wait 参数，PowerShell 将在 Out-GridView 窗口打开后立即退出，这将几乎立即关闭 Out-GridView 窗口。

参数

-InputObject

指定 cmdlet 接受作为 Out-GridView 输入的对象。

当您使用 InputObject 参数将一组对象发送到 Out-GridView 时，Out-GridView 将该集合视为一个集合对象，并且它显示代表集合的一行。要显示集合中的每个对象，请使用管道运算符 (|) 将对象发送到 Out-GridView。

PS对象

命名

None

False

True

False

-OutputMode

指定交互式窗口沿着管道发送的项目作为其他命令的输入。默认情况下，此 cmdlet 不生成任何输出。要将项目从交互式窗口发送到管道中，请单击以选择项目，然后单击“确定”。

该参数的值决定了您可以沿着管道发送多少项目。

• 无。 没有物品。这是默认值。
• 单个。零个项目或一个项目。当下一个命令只能采用一个输入对象时，请使用此值。
• 多个。零个、一个或多个项目。当下一个命令可以采用多个输入对象时，请使用此值。该值相当于Passthru参数。

此参数是在 Windows PowerShell 3.0 中引入的。

输出模式选项

无、单个、多个

命名

None

False

False

False

-PassThru

指示 cmdlet 将交互窗口中的项目沿着管道发送，作为其他命令的输入。默认情况下，此 cmdlet 不生成任何输出。此参数相当于使用 OutputMode 参数的 Multiple 值。

要将项目从交互式窗口发送到管道中，请单击以选择项目，然后单击“确定”。支持按住 Shift 键单击和按住 Ctrl 键单击。

SwitchParameter

命名

False

False

False

False

-Title

指定 Out-GridView 窗口标题栏中显示的文本。默认情况下，标题栏显示调用 Out-GridView 的命令。

String

命名

None

False

False

False

-Wait

指示 cmdlet 禁止显示命令提示符并阻止 Windows PowerShell 关闭，直到 Out-GridView 窗口关闭。默认情况下，当 Out-GridView 窗口打开时，命令提示符会返回。

此功能允许您在 Windows 快捷方式中使用 Out-GridView cmdlet。当在不带 Wait 参数的快捷方式中使用 Out-GridView 时，Out-GridView 窗口仅在 PowerShell 关闭之前短暂出现。

SwitchParameter

命名

False

False

False

False

输入

PSObject

您可以通过管道将任何对象传递给此 cmdlet。

输出

无

默认情况下，此 cmdlet 不返回任何输出。

PSObject

当您使用 PassThru 参数时，此 cmdlet 返回表示所选行的对象。

笔记

PowerShell 包含以下 Out-GridView 别名：

• Windows:

  ogv

此 cmdlet 仅在 Windows 平台上可用。此 cmdlet 仅在 Windows 平台上可用。

您无法使用远程命令在另一台计算机上打开网格视图窗口。

发送到 Out-GridView 的命令输出无法使用 Format cmdlet 进行格式化，例如 Format-Table 或 Format-宽 cmdlet。要选择属性，请使用Select-Object cmdlet。

远程命令的反序列化输出在网格视图窗口中可能无法正确格式化。

Out-GridView 的键盘快捷键

将光标从过滤器框移动到表的添加条件菜单，然后返回。

上移一排。从第一行数据移至列标题。

向下移动一排。

在列标题行中，向左移动一列。

在列标题行中，向右移动一列。

在列标题行中，显示“选择列”选项。

在列标题行中，对列数据进行排序（切换 A-Z、Z-A）。

如何使用网格视图窗口功能

隐藏或显示列：

1. 右键单击任意列标题，然后单击选择列。
2. 在选择列对话框中，使用箭头键将选定列之间的列移动到可用列框。只有选择列框中的列才会出现在网格视图窗口中。

对列重新排序：

您可以将列拖放到所需位置。或者使用以下步骤：

1. 右键单击任意列标题，然后单击选择列。
2. 在选择列对话框中，使用上移和下移按钮对列重新排序。在网格视图窗口中，列表顶部的列显示在列表底部的列的左侧。

如何对表格数据进行排序

• 要对数据进行排序，请单击列标题。
• 要更改排序顺序，请再次单击列标题。每次单击同一标题时，排序顺序都会在升序和降序之间切换。当前顺序由列标题中的三角形指示。

如何选择表格数据

• 要选择行，请选择该行或使用向上或向下箭头导航到该行。
• 要选择所有行（标题行除外），请按 CTRL+A。
• 要选择连续的行，请按住 SHIFT 键，同时单击行或使用箭头键。
• 要选择不连续的行，请按 CTRL 键并单击以将行添加到选择中。
• 您无法选择列，也无法选择整个列标题行。

如何复制行

• 要从表中复制一行或多行，请选择这些行，然后按 CTRL+C。

  您可以将数据粘贴到任何文本或电子表格程序中。您无法复制列或部分行，也无法复制列标题行。

如何在表格中搜索（快速过滤）

使用“过滤器”框搜索表中的数据。当您在框中键入内容时，只有包含键入文本的项目才会出现在表中。

• 搜索文本。要在表中搜索文本，请在“过滤器”框中键入要查找的文本。

• 搜索多个单词。要在表中搜索多个单词，请键入单词并用空格分隔。 Out-GridView 显示包含所有单词的行（逻辑AND）。

• 搜索字面短语。要搜索包含空格或特殊字符的短语，请将短语用引号引起来。 Out-GridView 显示包含与短语完全匹配的行。

• 在列中搜索。要搜索一列或多列中的文本，请使用以下格式：

  <column>:<text> [<column>:<text>] ...

  例如，要在 DisplayName 列中查找“Net”，请在过滤器 框中键入：

  displayname:net

  要查找 DisplayName 和 Name 列中包含“Net”的行，请在过滤器框中输入：

  displayname:net name:net

• 关闭搜索。要再次显示整个表格，请单击过滤器框右上角的红色X按钮或从过滤器框中删除文本。

使用条件过滤表格

您可以使用规则或条件来确定表中显示哪些项目。仅当项目满足您建立的所有标准时才会出现。可用条件由网格视图窗口中显示的对象的属性以及这些属性的 .NET Framework 类型决定。

每个标准具有以下格式：

<column> <operator> <value>

不同属性的标准通过AND连接。同一属性的条件通过OR 连接。您无法更改逻辑连接器。

该标准仅影响显示。它不会从表中删除项目。

如何添加条件

1. 要显示添加条件菜单按钮，请单击窗口右上角的展开箭头。
2. 单击添加条件菜单按钮。
3. 单击以选择列（属性）。您可以选择一个或多个属性。
4. 选择完属性后，单击添加按钮。
5. 要取消添加，请单击取消。
6. 要添加更多条件，请再次单击添加条件按钮。

如何编辑标准

• 要更改运算符，请单击蓝色运算符值，然后从下拉列表中选择不同的运算符。
• 要输入或更改值，请在值框中键入一个值。如果输入无效值，则会出现圆形 X 图标。要删除它，请更改该值。
• 要创建 OR 语句，请添加具有相同属性的条件。

如何删除条件

• 要删除选定的条件，请单击每个条件旁边的红色 X。
• 要删除所有条件，请单击全部清除按钮。