Partilhar via

Out-GridView

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

Envia a saída para uma tabela interativa numa 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 vista de grelha onde a saída é apresentada numa tabela interativa.

Uma vez que este cmdlet requer uma interface de utilizador, não funciona nas instalações server Core do Windows Server.

Pode utilizar as seguintes funcionalidades da tabela para examinar os 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 ordenar os dados, clique num cabeçalho de coluna. Clique novamente para alternar de ascendente para ordem descendente.
  • Filtro Rápido. Utilize a caixa Filtro na parte superior da janela para procurar o texto na tabela. Pode procurar texto numa coluna específica, procurar literais e procurar várias palavras.
  • Filtro de Critérios. Utilize o menu pendente Adicionar critérios para criar regras para filtrar os dados. Isto é muito útil para conjuntos de dados muito grandes, como registos de eventos.
  • Copiar e colar. Para copiar linhas de dados de Out-GridView, prima CTRL+C (copiar). Pode colar os dados em qualquer texto ou programa de folha de cálculo.

Para obter instruções para utilizar estas funcionalidades, escreva Get-Help Out-GridView -Full e veja Como Utilizar as Funcionalidades da Janela da Vista de Grelha na secção Notas.

Exemplos

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

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

Este comando executa os processos no computador local e envia-os para uma janela de vista de grelha.

Exemplo 2: utilizar uma variável para exportar processos para uma vista de grelha

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

Este comando também executa os processos no computador local e envia-os para uma janela de vista de grelha.

O primeiro comando utiliza o cmdlet Get-Process para obter os processos no computador e, em seguida, guarda os objetos de processo na variável $P.

O segundo comando utiliza um operador de pipeline para enviar a variável $P para Out-GridView.

Exemplo 3: apresentar uma tabela formatada numa vista de grelha

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

Este comando apresenta uma tabela formatada numa janela de vista de grelha.

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

Em seguida, utiliza um operador de pipeline (|) para enviar os objetos de processo para o cmdlet Select-Object. O comando utiliza o parâmetro Propriedade de Select-Object para selecionar as propriedades Nome, WorkingSet e PeakWorkingSet a apresentar na tabela.

Outro operador de pipeline envia os objetos filtrados para o cmdlet Sort-Object, que os ordena por ordem descendente pelo valor da propriedade WorkingSet .

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

Agora pode utilizar as funcionalidades da vista de grelha para procurar, ordenar e filtrar os dados.

Exemplo 4: Guarde a saída numa variável e, em seguida, produza uma vista de grelha

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

Este comando guarda o resultado numa variável e envia-o para Out-GridView.

O comando utiliza o cmdlet Get-ChildItem para obter os ficheiros no diretório de instalação Windows PowerShell e nos respetivos subdiretórios. O caminho para o diretório de instalação é guardado na variável automática $pshome.

O comando utiliza o operador de atribuição (=) para guardar 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, o resultado do comando Get-ChildItem é guardado na variável $A antes de ser enviado para Out-GridView.

Exemplo 5: Processos de saída de um computador especificado para uma vista de grelha

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

Este comando apresenta os processos em execução no computador Server01 numa janela de vista de grelha.

O comando utiliza ogv, que é o alias incorporado para o cmdlet Out-GridView , utiliza o parâmetro Título para especificar o título da janela.

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

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

Este exemplo mostra o formato correto para enviar dados recolhidos de computadores remotos para o cmdlet Out-GridView .

O comando utiliza o cmdlet Invoke-Command para executar um comando Get-Culture em três computadores remotos. Utiliza um operador de pipeline para enviar os dados que são devolvidos ao cmdlet Out-GridView .

Tenha em atenção que o bloco de scripts que contém os comandos que são executados remotamente não inclui o comando Out-GridView . Se o fizesse, o comando falharia quando tentava abrir uma janela de vista de grelha em cada um dos computadores remotos.

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

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

Este comando permite-lhe selecionar vários processos na janela Out-GridView . Os processos que selecionar são transmitidos para o comando Export-Csv e escritos no ficheiro ProcessLog.csv.

O comando utiliza o parâmetro PassThru de Out-GridView, que lhe permite enviar vários itens pelo pipeline. O parâmetro PassThru é equivalente à utilização do valor Múltiplo 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 utilizar o parâmetro Aguardar do Out-GridView para criar um atalho do Windows para a janela Out-GridView . Sem o parâmetro Aguardar, Windows PowerShell sairia assim que a janela Out-GridView fosse aberta, o que fecharia quase imediatamente a janela Out-GridView.

Parâmetros

-InputObject

Especifica que o cmdlet aceita entradas para Out-GridView.

Quando utiliza o parâmetro InputObject para enviar uma coleção de objetos para Out-GridView, o Out-GridView trata a coleção como um objeto de coleção e apresenta uma linha que representa a coleção. Para apresentar cada objeto na coleção, utilize um operador de pipeline (|) para enviar objetos para 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 predefinição, este cmdlet não gera quaisquer dados. Para enviar itens da janela interativa para baixo no pipeline, clique para selecionar os itens e, em seguida, clique em OK.

Os valores deste parâmetro determinam quantos itens pode enviar para baixo no pipeline.

  • Nenhum. Sem itens. Este é o valor predefinido.
  • Simples. Zero itens ou um item. Utilize este valor quando o comando seguinte só puder utilizar um objeto de entrada.
  • Múltiplos. Zero, um ou muitos itens. Utilize este valor quando o comando seguinte puder utilizar vários objetos de entrada. Este 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 no pipeline como entrada para outros comandos. Por predefinição, este cmdlet não gera quaisquer dados. Este parâmetro é equivalente à utilização do valor Múltiplo 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. São suportados shift-click e Ctrl-click.

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 predefinição, a barra de título apresenta o comando que invoca 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 a linha de comandos e impede Windows PowerShell de fechar até que a janela Out-GridView seja fechada. Por predefinição, a linha de comandos devolve quando a janela Out-GridView é aberta.

