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

Синтаксис

Out-GridView [-InputObject <psobject>] [-Title <string>] [<CommonParameters>]

Описание

Командлет Out-GridView пересылает результаты выполнения команды в окно таблицы, в котором они отображаются в виде интерактивной таблицы. Для использования этого компонента требуется Microsoft .NET Framework 3.5 с пакетом обновления 1 (SP1).

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

-- Скрытие, показ и изменение порядка столбцов. Чтобы скрыть, показать или изменить порядок столбцов, щелкните заголовок столбца правой кнопкой мыши и выберите команду "Выбор столбцов".

-- Сортировка. Чтобы отсортировать данные, щелкните заголовок столбца. Щелкните еще раз, чтобы перейти от сортировки по возрастанию к сортировке по убыванию.

-- Быстрый фильтр. Поле "Фильтр" в верхней части окна позволяет выполнять поиск по тексту таблицы. Можно искать текст в конкретном столбце, искать по символам или по нескольким словам.

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

-- Копирование и вставка. Чтобы скопировать строки с данными из таблицы Out-GridView, используйте сочетание клавиш CTRL+C (копирование). Затем эти данные можно вставить в программу для работы с текстом или электронными таблицами.

Чтобы получить инструкции по использованию этих функций, введите команду "Get-Help out-gridview -full" и ознакомьтесь с подразделом "Использование функций окна таблицы" в разделе ПРИМЕЧАНИЯ.

Параметры

-InputObject <psobject>

Принимает входные значения для командлета Out-GridView.

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

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	true (ByValue)
Принимать подстановочные знаки?	false

-Title <string>

Задает текст, который отображается в строке заголовка окна Out-GridView.

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

Обязательно?	false
Позиция?	named
Значение по умолчанию	The current command
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

<CommonParameters>

Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.

Ввод и вывод

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

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

System.Management.Automation.PSObject

Командлету Out-GridView можно передать любой объект.

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

Нет

Командлет Out-GridView не возвращает никаких объектов.

Примечания

ПРИМЕЧАНИЯ К OUT-GRIDVIEW

----------------------

Microsoft .NET Framework 3.5 с пакетом обновления 1 (SP1) можно загрузить из Центра загрузки Майкрософт.

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

Нельзя открывать окно таблицы на удаленном компьютере с помощью удаленной команды.

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

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

СОЧЕТАНИЯ КЛАВИШ ДЛЯ OUT-GRIDVIEW

-----------------------------------

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

Клавиши: Действие:

------------- ----------------------------------------------------------------

TAB Перемещение курсора из поля фильтра к меню добавления критериев таблицы и обратно.

СТРЕЛКА ВВЕРХ Перемещение на одну строку вверх. Можно перемещаться до заголовков столбцов.

СТРЕЛКА ВНИЗ Перемещение на одну строку вниз.

СТРЕЛКА ВЛЕВО В строке заголовков столбцов перемещение на один столбец влево.

СТРЕЛКА ВПРАВО В строке заголовков столбцов перемещение на один столбец вправо.

КЛАВИША КОНТЕКСТНОГО МЕНЮ В строке заголовков столбцов отображение параметра "Выбор столбцов".

ВВОД или ПРОБЕЛ В строке заголовков столбцов сортировка данных в столбцах (переключение A-Z, Z-A).

ИСПОЛЬЗОВАНИЕ ФУНКЦИЙ ОКНА ТАБЛИЦЫ

----------------------------------------

В следующих разделах описано, как использовать функции окна, отображаемого командлетом Out-GridView.

Скрытие, показ и изменение порядка столбцов

--------------------------------------

Скрытие и показ столбца.

1. Щелкните заголовок любого столбца правой кнопкой мыши и выберите команду "Выбор столбцов".

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

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

-- Перетащите столбец в нужное место.

- или -

1. Щелкните заголовок любого столбца правой кнопкой мыши и выберите команду "Выбор столбцов".

2. В диалоговом окне "Выбор столбцов" с помощью кнопок "Вверх" и "Вниз" измените порядок столбцов. В окне таблицы столбцы в верхней части списка отображаются левее столбцов в нижней части списка.

Сортировка данных в таблице

----------------------

-- Чтобы отсортировать данные, щелкните заголовок столбца.

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

Выбор данных в таблице

------------------------

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

-- Чтобы выбрать все строки (кроме строки заголовков), нажмите сочетание клавиш CTRL+A.

