Поиск по сайту:

Out-GridView (Microsoft.PowerShell.Utility)

Out-GridView

Модуль:
Microsoft.PowerShell.Utility

Отправляет выходные данные в интерактивную таблицу в отдельном окне.

Синтаксис

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>]

Описание

Этот командлет доступен только на платформе Windows.

Командлет Out-GridView отправляет выходные данные команды в окно представления сетки, где выходные данные отображаются в интерактивной таблице.

Поскольку для этого командлета требуется пользовательский интерфейс, он не работает в Windows Server Core или Windows Nano Server.

Для проверки данных вы можете использовать следующие функции таблицы:

  • Скрытие, отображение и изменение порядка столбцов
  • Сортировка строк
  • Быстрый фильтр
  • Добавить фильтр критериев
  • Скопируйте и вставьте

Полные инструкции см. в разделе «Примечания» этой статьи.

Примечание

Этот командлет был вновь представлен в PowerShell 7. Этот командлет доступен только в системах Windows, поддерживающих рабочий стол Windows. Кросс-платформенную версию этого командлета см. в модуле ConsoleGuiTools в галерее PowerShell.

Примеры

Пример 1: Вывод процессов в виде сетки

В этом примере процессы, запущенные на локальном компьютере, отправляются в окно просмотра сетки.

Get-Process | Out-GridView

Пример 2. Использование переменной для вывода процессов в виде сетки

Этот пример также получает процессы, запущенные на локальном компьютере, и отправляет их в окно просмотра сетки.

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

Вывод командлета Get-Process сохраняется в переменной $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 для сортировки их в порядке убывания по значению свойства WorkingSet. Затем отсортированные результаты передаются в Out-GridView. Теперь вы можете использовать функции представления сетки для поиска, сортировки и фильтрации данных.

Пример 4. Сохранение вывода в переменной, а затем вывод в виде сетки.

В этом примере выходные данные командлета сохраняются в переменной, а затем отправляются в Out-GridView.

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

Get-ChildItem получает все файлы в каталоге установки PowerShell и его подкаталогах, используя автоматическую переменную $PSHOME. Круглые скобки в команде определяют порядок действий. В результате выходные данные команды Get-ChildItem сохраняются в переменной $A перед отправкой в Out-GridView.

Пример 5: Вывод процессов для указанного компьютера в виде сетки

В этом примере процессы, запущенные на компьютере Server01, отображаются в окне просмотра в виде сетки.

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

В примере используется ogv, который является псевдонимом командлета Out-GridView. Параметр 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

Параметр PassThru Out-GridView позволяет отправлять несколько элементов по конвейеру. Параметр PassThru эквивалентен использованию значения Multiple параметра OutputMode.

Пример 8. Создайте ярлык Windows для Out-GridView.

В этом примере показано, как использовать параметр Wait Out-GridView для создания ярлыка Windows для окна Out-GridView.

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

Эту командную строку можно использовать в ярлыке Windows. Без параметра Wait PowerShell завершит работу, как только откроется окно Out-GridView, что приведет к почти немедленному закрытию окна Out-GridView.

Параметры

-InputObject

Указывает объект, который командлет принимает в качестве входных данных для Out-GridView.

Когда вы используете параметр InputObject для отправки коллекции объектов в Out-GridView, Out-GridView рассматривает коллекцию как один объект коллекции и он отображает одну строку, представляющую коллекцию. Чтобы отобразить каждый объект в коллекции, используйте оператор конвейера (|) для отправки объектов в Out-GridView.

Тип :

PSОбъект

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

True

Принимайте подстановочные знаки:

False

-OutputMode

Указывает элементы, которые интерактивное окно отправляет по конвейеру в качестве входных данных для других команд. По умолчанию этот командлет не генерирует никаких выходных данных. Чтобы отправить элементы из интерактивного окна по конвейеру, щелкните их, чтобы выбрать, а затем нажмите «ОК».

Значения этого параметра определяют, сколько элементов вы можете отправить по конвейеру.

  • Нет. Нет предметов. Это значение по умолчанию.
  • Один. Ноль предметов или один предмет. Используйте это значение, когда следующая команда может принять только один входной объект.
  • Несколько. Ноль, один или несколько элементов. Используйте это значение, если следующая команда может принимать несколько объектов ввода. Это значение эквивалентно параметру Passthru.

