Compartilhar via

Out-GridView

  • Referência
Módulo:
Microsoft.PowerShell.Utility

Envia a saída para uma tabela interativa em uma janela separada.

Syntax

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

Description

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.

Como esse cmdlet exige uma interface do usuário, ele não funciona em instalações Server Core do Windows Server.

Você pode usar os recursos da tabela a seguir para examinar os seus dados:

  • Ocultar, Mostrar e Reordenar Colunas: para ocultar, mostrar ou reordenar uma coluna, clique com o botão direito do mouse em um cabeçalho de coluna e clique em Selecionar Colunas.
  • Tipo. Para classificar os dados, clique em um cabeçalho de coluna. Clique novamente para alternar a ordem de crescente para decrescente.
  • Filtro Rápido. Use a caixa Filtrar na parte superior da janela para pesquisar o texto na tabela. Você pode pesquisar o texto em uma coluna específica, procurar por literais e por várias palavras.
  • Filtro de Critérios. Use o menu suspenso Adicionar critérios para criar regras para filtrar os dados. Isso é muito útil para grandes conjuntos de dados, como logs de eventos.
  • Copiar e colar. Para copiar linhas de dados de Out-GridView, pressione CTRL+C (cópia). Você pode colar os dados em qualquer programa de texto ou planilha.

Para obter instruções sobre como usar esses recursos, digite Get-Help Out-GridView -Full e consulte How to Use the Grid View Window Features na seção Notes.

Exemplos

Exemplo 1: processos de saída para uma exibição de grade

PS C:\> Get-Process | Out-GridView

Esse comando obtém os processos em execução no computador local e os envia para uma janela de exibição em grade.

Exemplo 2: Usar uma variável para gerar processos para uma exibição de grade

PS C:\> $P = Get-Process
PS C:\> $P | Out-GridView

Esse comando também obtém os processos em execução no computador local e os envia para uma janela de exibição em grade.

O primeiro comando usa o cmdlet 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: exibir uma tabela formatada em um modo de exibição de grade

PS C:\> Get-Process | Select-Object -Property Name, WorkingSet, PeakWorkingSet | Sort-Object -Property WorkingSet -Descending | Out-GridView

Esse comando exibe uma tabela formatada em uma janela de exibição em grade.

Ele usa o cmdlet Get-Process para obter os processos no computador.

Em seguida, ele usa um operador de pipeline (|) para enviar os objetos de processo para o cmdlet Select-Object. O comando usa o parâmetro Property do Select-Object para selecionar as propriedades Name, WorkingSet e PeakWorkingSet que serão exibidas na tabela.

Outro operador de pipeline envia os objetos filtrados para o cmdlet Sort-Object, que os classifica em ordem decrescente pelo valor da propriedade WorkingSet .

A parte final do comando usa um operador de pipeline (|) para enviar a tabela formatada para o Out-GridView.

Agora você pode usar os recursos de exibição em grade para pesquisar, classificar e filtrar os dados.

Exemplo 4: salvar a saída em uma variável e, em seguida, gerar uma exibição de grade

PS C:\> ($A = Get-ChildItem -Path $pshome -Recurse) | Out-GridView

Este comando salva sua saída em uma variável e o envia ao Out-GridView.

O comando usa o cmdlet Get-ChildItem para obter os arquivos no diretório de instalação Windows PowerShell e seus subdiretórios. 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 no operador de pipeline (|) para enviar a saída para Out-GridView.

Os parênteses no comando estabelecem a ordem das 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: processos de saída de um computador especificado para uma exibição de grade

PS C:\> Get-Process -ComputerName "Server01" | ogv -Title "Processes - Server01"

Esse comando exibe os processos que estão em execução no computador Server01 em uma janela de exibição em 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: gerar dados de computadores remotos para uma exibição de grade

PS C:\> Invoke-Command -ComputerName S1, S2, S3 -ScriptBlock {Get-Culture} | Out-GridView

Este exemplo mostra o formato correto para o envio de dados coletados dos 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 que são retornados para o cmdlet Out-GridView.

Observe que o bloco de script que contém os comandos que são executados remotamente não inclui o comando Out-GridView. Se incluísse, o comando falharia ao tentar abrir uma janela de exibição em grade em cada um dos computadores remotos.

Exemplo 7: passar vários itens por Out-GridView

PS C:\> Get-Process | Out-GridView -PassThru | Export-Csv -Path .\ProcessLog.csv

Este comando permite que você selecione vários processos da janela Out-GridView. Os processos que você seleciona são passados para o comando Export-Csv e escritos no arquivo ProcessLog.csv.

