在 Windows PowerShell 脚本中使用 Out-GridView cmdlet

已完成

Out-GridView 主要用于查看数据。 但是，还可以使用 Out-GridView 创建简单的菜单选择界面。 当用户在 Out-GridView 提供的窗口中进行一个或多个选择时，这些对象的数据要么通过管道进一步传递，要么放入变量中。 在 Out-GridView 中选择选项的语法是：

$selection = $users | Out-GridView -PassThru 

在前面的示例中，用户帐户数组通过管道传递给 Out-GridView。 Out-GridView 在屏幕上显示用户帐户，用户可以在 Out-GridView 窗口中选择一行或多行。 当用户选择“确定”时，所选的行存储在 变量中。 然后可以对用户帐户执行进一步的处理。

如果要对用户可选择的数据量保留更多的控制，可以使用 -OutputMode 参数，而不是 -PassThru 参数。 下表描述了可为 -OutputMode 参数定义的值。

表 1：可为 -OutputMode 参数定义的值

价值	描述
无	这是不会在管道中进一步传递任何对象的默认值。
单身	此值允许用户在 Out-GridView 窗口中选择零行或一行。
多个	此值允许用户在 Out-GridView 窗口中选择零行、一行或多行。 此值等效于使用 -PassThru 参数。

备注

由于不会强制用户选择 Out-GridView 窗口中的一行，因此必须确保脚本正确处理未选中一行的情况。