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

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

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

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

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

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

Полные инструкции см. в разделе "Заметки " этой статьи.

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

Get-Process | Out-GridView

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

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

Выходные данные командлета Get-Process сохраняются в переменной $P . $P Затем передаются Out-GridViewв .

В этом примере отображаются выбранные свойства выполняемых процессов в представлении сетки.

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. Теперь вы можете использовать функции представления сетки для поиска, сортировки и фильтрации данных.

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

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

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

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

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

В примере используется ogvпсевдоним командлета Out-GridView . Параметр Title задает заголовок окна.

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

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

Invoke-Command выполняется Get-Culture на трех удаленных компьютерах. Полученные данные передаются Out-GridViewв . Обратите внимание, что блок скрипта, работающий на удаленном компьютере, не включает Out-GridView команду. Если это произошло, команда завершится ошибкой при попытке открыть окно представления сетки на каждом из удаленных компьютеров.

В этом примере можно выбрать несколько процессов из Out-GridView окна. Избранные процессы передаются команде Export-Csv и записываются в ProcessLog.csv файл.

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

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

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

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

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

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

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

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

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

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

• Виндоус:
  • ogv

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

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

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

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

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

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

Скрытие или отображение столбца:

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. Чтобы добавить дополнительные условия, снова нажмите кнопку "Добавить критерии ".

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

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

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

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