Out-GridView

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

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 em instalações 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 rato num cabeçalho de coluna e, em seguida, clique em Selecionar Colunas.
• Ordenar. Para classificar os dados, clique em um cabeçalho de coluna. Clique novamente para alternar da ordem crescente para a ordem 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.
• Copie e cole. Para copiar linhas de dados de 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 de grade na seção Notas.

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

Este comando obtém os processos em execução no computador local e envia-os para uma janela de visualização em grelha.

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

Este 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.

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

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 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 em grade para pesquisar, classificar e filtrar os dados.

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

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 do 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 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.

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

Este 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.

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.

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 que são executados remotamente 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.

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

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

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

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

Este comando mostra como usar o parâmetro Wait de Out-GridView para criar um atalho do Windows para a janela Out-GridView . Sem o parâmetro Wait, o Windows PowerShell seria encerrado assim que a janela Out-GridView fosse aberta, o que fecharia a janela Out-GridView quase imediatamente.

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.

Você pode enviar qualquer objeto para este cmdlet.

Out-GridView não retorna nenhum objeto.

• No Windows PowerShell 2.0, o cmdlet Out-GridView é instalado por padrão em versões de cliente do Windows, mas é um recurso opcional em versões de 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.

• 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, como 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 estar 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 Filtro para o menu Adicionar critérios à tabela e vice-versa.

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

  SETA PARA BAIXO 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.

  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 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. Apenas 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 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, clique nela 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 (AND lógico).

• 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:

<coluna>:<texto> [<coluna>:<texto>] ...

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

displayname:rede

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

displayname:nome da rede: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 satisfazem todos os critérios estabelecidos. 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:

<operador de><coluna><valor>

Os critérios para diferentes propriedades estão ligados por E. 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 do 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, 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.