Out-GridView
Envia a saída para uma tabela interativa em uma janela separada.
Sintaxe
Out-GridView [-InputObject <psobject>] [-Title <string>] [<CommonParameters>]
Descrição
O cmdlet Out-GridView envia a saída de um comando para uma janela de exibição de grade onde a saída é exibida em uma tabela interativa. Este recurso requer Microsoft .NET Framework 3.5 com Service Pack 1.
Você pode usar os seguintes recursos da tabela para examinar seus dados:
-- Ocultar, Mostrar e Reordenar Colunas. Para ocultar, mostrar ou reorganizar uma coluna, clique com o botão direito em um cabeçalho de coluna e, em seguida, clique em "Selecionar Colunas".
-- Classificar. Para classificar os dados, clique em um cabeçalho de coluna. Clique novamente para ativar /desativar da ordem ascendente para decrescente.
-- Filtro Rápido. Use a caixa "Filtro" na parte superior da janela para pesquisar o texto na tabela. Você pode pesquisar texto em uma coluna específica, palavras exatas e várias palavras.
-- Filtro de Critérios. Use o menu suspenso "Adicionar critérios" para criar regras para filtrar os dados. Isto é muito útil para conjuntos de dados muito grandes, como logs de eventos.
-- Copiar e colar. Para copiar linhas de dados de Out-GridView, pressione CTRL+C (copiar). Você pode colar os dados em qualquer texto ou programa de planilha eletrônica.
Para obter instruções sobre como usar esses recursos, digite "Get-Help out-gridview - full" e consulte "Como usar os recursos da janela de exibição em grade" na seção de OBSERVAÇÕES.
Parâmetros
-InputObject <psobject>
Aceita entrada para Out-GridView.
Quando você usar o parâmetro InputObject para enviar uma coleção (mais de uma) de objetos para Out-GridView, Out-GridView tratará a coleção como um objeto de coleção e exibirá uma única linha que representa a coleção. Para exibir cada objeto na coleção, use um operador de pipeline (|) para enviar objetos a Out-GridView.
Necessário? |
false |
Posição? |
named |
Valor padrão |
|
Aceitar entrada do pipeline? |
true (ByValue) |
Aceitar caracteres curinga? |
false |
-Title <string>
Especifica o texto que aparece na barra de título da janela Out-GridView.
Por padrão, a barra de título exibe o comando que invoca Out-GridView.
Necessário? |
false |
Posição? |
named |
Valor padrão |
O comando atual |
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
false |
<CommonParameters>
Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.
Entradas e saídas
O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.
Entradas |
System.Management.Automation.PSObject É possível enviar qualquer objeto para Out-GridView. |
Saídas |
Nenhum Out-GridView não retorna objetos. |
Observações
OBSERVAÇÕES PARA OUT-GRIDVIEW
----------------------
Você pode baixar o Microsoft .NET Framework 3.5 com Service Pack 1 do Centro de Download da Microsoft.
Como esse cmdlet requer uma interface de usuário, ele não funciona com instalações Server Core do Windows Server.
Você não pode usar um comando remoto para abrir uma janela de exibição de grade em um computador remoto.
A saída do comando que você envia não pode ser pré-formatada, como usando os cmdlets Format-Table ou Format-Wide. Para selecionar propriedades, use o cmdlet Select-Object.
Saídas retiradas da série de comandos remotos podem não ser formatadas corretamente na janela de exibição de grade.
ATALHOS DE TECLADO PARA OUT-GRIDVIEW
-----------------------------------
Usando os atalhos de teclado seguintes, você pode executar muitas tarefas rapidamente.
Use esta tecla: Para executar esta ação:
------------- ----------------------------------------------------------------
TAB Move o cursor da caixa Filter para o menu Add criteria para a tabela e vice-versa.
SETA PARA CIMA Move uma linha acima. Moverá para cabeçalhos de coluna.
SETA PARA BAIXO Move uma linha abaixo.
SETA PARA A ESQUERDA Na linha do cabeçalho de coluna, mova uma coluna para a esquerda.
SETA PARA A DIREITA Na linha do cabeçalho de coluna, mova uma coluna para a direita.
TECLA DE MENU CONTEXTUAL Na linha do cabeçalho de coluna, exibe a opção "Select Columns".
ENTER ou BARRA DE ESPAÇOS Na linha de cabeçalho da coluna, classifica os dados da coluna (alterna entre A-Z e Z-A).
COMO USAR OS RECURSOS DA JANELA DE EXIBIÇÃO DE GRADE
----------------------------------------
Os tópicos a seguir explicam como usar os recursos da janela que o Out-GridView exibe.
Como ocultar, mostrar e reorganizar colunas
--------------------------------------
Para ocultar ou mostrar uma coluna:
1. Clique com o botão direito em qualquer cabeçalho de coluna e clique em "Select Columns".
2. Na caixa de diálogo "Select Columns", use as teclas de direção para mover as colunas entre as caixas "Selected columns" e "Available columns". Somente as colunas da caixa "Selected Columns" aparecem na janela de exibição de grade.
Para reorganizar colunas:
-- Arraste e solte a coluna no local desejado.
- ou-
1. Clique com o botão direito em qualquer cabeçalho de coluna e clique em "Select Columns".
2. Na caixa de diálogo "Select Columns", use os botões "Move up" e "Move down" para reorganizar as colunas. As colunas da parte superior da lista aparecem à esquerda das colunas da parte inferior da lista na janela de exibição de grade.
Como classificar dados da tabela
----------------------
-- Para classificar os dados, clique em um cabeçalho de coluna.
-- Para alterar a ordem de classificação, clique novamente no cabeçalho de coluna. Toda vez que você clicar no mesmo cabeçalho, a ordem de classificação muda de ascendente para descendente. A ordem atual é indicada por um triângulo no cabeçalho da coluna.
Como selecionar dados da tabela
------------------------
-- Para selecionar uma linha, clique na linha ou use a seta para cima ou para baixo para navegar para a linha.
-- Para selecionar todas as linhas (exceto a linha de cabeçalho), pressione CTRL+A.
-- Para selecionar linhas consecutivas, pressione e segure a tecla SHIFT enquanto clica nas linhas ou usa as teclas de direção.
-- Para selecionar linhas não consecutivas, pressione a tecla CTRL e clique para adicionar uma linha à seleção.
Você não pode selecionar colunas nem a linha de cabeçalho da coluna inteira.
Como copiar linhas
----------------------
-- Para copiar uma ou mais linhas da tabela, selecione as linhas e pressione CTRL+C.
Você pode colar os dados em qualquer texto ou programa de planilha eletrônica. Não é possível copiar colunas ou partes de linhas, nem copiar a linha de cabeçalho da coluna.
Como pesquisar na tabela (Filtro Rápido)
---------------------------------
Use a caixa "Filter" para pesquisar dados na tabela. Quando você digita na caixa, somente os itens que incluem o texto digitado aparecem na tabela.
-- Pesquisar texto. Para pesquisar o texto na tabela, na caixa "Filter", digite o texto a ser localizado.
-- Pesquisar várias palavras. Para pesquisar várias palavras na tabela, digite as palavras separadas por espaços. Out-GridView exibe linhas que incluem todas as palavras (AND lógico).
-- Pesquisar frases exatas. Para procurar frases que incluem espaços ou caracteres especiais, coloque a frase entre aspas. Out-GridView exibe linhas que incluem uma correspondência exata para a frase.
--Pesquisar em colunas. Para pesquisar texto em uma ou mais colunas, use o seguinte formato:
<coluna>:<texto> [<coluna>:<texto>] ...
Por exemplo, para localizar "Net" na coluna DisplayName, na caixa "Filter", digite:
displayname:net
Para localizar linhas com "Net" nas colunas DisplayName e Name, na caixa "Filter", digite:
displayname:net name:net
--Desative a pesquisa. Para exibir a tabela inteira de novo, clique no botão X vermelho no canto superior direito da caixa "Filter" ou exclua o texto da caixa Filter.
Usar critérios para filtrar a tabela
--------------------------------
Você pode usar regras ou "critérios" para determinar quais itens serão exibidos na tabela. Os itens só aparecem quando eles atendem a todos os critérios estabelecidos. Os critérios disponíveis são determinados pelas propriedades dos objetos mostradas na janela de exibição de grade e pelos tipos do .NET Framework dessas propriedades.
Cada critério tem o seguinte formato:
<coluna> <operador> <valor>
Os critérios de propriedades diferentes são conectados por AND. Os critérios da mesma propriedade são conectados por OU. Não é possível alterar os conectores lógicos.
Os critérios só afetam a exibição. Ele não exclui itens da tabela.
Como adicionar critérios
---------------------------
1. Para exibir o botão de menu "Add criteria", no canto superior direito da janela, clique na seta "Expanda".
2. Clique no botão de menu "Add Criteria".
3. Clique para selecionar colunas (propriedades). Você pode selecionar uma ou mais propriedades.
4. Quando você terminar de selecionar propriedades, clique no botão Add.
5. Para cancelar as adições, clique em Cancelar.
6. Para adicionar mais critérios, clique no botão Add Criteria novamente.
Como editar um critério
--------------------
-- Para alterar um operador, clique no valor de operador azul e, em seguida, clique para selecionar outro
operador na lista suspensa.
-- Para inserir ou alterar um valor, digite um valor na caixa de valor. Se você inserir um valor que não seja válido, um ícone de X circular aparecerá. Para removê-lo, altere o valor.
-- Para criar uma instrução OR, adicione um critério com a mesma propriedade.
Como excluir critérios
-------------------------
-- Para excluir critérios selecionados, clique no X vermelho ao lado de cada critério.
-- Para excluir todos os critérios, clique no botão "Clear All".
Exemplo 1
C:\PS>get-process | out-gridview
Descrição
-----------
Este comando obtém os processos em execução no computador local e os envia a uma janela de exibição de grade.
Exemplo 2
C:\PS>$p = get-process
C:\PS> $p | out-gridview
Descrição
-----------
Este comando também obtém os processos em execução no computador local e os envia a uma janela de exibição de grade.
O primeiro comando usa o comando Get-Process para obter os processos no computador e salva os objetos de processo na variável $p.
O segundo comando usa um operador de pipeline para enviar a variável $p para Out-GridView.
Exemplo 3
C:\PS>get-process | select-object -property name, workingset, peakworkingset | sort-object -property workingset -desc | out-gridview
Descrição
-----------
Este comando exibe uma tabela formatada em uma janela de exibição de grade.
Ele usa o cmdlet Get-Process para obter os processos no computador.
Em seguida, ele usa o operador de pipeline (|) para enviar os objetos do processo ao cmdlet Select-Object. O comando usa o parâmetro Property de Select-Object para selecionar as propriedades Name, WorkingSet e PeakWorkingSet para serem exibidas na tabela.
Outro operador de pipeline envia os objetos filtrados para o cmdlet Sort-Object, que os classifica em ordem decrescente de acordo com o valor da propriedade TimeCreated.
A parte final do comando usa um operador de pipeline (|) para enviar a tabela formatada para Out-GridView.
Agora você pode usar os recursos do modo de exibição de grade para pesquisar, classificar e filtrar dados.
Exemplo 4
C:\PS>($a = get-childitem -path $pshome -recurse) | out-gridview
Descrição
-----------
Este comando salva sua saída em uma variável e a envia para Out-GridView.
O comando usa o cmdlet Get-ChildItem para obter os arquivos no diretório de instalação e nos subdiretórios do Windows PowerShell. O caminho para o diretório de instalação é salvo na variável automática $pshome.
O comando usa o operador de atribuição (=) para salvar a saída na variável $a e o operador de pipeline (|) para enviar a saída para Out-GridView.
Os parênteses do comando estabelecem a ordem de operações. Como resultado, a saída do comando Get-ChildItem é salva na variável $a antes de ser enviada para Out-GridView.
Exemplo 5
C:\PS>get-process -computername Server01| ogv -title "Processes - Server01"
Descrição
-----------
Esse comando exibe os processos que estão sendo executados no computador Server01 em uma janela de exibição de grade.
O comando usa "ogv", que é o alias interno para o cmdlet Out-GridView; ele usa o parâmetro Title para especificar o título da janela.
Exemplo 6
C:\PS>invoke-command -ComputerName S1, S2, S3 -scriptblock {get-culture} | out-gridview
Descrição
-----------
Esse exemplo mostra o formato correto para enviar dados coletados de computadores remotos para o cmdlet Out-GridView.
O comando usa o cmdlet Invoke-Command para executar um comando Get-Culture em três computadores remotos. Ele usa um operador de pipeline para enviar os dados retornados para o cmdlet Out-GridView.
Observe que o bloco de script que contém os comandos executados remotamente não inclui o comando Out-GridView. Se incluísse, o comando falharia ao tentar abrir uma janela de exibição de grade em cada computador remoto.