Out-GridView
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
Esse cmdlet só está disponível na plataforma Windows.
O Out-GridView
cmdlet 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 no Windows Server Core ou no Windows Nano Server.
Você pode usar os recursos da tabela a seguir para examinar os seus dados:
- Ocultar, mostrar e reordenar colunas
- Classificar linhas
- Filtro rápido
- Adicionar filtro de critérios
- Copiar e colar
Para obter instruções completas, consulte a seção Observações deste artigo.
Observação
Este cmdlet foi reintroduzido no PowerShell 7. Esse cmdlet só está disponível em sistemas Windows que dão suporte à Área de Trabalho do Windows. Para obter uma versão multiplataforma desse cmdlet, consulte o módulo GraphicalTools no Galeria do PowerShell.
Exemplos
Exemplo 1: processos de saída para uma exibição de grade
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 de 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 Get-Process
cmdlet é salva na $P
variável . Em seguida, $P
é canalizado para Out-GridView
.
Exemplo 3: exibir uma propriedade selecionada 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
para selecionar as propriedades Name, WorkingSet e PeakWorkingSet . Outro operador de pipeline envia os objetos filtrados para o Sort-Object
cmdlet 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 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
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 $PSHOME
variável automática. Os parênteses no comando estabelecem a ordem das operações. Como resultado, a saída do Get-ChildItem
comando é salva na $A
variável antes de ser enviada para Out-GridView
.
Exemplo 5: processos de saída de um computador especificado para uma exibição de grade
Este exemplo exibe os processos em execução no computador Server01 em uma janela de exibição de grade.
Get-Process -ComputerName "Server01" | ogv -Title "Processes - Server01"
O examle usa ogv
, que é o alias do Out-GridView
cmdlet . O parâmetro Title especifica o título da janela.
Exemplo 6: gerar dados de computadores remotos para uma exibição de grade
Este exemplo mostra como enviar dados coletados de computadores remotos para Out-GridView
o .
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 Out-GridView
comando . 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'
Este exemplo permite que você selecione vários processos na Out-GridView
janela. Os processos selecionados são passados para o Export-Csv
comando e gravados no ProcessLog.csv
arquivo.
Get-Process | Out-GridView -PassThru | Export-Csv -Path .\ProcessLog.csv
O parâmetro PassThru de Out-GridView
permite que você envie 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'
Este exemplo mostra como usar o parâmetro Wait de Out-GridView
para criar um atalho do Windows para a Out-GridView
janela.
pwsh -Command "Get-Service | Out-GridView -Wait"
Essa linha de comando pode ser usada em um atalho do Windows. Sem o parâmetro Wait , o PowerShell sairia assim que a janela fosse aberta, o Out-GridView
que fecharia a Out-GridView
janela 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
.
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.
None
. Nenhum item. Esse é o valor padrão.Single
. Zero itens ou um item. Use esse valor quando o próximo comando puder levar apenas um objeto de entrada.Multiple
. 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.
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.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Title
Especifica o texto que aparece na barra de título da Out-GridView
janela. Por padrão, a barra de título exibe 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 o prompt de comando e impede que Windows PowerShell feche até que a Out-GridView
janela seja fechada. Por padrão, o prompt de comando retorna quando a Out-GridView
janela é aberta.
Esse recurso permite que você use os Out-GridView
cmdlets em atalhos do Windows. Quando Out-GridView
é usado em um atalho sem o parâmetro Wait , a Out-GridView
janela aparece apenas momentaneamente antes do PowerShell ser fechado.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Você pode enviar qualquer objeto para este cmdlet.
Saídas
None
Normalmente, Out-GridView
não retorna nenhum objeto. Ao usar o parâmetro PassThru , os objetos que representam as linhas selecionadas são retornados ao pipeline.
Observações
Esse cmdlet só está disponível em plataformas Windows.
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 para a Out-GridView
qual você envia não pode ser formatada usando os Format
cmdlets, como Format-Table
cmdlets ou Format-Wide
. Para selecionar propriedades, use o Select-Object
cmdlet .
Resultado desserializado de comandos remotos podem não ser formatados corretamente na janela de exibição em grade.
Atalhos de teclado paraOut-GridView
Use esta tecla: | Para executar esta ação: |
---|---|
Guia | Move o cursor da caixa Filtro para o menu Adicionar critérios para a tabela e para trás. |
Uparrow | Mover uma linha para cima. Move para cabeçalhos de coluna da primeira linha de dados. |
Downarrow | Mover uma linha para baixo. |
Leftarrow | Na linha do cabeçalho da coluna, mova uma coluna para a esquerda. |
Rightarrow | Na linha do cabeçalho da coluna, mova uma coluna para a direita. |
ContextMenuKey | Na linha de cabeçalho da coluna, exibe a opção Selecionar Colunas. |
Enter ou Barra de espaços | Na linha do cabeçalho da coluna, classifique os dados da coluna (alterne A-Z, Z-A). |
Como usar os recursos da janela modo de exibição de grade
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.
- 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 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:
- Clique com o botão direito do mouse em qualquer cabeçalho de coluna e clique em Selecionar Colunas.
- 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, selecione a 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.
- 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. 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 em grade e tipos do .NET Framework dessas propriedades.
Cada critério tem o seguinte formato:
<column> <operator> <value>
Os critérios para propriedades diferentes são conectados por AND. Os 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
- Para exibir o botão de menu Adicionar critérios , no canto superior direito da janela, clique na seta Expandir.
- Clique no botão de menu Adicionar Critérios .
- Clique para selecionar colunas (propriedades). Você pode selecionar uma ou mais propriedades.
- Quando terminar de selecionar propriedades, clique no botão Adicionar .
- Para cancelar as adições, clique em Cancelar.
- 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 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 .