Esta funcionalidade permite-lhe utilizar os cmdlets Out-GridView nos atalhos do Windows. Quando Out-GridView é utilizado num atalho sem o parâmetro Aguardar, a janela Out-GridView só é apresentada momentaneamente antes de Windows PowerShell fechar.

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

Pode enviar qualquer objeto para este cmdlet.

Saídas

None

Out-GridView não devolve objetos.

Notas

  • No Windows PowerShell 2.0, o cmdlet Out-GridView está instalado por predefinição nas versões de cliente do Windows, mas é uma funcionalidade opcional nas versões do Servidor do Windows. No Windows PowerShell 3.0, está instalado em todos os sistemas por predefinição. No entanto, se desativar ou remover a funcionalidade ISE Windows PowerShell, o cmdlet Out-GridView também será desativado ou removido.

  • Não pode utilizar um comando remoto para abrir uma janela de vista de grelha noutro computador.

  • A saída do comando que enviar para Out-GridView não pode ser formatada, como, por exemplo, ao utilizar os cmdlets Format-Table ou Format-Wide. Para selecionar propriedades, utilize o cmdlet Select-Object.

  • A saída deserializada a partir de comandos remotos pode não estar formatada corretamente na janela da vista de grelha.

  • Atalhos de Teclado para Out-GridView

    Ao utilizar os seguintes atalhos de teclado, pode executar muitas tarefas rapidamente.

    Utilize esta chave:Para efetuar esta ação:

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

    Seta Para Cima Mover uma linha para cima. Mover-se-á 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 para a esquerda uma coluna.

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

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

    ENTER ou BARRA DE ESPAÇO Na linha de cabeçalho da coluna, ordene os dados da coluna (alterne A-Z, Z-A).

    Como Utilizar as Funcionalidades da Janela da Vista de Grelha

    Os tópicos seguintes explicam como utilizar as funcionalidades da janela que o Out-GridView apresenta.

    Como Ocultar, Mostrar e Reordenar Colunas

    Para ocultar ou mostrar uma coluna:

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

2. Na caixa de diálogo Selecionar Colunas, utilize 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 da vista de grelha.

Para reordenar colunas:

  • Arraste e largue a coluna na localização pretendida.

  • ou-

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

2. Na caixa de diálogo Selecionar Colunas, utilize 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 da vista de grelha.

Como Ordenar Dados da Tabela

  • Para ordenar os dados, clique num cabeçalho de coluna.

  • Para alterar a sequência de ordenação, clique novamente no cabeçalho da coluna. Sempre que clica no mesmo cabeçalho, a sequência de ordenação alterna entre ordem ascendente e 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 utilize a seta para cima ou para baixo para navegar para a linha.

  • Para selecionar todas as linhas (exceto a linha de cabeçalho), prima CTRL+A.

  • Para selecionar linhas consecutivas, prima sem soltar a tecla SHIFT enquanto clica nas linhas ou utiliza as teclas de seta.

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

Não pode selecionar colunas e não pode selecionar toda a linha de cabeçalho da coluna.

Como Copiar Linhas

  • Para copiar uma ou mais linhas da tabela, selecione as linhas e, em seguida, prima Ctrl+C.

Pode colar os dados em qualquer texto ou programa de folha de cálculo. Não é possível copiar colunas ou partes de linhas e não pode copiar a linha do cabeçalho da coluna.

Como Pesquisa na Tabela (Filtro Rápido)

Utilize a caixa Filtro para procurar dados na tabela. Quando escreve na caixa, apenas os itens que incluem o texto escrito são apresentados na tabela.

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

  • Pesquisa para múltiplas palavras. Para procurar múltiplas palavras na tabela, escreva as palavras separadas por espaços. Out-GridView apresenta linhas que incluem todas as palavras (E lógico).

  • Pesquisa para expressões literais. Para procurar expressões que incluam espaços ou carateres especiais, coloque a expressão entre aspas. Out-GridView apresenta linhas que incluem uma correspondência exata para a expressão.

  • Pesquisa em colunas. Para procurar texto numa ou mais colunas, utilize o seguinte formato:

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

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

displayname:net

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

displayname:net name:net

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

Utilizar Critérios para Filtrar a Tabela

Pode utilizar regras ou critérios para determinar que itens são apresentados na tabela. Os itens só aparecem quando satisfazem todos os critérios que estabelecer. Os critérios disponíveis são determinados pelas propriedades dos objetos apresentados na janela da vista de grelha e pelos tipos .NET Framework dessas propriedades.

Cada critério tem o seguinte formato:

<valor do operador><de coluna><>

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

Os critérios afetam apenas a apresentação. Não elimina itens da tabela.

Como Adicionar Critérios

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

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

3. Clique para selecionar colunas (propriedades). 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 novamente no botão Adicionar Critérios.

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

  • Para introduzir ou alterar um valor, escreva um valor na caixa valor. Se introduzir um valor que não é válido, é apresentado um ícone X circular. Para removê-lo, altere o valor.

  • Para criar uma instrução OR, adicione um critério com a mesma propriedade.

Como Eliminar Critérios

  • Para eliminar critérios selecionados, clique no X vermelho junto a cada critério.

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