-- Чтобы выбрать последовательные строки, нажмите и удерживайте клавишу SHIFT, щелкая соответствующие строки или выбирая их с помощью клавиш со стрелками.

-- Чтобы выбрать непоследовательные строки, нажмите клавишу CTRL и щелкните строки для выбора.

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

Копирование столбцов

----------------------

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

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

Поиск по таблице (быстрый фильтр)

---------------------------------

Для поиска данных в таблице используйте поле "Фильтр". При вводе текста в это поле будут отображаться только элементы, содержащие вводимый текст.

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

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

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

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

<столбец>:<текст> [<столбец>:<текст>] ...

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

displayname:net

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

displayname:net name:net

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

Фильтрация таблицы с помощью критериев

--------------------------------

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

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

<столбец> <оператор> <значение>

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

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

Добавление критериев

---------------------------

1. Чтобы отобразить кнопку меню "Добавить критерии", щелкните стрелку "Развернуть" в верхнем правом углу окна.

2. Нажмите кнопку меню "Добавить критерии".

3. Щелкните, чтобы выбрать столбцы (свойства). Можно выбрать одно или несколько свойств.

4. После выбора свойств нажмите кнопку "Добавить".

5. Чтобы отменить выбор, нажмите кнопку "Отмена".

6. Чтобы добавить дополнительные критерии, снова нажмите кнопку добавления критериев.

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

--------------------

-- Чтобы изменить оператор, щелкните синее значение оператора, а затем выберите в

раскрывающемся списке другой оператор.

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

-- Чтобы создать инструкцию OR, добавьте критерий с тем же свойством.

Удаление критериев

-------------------------

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

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

Пример 1

C:\PS>get-process | out-gridview

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

Пример 2

C:\PS>$p = get-process

C:\PS> $p | out-gridview

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

Первая команда использует команду Get-Process для получения процессов компьютера и сохраняет объекты процессов в переменной $p. 

Вторая команда передает переменную $p в командлет Out-GridView с помощью оператора конвейера (|).

Пример 3

C:\PS>get-process | select-object -property name, workingset, peakworkingset | sort-object -property workingset -desc | out-gridview

Описание
-----------
Эта команда выводит в окно таблицы форматированную таблицу.

Она с помощью командлета Get-Process получает выполняющиеся на компьютере процессы. 

Затем с помощью оператора конвейера (|) она передает командлету Select-Object объекты процессов. Команда использует параметр Property командлета Select-Object, чтобы выбрать для отображения в таблице свойства Name, WorkingSet и PeakWorkingSet. 

С помощью другого оператора конвейера отфильтрованные объекты передаются командлету Sort-Object, который сортирует их по убыванию значения свойства WorkingSet.

Последняя часть команды с помощью оператора конвейера (|) передает отформатированную таблицу командлету Out-GridView.

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

Пример 4

C:\PS>($a = get-childitem -path $pshome -recurse) | out-gridview

Описание
-----------
Эта команда сохраняет результаты в переменной и передает ее командлету Out-GridView. 

Команда использует командлет Get-ChildItem для получения файлов из каталога установки Windows PowerShell и его подкаталогов. Путь к каталогу установки сохраняется в автоматической переменной $pshome. 

Команда использует оператор присваивания (=), чтобы сохранить результаты в переменной $a, и оператор конвейера (|), чтобы передать этот результат командлету Out-GridView.
Скобки определяют порядок выполнения операций в команде. В результате вывод команды Get-ChildItem сохраняется в переменной $a до передачи командлету Out-GridView.

Пример 5

C:\PS>get-process -computername Server01| ogv -title "Processes - Server01"

Описание
-----------
Эта команда отображает в окне таблицы выполняемые на компьютере Server01 процессы.  

Команда использует "ogv", встроенный псевдоним командлета Out-GridView, который задает заголовок окна с помощью параметра Title.

Пример 6

C:\PS>invoke-command -ComputerName S1, S2, S3 -scriptblock {get-culture} | out-gridview

Описание
-----------
Этот пример показывает правильный формат отправки данных, собранных с удаленных компьютеров, командлету Out-GridView.

Команда использует командлет Invoke-Command для выполнения команды Get-Culture на трех удаленных компьютерах. С помощью оператора конвейера (|) она передает возвращенные данные командлету Out-GridView.

Обратите внимание, что блок скрипта, содержащий выполняемые удаленно команды, не включает команду Out-GridView. В противном случае команда выдавала бы ошибку при попытке открыть окна таблицы на всех удаленных компьютерах.