Этот параметр был введен в Windows PowerShell 3.0.

Тип :

Выходной режимопция

Принятые значения:

Нет, одиночный, множественный

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-PassThru

Указывает, что командлет отправляет элементы из интерактивного окна по конвейеру в качестве входных данных для других команд. По умолчанию этот командлет не генерирует никаких выходных данных. Этот параметр эквивалентен использованию значения Multiple параметра OutputMode.

Чтобы отправить элементы из интерактивного окна по конвейеру, щелкните их, чтобы выбрать, а затем нажмите «ОК». Поддерживаются клавиши Shift и Ctrl.

Тип :

SwitchParameter

Позиция:

Именованный

Значение по умолчанию:

False

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-Title

Задает текст, который отображается в строке заголовка окна Out-GridView. По умолчанию в строке заголовка отображается команда, вызывающая Out-GridView.

Тип :

String

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-Wait

Указывает, что командлет подавляет командную строку и предотвращает закрытие Windows PowerShell до тех пор, пока не закроется окно Out-GridView. По умолчанию командная строка возвращается, когда открывается окно Out-GridView.

Эта функция позволяет использовать командлеты Out-GridView в ярлыках Windows. Если Out-GridView используется в ярлыке без параметра Wait, окно Out-GridView появляется лишь на мгновение, прежде чем PowerShell закроется.

Тип :

SwitchParameter

Позиция:

Именованный

Значение по умолчанию:

False

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

Входы

PSObject

В этот командлет можно передать любой объект.

Выходы

Нет

По умолчанию этот командлет не возвращает никаких результатов.

PSObject

При использовании параметра PassThru этот командлет возвращает объекты, представляющие выбранные строки.

Примечания

PowerShell включает следующие псевдонимы для Out-GridView:

  • Windows:

      ogv

Этот командлет доступен только на платформах Windows. Этот командлет доступен только на платформах Windows.

Вы не можете использовать удаленную команду, чтобы открыть окно просмотра сетки на другом компьютере.

Вывод команды, который вы отправляете в Out-GridView, нельзя форматировать с помощью командлетов Format, таких как Format-Table или Format- Широкие командлеты. Чтобы выбрать свойства, используйте командлет Select-Object.

Десериализованный вывод удаленных команд может быть неправильно отформатирован в окне представления сетки.

Сочетания клавиш для Out-GridView

Tab

Перемещает курсор из поля Фильтр в меню Добавить критерии в таблицу и обратно.

UpArrow

Поднимитесь на одну строку вверх. Переход к заголовкам столбцов из первой строки данных.

DownArrow

Переместитесь на одну строку вниз.

LeftArrow

В строке заголовка столбца переместите один столбец влево.

RightArrow

В строке заголовка столбца переместите один столбец вправо.

ContextMenuKey

В строке заголовка столбца отображается параметр «Выбрать столбцы».

Enter or Spacebar

В строке заголовка столбца отсортируйте данные столбца (переключите A-Z, Z-A).

Как использовать функции окна просмотра в виде сетки

Чтобы скрыть или показать столбец:

  1. Щелкните правой кнопкой мыши заголовок любого столбца и выберите Выбрать столбцы.
  2. В диалоговом окне Выбор столбцов с помощью клавиш со стрелками переместите столбцы между выбранными столбцами в поля «Доступные столбцы». В окне просмотра сетки отображаются только столбцы из поля Выбрать столбцы.

Чтобы изменить порядок столбцов:

Вы можете перетаскивать столбцы в нужное место. Или используйте следующие шаги:

  1. Щелкните правой кнопкой мыши заголовок любого столбца и выберите Выбрать столбцы.
  2. В диалоговом окне Выбор столбцов используйте кнопки Вверх и Вниз, чтобы изменить порядок столбцов. Столбцы в верхней части списка отображаются слева от столбцов в нижней части списка в окне просмотра сетки.

