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

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. Кроссплатформенную версию этого командлета см. в модуле GraphTools в коллекция 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-GridViewPassThru для позволяет отправлять несколько элементов по конвейеру. Параметр PassThru эквивалентен использованию значения Multiple параметра OutputMode.

Пример 8. Create ярлык 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в .

Type:PSObject
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-OutputMode

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

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

  • None. нет элементов. Это значение по умолчанию.
  • Single. нуль элементов или один элемент. Это значение используется, если следующая команда может принимать только один входной объект.
  • Multiple. нуль, один или несколько элементов. Это значение используется, если следующая команда может принимать несколько входных объектов. Это значение эквивалентно параметру Passthru.
Type:OutputModeOption
Accepted values:None, Single, Multiple
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

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

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

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Title

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Wait

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

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

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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

PSObject

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

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

None

Как правило, Out-GridView не возвращает никаких объектов. При использовании параметра PassThru объекты, представляющие выбранные строки, возвращаются в конвейер.

Примечания

Этот командлет доступен только на платформах 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>

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

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

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

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

Изменение условия

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

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

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