Partilhar via

Out-GridView

Módulo:
Microsoft.PowerShell.Utility Module

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

Sintaxe

PassThru (Predefinição) 

Out-GridView
    [-InputObject <PSObject>]
    [-Title <String>]
    [-PassThru]
    [<CommonParameters>]

Wait 

Out-GridView
    [-InputObject <PSObject>]
    [-Title <String>]
    [-Wait]
    [<CommonParameters>]

OutputMode 

Out-GridView
    [-InputObject <PSObject>]
    [-Title <String>]
    [-OutputMode <OutputModeOption>]
    [<CommonParameters>]

Description

Este cmdlet só está disponível na plataforma Windows.

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 requer uma interface do usuário, ele não funciona no Windows Server Core ou no Windows Nano Server.

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

  • Ocultar, mostrar e reordenar colunas
  • Ordenar linhas
  • Filtro rápido
  • Adicionar filtro de critérios
  • Copiar e colar

Para obter instruções completas, consulte a seção Notas deste artigo.

Observação

Este cmdlet foi reintroduzido no PowerShell 7. Este cmdlet só está disponível em sistemas Windows que suportam a Área de Trabalho do Windows. Para obter uma versão multiplataforma desse cmdlet, consulte o módulo ConsoleGuiTools do na Galeria do PowerShell.

Exemplos

Exemplo 1: Processos de saída para uma vista de grelha

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

Get-Process | Out-GridView

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

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

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

A saída do cmdlet Get-Process é salva na variável $P. Em seguida, $P é canalizado para Out-GridView.

Exemplo 3: Exibir propriedades selecionadas em um modo de exibição de grade

Este exemplo exibe as propriedades selecionadas dos processos em execução em uma exibição de grade.

Get-Process | Select-Object -Property Name, WorkingSet, PeakWorkingSet |
  Sort-Object -Property WorkingSet -Descending | Out-GridView

A saída de Get-Process é canalizada para Select-Object selecionar as propriedades Name, WorkingSete PeakWorkingSet. Outro operador de pipeline envia os objetos filtrados para o cmdlet Sort-Object para classificá-los em ordem decrescente pelo valor da propriedade WorkingSet. Em seguida, os resultados classificados são canalizados para Out-GridView. Agora você pode usar os recursos da 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

Este exemplo salva a saída do cmdlet em uma variável e a envia para Out-GridView.

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

Get-ChildItem obtém todos os arquivos no diretório de instalação do PowerShell e seus subdiretórios usando a variável automática $PSHOME. 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 em grade

Este exemplo exibe os processos que estão sendo executados no computador Server01 em uma janela de exibição de grade.

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

O exemplo usa ogv, que é o alias do cmdlet Out-GridView. O parâmetro Title especifica o título da janela.

Exemplo 6: Saída de dados de computadores remotos para uma vista de grelha

Este exemplo mostra como enviar dados coletados de computadores remotos para Out-GridView.

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

Invoke-Command é executado Get-Culture em três computadores remotos. Os dados resultantes são canalizados para Out-GridView. Observe que o bloco de script executado no computador remoto não inclui o comando Out-GridView. Se o fizesse, o comando falharia quando tentasse abrir uma janela de visualização em grelha em cada um dos computadores remotos.

Exemplo 7: Passar vários itens através de 'Out-GridView'

Este exemplo permite selecionar vários processos na janela Out-GridView. Os processos selecionados são passados para o comando Export-Csv e gravados no arquivo ProcessLog.csv.

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

O PassThru parâmetro de Out-GridView permite enviar vários itens pelo pipeline. O parâmetro PassThru é equivalente ao uso do valor Multiple do parâmetro OutputMode.

Exemplo 8: Criar um atalho do Windows para 'Out-GridView'

Este exemplo mostra como usar o parâmetro Wait do Out-GridView para criar um atalho do Windows para a janela Out-GridView.

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

Esta linha de comando pode ser usada em um atalho do Windows. Sem o parâmetro Wait, o PowerShell seria encerrado assim que a janela Out-GridView fosse aberta, o que fecharia a janela Out-GridView quase imediatamente.

Parâmetros

-InputObject

Especifica o objeto que o cmdlet aceita como 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 cada objeto na coleção, use um operador de pipeline (|) para enviar objetos para Out-GridView.

Propriedades dos parâmetros

Tipo:PSObject
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-OutputMode

Especifica os itens que a janela interativa envia pelo pipeline como entrada para outros comandos. Por padrão, esse cmdlet não gera nenhuma saída. Para enviar itens da janela interativa para baixo no 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.

  • None. Sem itens. Este é o valor padrão.
  • Single. Zero itens ou um item. Use esse valor quando o próximo comando puder usar apenas um objeto de entrada.
  • Multiple. Zero, um ou muitos itens. Use esse valor quando o próximo comando puder usar vários objetos de entrada. Esse valor é equivalente ao parâmetro PassThru.

Esse parâmetro foi introduzido no Windows PowerShell 3.0.

Propriedades dos parâmetros

