Поделиться через

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

Параметр Out-GridView PassThru позволяет отправлять несколько элементов по конвейеру. Параметр PassThru эквивалентен использованию нескольких значений параметра 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в .

Тип:PSObject
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-OutputMode

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

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

  • None. нет элементов. Это значение по умолчанию.
  • Single. нуль элементов или один элемент. Это значение используется, если следующая команда может принимать только один входной объект.
  • Multiple. нуль, один или несколько элементов. Это значение используется, если следующая команда может принимать несколько входных объектов. Это значение эквивалентно параметру PassThru .

Этот параметр впервые появился в Windows PowerShell 3.0.

Тип:OutputModeOption
Допустимые значения:None, Single, Multiple
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-PassThru

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

Чтобы отправить элементы из интерактивного окна в конвейер, выберите нужные элементы, а затем нажмите кнопку "ОК". Поддерживается выбор элементов с помощью клавиш SHIFT и CTRL.

Тип:SwitchParameter
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Title

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

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Wait

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

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

Тип:SwitchParameter
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

PSObject

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

Выходные данные

None

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

PSObject

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

Примечания

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

  • Windows:
    • ogv

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

Удаленную команду нельзя использовать для открытия окна представления сетки на другом компьютере.

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

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

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

Используйте этот ключ: Чтобы выполнить это действие, выполните следующее:
Вкладка Перемещает курсор из поля фильтра в меню "Добавить условия" в таблицу и назад.
UpArrow Перемещение вверх по одной строке. Перемещается в заголовки столбцов из первой строки данных.
DownArrow Перемещение вниз по одной строке.
LeftArrow В строке заголовка столбца переместите один столбец влево.
RightArrow В строке заголовка столбца переместите вправо один столбец.
ContextMenuKey В строке заголовка столбца отображается параметр "Выбрать столбцы".
Ввод или пробел В строке заголовка столбца сортируйте данные столбца (переключите 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>

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

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

Добавление условий

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

Изменение критерия

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

Удаление условий

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