Out-GridView
Envia a saída para uma tabela interativa em uma janela separada.
Sintaxe
PassThru (Default)
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
O cmdlet Out-GridView envia a saída de um comando para uma janela de exibição de grade em que a saída é exibida em uma tabela interativa.
Como esse cmdlet requer uma interface do usuário, ele não funciona em instalações do Server Core do Windows Server.
Você pode usar os seguintes recursos da tabela para examinar 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.
- Ordenar. Para classificar os dados, clique em um cabeçalho de coluna. Clique novamente para alternar de ordem crescente 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, pesquisar literais e pesquisar 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 conjuntos de dados muito grandes, como logs de eventos.
- Copiar e colar. Para copiar linhas de dados do Out-GridView, pressione CTRL+C (copiar). 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 Como usar os recursos da janela de exibição em grade na seção Notas.
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 de 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 de grade.
O primeiro comando usa o cmdlet Get-Process para obter os processos no computador e, em seguida, 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 de 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 de Select-Object para selecionar as propriedades Name, WorkingSet e PeakWorkingSet a serem 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 Out-GridView.
Agora você pode usar os recursos da exibição de 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
Esse 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 do Windows PowerShell e seus subdiretórios. O caminho para o diretório de instalação é salvo no $pshome variável automática.
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 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 para um computador especificado em 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 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: Saída de 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 enviar dados coletados de computadores remotos para o cmdlet Out-GridView do
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
Observe que o bloco de script que contém os comandos executados remotamente não inclui o comando Out-GridView. Se isso acontecesse, o comando falharia quando tentasse abrir uma janela de exibição de 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
Esse comando permite que você selecione vários processos na janela
O comando usa o parâmetro PassThru de 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: Criar 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
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 cada objeto na coleção, use um operador de pipeline (|) para enviar objetos para Out-GridView.
Propriedades do parâmetro
| Tipo: | PSObject |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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 no pipeline, clique para selecionar os itens e clique em OK.
Os valores desse parâmetro determinam quantos itens você pode enviar para baixo no pipeline.
- Nenhum. Nenhum item. Esse é o valor padrão.
- Único. Zero itens ou um item. Use esse valor quando o próximo comando puder usar apenas um objeto de entrada.
- Múltiplos. 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 do parâmetro
| Tipo: | OutputModeOption |
| Valor padrão: | None |
| Valores aceitos: | None, Single, Multiple |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
OutputMode
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-PassThru
Indica que o cmdlet envia itens da janela interativa para baixo no pipeline como entrada para outros comandos. Por padrão, esse cmdlet não gera nenhuma saída. Esse parâmetro é equivalente a usar o valor Multiple do parâmetro OutputMode .
Para enviar itens da janela interativa no pipeline, clique para selecionar os itens e clique em OK. Há suporte para clique em shift e ctrl-click.
Esse parâmetro foi introduzido no Windows PowerShell 3.0.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
PassThru
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Title
Especifica o texto que aparece na barra de título da janela
Por padrão, a barra de título exibe o comando que invoca Out-GridView.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Wait
Indica que o cmdlet suprime o prompt de comando e impede que o 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 do Out-GridView em atalhos do Windows. Quando Out-GridView é usado em um atalho sem o parâmetro Wait, a janela Out-GridView aparece apenas momentaneamente antes do fechamento do Windows PowerShell.
Esse parâmetro foi introduzido no Windows PowerShell 3.0.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Wait
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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 enviar qualquer objeto para esse 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 do 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 de grade em outro computador.
A saída do comando que você envia para Out-GridView não pode ser formatada, por exemplo, usando os cmdlets Format-Table ou Format-Wide. Para selecionar propriedades, use o cmdlet Select-Object.
A saída desserializada de comandos remotos pode não ser formatada corretamente na janela de exibição de grade.
Atalhos de teclado para Out-GridView
Usando os seguintes atalhos de teclado, você pode executar muitas tarefas rapidamente.
Use esta chave:Para executar esta ação:
TAB Move o cursor da caixa Filtrar para o menu Adicionar critérios para a tabela e voltar.
SETA PARA CIMA Mover para cima uma linha. Moverá para cabeçalhos de coluna.
SETA PARA BAIXO Mover para baixo uma linha.
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 para a direita uma coluna.
TECLA DO MENU DE CONTEXTO Na linha do cabeçalho da coluna, exibe a opção Selecionar colunas.
ENTER 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 em grade
Os tópicos a seguir explicam como usar os recursos da janela que Out-GridView exibe.
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 seta 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 em 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 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 a ordem crescente e decrescente. A ordem atual é indicada por um triângulo no cabeçalho da coluna.
Como selecionar dados de 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 ao clicar nas linhas ou usar as teclas de direção.
Para selecionar linhas não desconsecutivas, pressione a tecla CTRL e clique para adicionar uma linha à seleção.
Você não pode selecionar colunas e não pode selecionar a linha de cabeçalho de 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 programa de texto ou planilha. Você não pode copiar colunas ou partes de linhas e não pode copiar a linha do cabeçalho da coluna.
Como pesquisar 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 aparecem na tabela.
Pesquise texto. Para pesquisar texto na tabela, na caixa Filtro, digite o texto a ser localizado.
Pesquise 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).
Pesquise 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.
Pesquise em colunas. Para pesquisar texto em uma ou mais colunas, use o seguinte formato:
<coluna>:< de texto>[<de coluna de>:<texto>] ...
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 nome: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.
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 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 de grade e pelos tipos do .NET Framework dessas propriedades.
Cada critério tem o seguinte formato:
<operador de><de coluna><valor>
Os critérios para propriedades diferentes são conectados por AND. Os critérios para a mesma propriedade são conectados por OR. 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 muitas 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 azul do operador e, em seguida, 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 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 tudo.