O comando usa o parâmetro PassThru do Out-GridView, que permite enviar vários itens pelo pipeline. O parâmetro PassThru é equivalente a usar o valor Multiple do parâmetro OutputMode.

Exemplo 8: Create um atalho do Windows para Out-GridView

PS C:\> Powershell.exe -Command "Get-Service | Out-GridView -Wait"

Este comando mostra como usar o parâmetro Wait do Out-GridView para criar um atalho do Windows para a janela Out-GridView. Sem o parâmetro Wait, o Windows PowerShell poderia sair tão logo a janela Out-GridView se abrisse, o que fecharia a janela Out-GridView quase imediatamente.

Parâmetros

-InputObject

Especifica que o cmdlet aceita entrada para Out-GridView.

Quando você usa o parâmetro InputObject para enviar uma coleção de objetos para Out-GridView, Out-GridView trata a coleção como um objeto de coleção e exibe uma linha que representa a coleção. Para exibir o cada objeto da coleção, use um operador de pipeline (|) para enviar objetos ao Out-GridView.

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

-OutputMode

Especifica os itens que a janela interativa envia para baixo do pipeline como entrada para outros comandos. Por padrão, este cmdlet não gera saída. Para enviar itens da janela interativa pelo pipeline, clique para selecionar os itens e, em seguida, clique em OK.

Os valores desse parâmetro determinam quantos itens você pode enviar pelo pipeline.

  • Nenhum. Nenhum item. Esse é o valor padrão.
  • Única. Zero itens ou um item. Use esse valor quando o próximo comando puder levar apenas um objeto de entrada.
  • Vários. Zero, um ou muitos itens. Use esse valor quando o próximo comando puder levar vários objetos de entrada. Esse valor é equivalente ao parâmetro Passthru.

Este parâmetro foi introduzido no Windows PowerShell 3.0.

Type:OutputModeOption
Accepted values:None, Single, Multiple
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Indica que o cmdlet envia itens da janela interativa para baixo do pipeline como entrada para outros comandos. Por padrão, este cmdlet não gera saída. Este parâmetro é equivalente a usar o valor Multiple do parâmetro OutputMode.

Para enviar itens da janela interativa pelo pipeline, clique para selecionar os itens e, em seguida, clique em OK. Shift+clique e Ctrl+clique são suportados.

Este parâmetro foi introduzido no Windows PowerShell 3.0.

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

-Title

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 o Out-GridView.

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

-Wait

Indica que o cmdlet suprime o prompt de comando e impede que Windows PowerShell feche até que a janela Out-GridView seja fechada. Por padrão, o prompt de comando retorna quando a janela Out-GridView é aberta.

Esse recurso permite que você use os cmdlets Out-GridView nos atalhos do Windows. Quando o Out-GridView é usado em um atalho sem o parâmetro Wait, a janela do Out-GridView aparece apenas pouco antes do Windows PowerShell ser fechado.

Este parâmetro foi introduzido no Windows PowerShell 3.0.

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

Entradas

PSObject

Você pode enviar qualquer objeto para este cmdlet.

Saídas

None

Out-GridView não retorna nenhum objeto.

Observações

  • No Windows PowerShell 2.0, o cmdlet Out-GridView é instalado por padrão nas versões do cliente do Windows, mas é um recurso opcional nas versões do Servidor do Windows. No Windows PowerShell 3.0, ele é instalado em todos os sistemas por padrão. No entanto, se você desativar ou remover o recurso ISE Windows PowerShell, o cmdlet Out-GridView também será desativado ou removido.

  • Você não pode usar um comando remoto para abrir uma janela de exibição em grade em outro computador.

  • A saída do comando que você envia para Out-GridView não pode ser formatada, como usando os cmdlets Format-Table ou Format-Wide. Para selecionar propriedades, use o cmdlet Select-Object.

  • Resultado desserializado de comandos remotos podem não ser formatados corretamente na janela de exibição em grade.

  • Atalhos de teclado para Out-GridView

    Ao usar os seguintes atalhos de teclado, você pode executar várias tarefas rapidamente.

    Use esta chave: para executar esta ação:

    TAB Move o cursor da caixa Filtro para o menu Adicionar critérios para a tabela e voltar.

    SETA PARA CIMA Mover uma linha para cima. Se moverá para cabeçalhos de coluna.

    SETA PARA BAIXO Mova uma linha para baixo.

    SETA PARA A ESQUERDA Na linha do cabeçalho da coluna, mova uma coluna para a esquerda.

    SETA PARA A DIREITA Na linha do cabeçalho da coluna, mova uma coluna para a direita.

    TECLA DE MENU DE CONTEXTO Na linha do cabeçalho da coluna, exibe a opção Selecionar Colunas.

    ENTER ou BARRA DE ESPAÇOS Na linha do cabeçalho de coluna, classifica os dados da coluna (alterna entre A-Z e A-Z).

    Como usar os recursos da janela modo de exibição de grade

    Os tópicos a seguir explicam como usar os recursos da janela exibida pelo Out-GridView .

    Como Ocultar, Mostrar e Reordenar colunas

    Para ocultar ou mostrar uma coluna:

Clique com o botão direito do mouse em qualquer cabeçalho de coluna e clique em Selecionar Colunas.

2. Na caixa de diálogo Selecionar Colunas, use as teclas de direção para mover as colunas entre as colunas Selecionadas para as caixas Colunas disponíveis. Somente as colunas na caixa Colunas Selecionadas aparecem na janela de exibição de grade.

Para reordenar colunas:

  • Arraste e solte a coluna no local desejado.

  • ou –

Clique com o botão direito do mouse em qualquer cabeçalho de coluna e clique em Selecionar Colunas.

2. Na caixa de diálogo Selecionar Colunas, use os botões Mover para cima e Mover para baixo para reordenar as colunas. As colunas na parte superior da lista aparecem à esquerda das colunas na parte inferior da lista na janela de exibição em grade.

Como classificar dados de tabela

  • Para classificar os dados, clique em um cabeçalho de coluna.

  • Para alterar a ordem de classificação, clique no cabeçalho da coluna novamente. Cada vez que você clicar no mesmo cabeçalho, a ordem de classificação alterna entre crescente para decrescente. O pedido atual é indicado 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 até 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 usando as teclas de direção.

  • Para selecionar linhas não desconsecutivas, pressione a tecla CTRL e clique para adicionar uma linha à seleção.

Não é possível selecionar colunas e nem a linha inteira de cabeçalhos de coluna.

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 programa de texto ou planilha. Não é possível copiar colunas ou partes de linhas e nem a linha de cabeçalhos de coluna.

Como Pesquisa na tabela (Filtro Rápido)

Use a caixa Filtro para pesquisar dados na tabela. Quando você digita na caixa, somente os itens que incluem o texto digitado são exibidos na tabela.

  • Pesquisa para texto. Para pesquisar texto na tabela, na caixa Filtro, digite o texto a ser encontrado.

  • Pesquisa para 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).

  • Pesquisa para frases literais. Para pesquisar frases que incluam espaços ou caracteres especiais, coloque a frase entre aspas. Out-GridView exibe linhas que incluem uma correspondência exata para a frase.

  • Pesquisa em colunas. Para pesquisar texto em uma ou mais colunas, use o seguinte formato:

<column>:<text> [<column>:<text>] ...

Por exemplo, para localizar "Net" na coluna DisplayName, na caixa Filtro, digite:

displayname:net

Para localizar linhas com "Net" nas colunas DisplayName e Name, na caixa Filtro, digite:

displayname:net name:net

  • Desative a pesquisa. Para exibir a tabela inteira novamente, clique no botão X vermelho no canto superior direito da caixa Filtro ou exclua o texto da caixa Filtro.

Use critérios para filtrar a tabela

Você pode usar regras ou critérios para determinar quais itens são exibidos na tabela. Itens aparecem somente quando atendem a todos os critérios estabelecidos por você. Os critérios disponíveis são determinados pelas propriedades dos objetos exibidos na janela de exibição em grade e tipos do .NET Framework dessas propriedades.

Cada critério tem o seguinte formato:

<valor do operador>column><<>

Critérios para propriedades diferentes são conectados por AND. Critérios para a mesma propriedade são conectados por OR. Você não pode alterar os conectores lógicos.

Os critérios afetam somente a exibição. Ele não exclui itens da tabela.

Como adicionar critérios

1. Para exibir o botão de menu Adicionar critérios, no canto superior direito da janela, clique na seta Expandir.

2. Clique no botão de menu Adicionar Critérios.

3. Clique para selecionar colunas (propriedades). Você pode selecionar uma ou mais propriedades.

4. Quando terminar de selecionar as propriedades, clique no botão Adicionar.

5. Para cancelar as adições, clique em Cancelar.

6. Para adicionar mais critérios, clique no botão Adicionar Critérios novamente.

Como editar um critério

  • Para alterar um operador, clique no valor do operador azul e clique para selecionar um operador diferente na lista suspensa.

  • Para inserir ou alterar um valor, digite um valor na caixa de valor. Se você inserir um valor que não é válido, um ícone de X circular aparece. 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 os critérios selecionados, clique no X vermelho ao lado de cada critério.

  • Para excluir todos os critérios, clique no botão Limpar Tudo.