Как сортировать данные таблицы

  • Чтобы отсортировать данные, щелкните заголовок столбца.
  • Чтобы изменить порядок сортировки, щелкните заголовок столбца еще раз. Каждый раз, когда вы щелкаете один и тот же заголовок, порядок сортировки переключается с восходящего на нисходящий. Текущий порядок обозначается треугольником в заголовке столбца.

Как выбрать данные таблицы

  • Чтобы выбрать строку, выберите строку или используйте стрелку вверх или вниз для перехода к строке.
  • Чтобы выбрать все строки (кроме строки заголовка), нажмите CTRL+A.
  • Чтобы выбрать последовательные строки, нажмите и удерживайте клавишу SHIFT, щелкая строки или используя клавиши со стрелками.
  • Чтобы выбрать непоследовательные строки, нажмите клавишу CTRL и щелкните, чтобы добавить строку к выделению.
  • Вы не можете выбирать столбцы, а также не можете выбрать всю строку заголовка столбца.

Как скопировать строки

  • Чтобы скопировать одну или несколько строк из таблицы, выделите строки и нажмите CTRL+C.

    Вы можете вставить данные в любую текстовую программу или программу для работы с электронными таблицами. Вы не можете копировать столбцы или части строк, а также не можете копировать строку заголовка столбца.

Как искать в таблице (быстрый фильтр)

Используйте поле «Фильтр» для поиска данных в таблице. Когда вы вводите текст в поле, в таблице появляются только элементы, содержащие введенный текст.

  • Поиск текста. Чтобы выполнить поиск текста в таблице, в поле Фильтр введите искомый текст.

  • Поиск нескольких слов. Для поиска нескольких слов в таблице введите слова, разделенные пробелами. Out-GridView отображает строки, содержащие все слова (логическое И).

  • Найдите буквальные фразы. Для поиска фраз, содержащих пробелы или специальные символы, заключите фразу в кавычки. Out-GridView отображает строки, содержащие точное соответствие фразе.

  • Поиск по столбцам. Для поиска текста в одном или нескольких столбцах используйте следующий формат:

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

    Например, чтобы найти «Net» в столбце DisplayName, в поле Фильтр введите:

    displayname:net

    Чтобы найти строки со словом «Net» в столбцах DisplayName и Name, в поле Фильтр введите:

    displayname:net name:net

  • Отключите поиск. Чтобы снова отобразить всю таблицу, нажмите красную кнопку X в правом верхнем углу поля Фильтр или удалите текст из поля Фильтр.

Использование критериев для фильтрации таблицы

Вы можете использовать правила или критерии, чтобы определить, какие элементы отображаются в таблице. Элементы появляются только тогда, когда они удовлетворяют всем установленным вами критериям. Доступные критерии определяются свойствами объектов, отображаемых в окне представления сетки, и типами этих свойств в .NET Framework.

Каждый критерий имеет следующий формат:

<column> <operator> <value>

Критерии различных свойств связаны И. Критерии одного и того же свойства соединяются ИЛИ. Вы не можете изменить логические соединители.

Критерии влияют только на отображение. Он не удаляет элементы из таблицы.

Как добавить критерии

  1. Чтобы отобразить кнопку меню Добавить критерии, в правом верхнем углу окна нажмите стрелку «Развернуть».
  2. Нажмите кнопку меню Добавить критерии.
  3. Нажмите, чтобы выбрать столбцы (свойства). Вы можете выбрать одно или несколько свойств.
  4. Завершив выбор свойств, нажмите кнопку Добавить.
  5. Чтобы отменить добавления, нажмите Отмена.
  6. Чтобы добавить дополнительные критерии, нажмите кнопку Добавить критерии еще раз.

Как изменить критерий

  • Чтобы изменить оператор, щелкните синее значение оператора, а затем выберите другой оператор из раскрывающегося списка.
  • Чтобы ввести или изменить значение, введите значение в поле значения. Если вы введете недопустимое значение, появится круглый значок X. Чтобы удалить его, измените значение.
  • Чтобы создать оператор OR, добавьте критерий с тем же свойством.

Как удалить критерии

  • Чтобы удалить выбранные критерии, щелкните красный крестик рядом с каждым критерием.
  • Чтобы удалить все критерии, нажмите кнопку Очистить все.