Tipo:OutputModeOption
Default value:None
Valores aceites:None, Single, Multiple
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

OutputMode
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-PassThru

Indica que o cmdlet envia itens da janela interativa para baixo do pipeline como entrada para outros comandos. Por padrão, esse cmdlet não gera nenhuma saída. Esse parâmetro é equivalente ao uso do valor Multiple do parâmetro OutputMode.

Para enviar itens da janela interativa para baixo no pipeline, clique para selecionar os itens e, em seguida, clique em OK. Shift-click e Ctrl-click são suportados.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

PassThru
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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 Out-GridView.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Wait

Indica que o cmdlet suprime o prompt de comando e impede que o Windows PowerShell seja fechado 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 Out-GridView é usado em um atalho sem o parâmetro Wait, a janela Out-GridView aparece apenas momentaneamente antes do PowerShell fechar.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

Wait
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

PSObject

Você pode canalizar qualquer objeto para este cmdlet.

Saídas

None

Por padrão, esse cmdlet não retorna nenhuma saída.

PSObject

Quando você usa o parâmetro PassThru, esse cmdlet retorna objetos que representam as linhas selecionadas.

Notas

O PowerShell inclui os seguintes aliases para Out-GridView:

  • Windows:
    • ogv

Este cmdlet só está disponível em plataformas Windows. Este cmdlet só está disponível em plataformas Windows.

Não é possível usar um comando remoto para abrir uma janela de exibição de grade em outro computador.

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

A saída desserializada de comandos remotos pode não estar formatada corretamente na janela de exibição de grade.

Atalhos de teclado paraOut-GridView

Use esta chave: Para executar esta ação:
Tab Move o cursor da caixa Filtro de para o menu Adicionar critérios à tabela e vice-versa.
UpArrow Mover uma linha para cima. Move para cabeçalhos de coluna da primeira linha de dados.
DownArrow Mover uma linha para baixo.
Seta para a esquerda Na linha de cabeçalho da coluna, mova uma coluna para a esquerda.
Seta para a direita Na linha de cabeçalho da coluna, mova uma coluna para a direita.
ContextMenuKey Na linha de cabeçalho da coluna, exibe a opção Selecionar Colunas.
Digite ou Barra de espaço Na linha de cabeçalho da coluna, classifique os dados da coluna (alterne A-Z, Z-A).

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

Para ocultar ou mostrar uma coluna:

  1. Clique com o botão direito do rato em qualquer cabeçalho de coluna e clique Selecionar Colunas.
  2. Na caixa de diálogo Selecionar Colunas, use as teclas de seta para mover as colunas entre as colunas Selecionadas para as caixas Colunas disponíveis. Apenas as colunas na caixa Selecionar Colunas aparecem na janela de exibição de grade.

Para reordenar colunas:

Você pode arrastar e soltar colunas no local desejado. Ou use as seguintes etapas:

  1. Clique com o botão direito do rato em qualquer cabeçalho de coluna e clique 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 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 no cabeçalho da coluna novamente. Cada vez que você clica no mesmo cabeçalho, a ordem de classificação alterna entre ordem crescente e decrescente. A ordem atual é indicada por um triângulo no cabeçalho da coluna.

Como selecionar dados da tabela

  • Para selecionar uma linha, selecione-a 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, mantenha pressionada a tecla SHIFT enquanto clica nas linhas ou usa as teclas de seta.
  • Para selecionar linhas não consecutivas, pressione a tecla CTRL e clique para adicionar uma linha à seleção.
  • Não é possível selecionar colunas e não é possível selecionar toda a linha de cabeçalho da 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 não é possível copiar a linha de cabeçalho da coluna.

Como pesquisar na tabela (filtro rápido)

Use a caixa Filtro para procurar dados na tabela. Quando você digita na caixa, somente os itens que incluem o texto digitado aparecem na tabela.

  • Procurar texto. Para procurar texto na tabela, na caixa Filtro, escreva o texto a localizar.

  • Pesquise várias palavras. Para procurar várias palavras na tabela, digite as palavras separadas por espaços. Out-GridView exibe linhas que incluem todas as palavras (lógico E).

  • Procure frases literais. Para procurar 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.

  • Pesquisar em colunas. Para procurar texto em uma ou mais colunas, use o seguinte formato:

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

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

    displayname:net

    Para encontrar linhas com "Net" no DisplayName e colunas Nome, 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 de ou exclua o texto da caixa Filtro de.

usar critérios para filtrar a tabela

Você pode usar regras ou critérios para determinar quais itens são exibidos na tabela. Os itens aparecem apenas quando satisfazem todos os critérios que você estabelece. Os critérios disponíveis são determinados pelas propriedades dos objetos exibidos na janela de exibição de grade e os tipos .NET Framework dessas propriedades.

Cada critério tem o seguinte formato:

<column> <operator> <value>

Os critérios para diferentes propriedades estão ligados por E. Os critérios para a mesma propriedade são conectados por OU. Não é possível alterar os conectores lógicos.

Os critérios afetam apenas 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 várias 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 selecione 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 X circular será exibido. 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 todos os.