Condividi tramite

Out-GridView

Modulo:
Microsoft.PowerShell.Utility Module

Invia l'output a una tabella interattiva in una finestra separata.

Sintassi

PassThru (impostazione predefinita). 

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

Descrizione

Questo cmdlet è disponibile solo nella piattaforma Windows.

Il Out-GridView cmdlet invia l'output da un comando a una finestra di visualizzazione griglia in cui l'output viene visualizzato in una tabella interattiva.

Poiché questo cmdlet richiede un'interfaccia utente, non funziona in Windows Server Core o Windows Nano Server.

Per esaminare i dati, è possibile usare le funzionalità seguenti della tabella:

  • Nascondere, visualizzare e riordinare le colonne
  • Ordinare le righe
  • Filtro rapido
  • Aggiungere un filtro criteri
  • Copiare e incollare

Per istruzioni complete, vedere la sezione Note di questo articolo.

Annotazioni

Questo cmdlet è stato reintrodotto in PowerShell 7. Questo cmdlet è disponibile solo nei sistemi Windows che supportano Windows Desktop. Per una versione multipiattaforma di questo cmdlet, vedere il modulo ConsoleGuiTools in PowerShell Gallery.

Esempio

Esempio 1: Processi di output in una visualizzazione griglia

Questo esempio ottiene i processi in esecuzione nel computer locale e li invia a una finestra di visualizzazione griglia.

Get-Process | Out-GridView

Esempio 2: Usare una variabile per l'output dei processi in una visualizzazione griglia

Questo esempio ottiene anche i processi in esecuzione nel computer locale e li invia a una finestra di visualizzazione griglia.

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

L'output del Get-Process cmdlet viene salvato nella $P variabile . $P Viene quindi inviato tramite pipe a Out-GridView.

Esempio 3: Visualizzare le proprietà selezionate in una visualizzazione griglia

In questo esempio vengono visualizzate le proprietà selezionate dei processi in esecuzione in una visualizzazione griglia.

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

L'output di Get-Process viene inviato tramite pipe a Select-Object per selezionare le proprietà Name, WorkingSet e PeakWorkingSet . Un altro operatore della pipeline invia gli oggetti filtrati al Sort-Object cmdlet per ordinarli in ordine decrescente in base al valore della proprietà WorkingSet . I risultati ordinati vengono quindi inviati tramite pipe a Out-GridView. È ora possibile usare le funzionalità della visualizzazione griglia per cercare, ordinare e filtrare i dati.

Esempio 4: Salvare l'output in una variabile e quindi restituire una visualizzazione griglia

Questo esempio salva l'output dei cmdlet in una variabile e quindi lo invia a Out-GridView.

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

Get-ChildItem ottiene tutti i file nella directory di installazione di PowerShell e nelle relative sottodirectory usando la $PSHOME variabile automatica. Le parentesi nel comando stabiliscono l'ordine delle operazioni. Di conseguenza, l'output del Get-ChildItem comando viene salvato nella $A variabile prima che venga inviato a Out-GridView.

Esempio 5: Processi di output per un computer specificato in una visualizzazione griglia

In questo esempio vengono visualizzati i processi in esecuzione nel computer Server01 in una finestra di visualizzazione griglia.

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

Nell'esempio viene ogvusato , ovvero l'alias per il Out-GridView cmdlet . Il parametro Title specifica il titolo della finestra.

Esempio 6: Restituire dati da computer remoti a una visualizzazione griglia

In questo esempio viene illustrato come inviare dati raccolti da computer remoti a Out-GridView.

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

Invoke-Command viene eseguito Get-Culture su tre computer remoti. I dati risultanti vengono inviati tramite pipe a Out-GridView. Si noti che il blocco di script eseguito nel computer remoto non include il Out-GridView comando . In caso affermativo, il comando ha esito negativo quando si tenta di aprire una finestra di visualizzazione griglia in ognuno dei computer remoti.

Esempio 7: Passare più elementi tramite 'Out-GridView'

Questo esempio consente di selezionare più processi dalla Out-GridView finestra. I processi selezionati vengono passati al Export-Csv comando e scritti nel ProcessLog.csv file.

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

Il parametro PassThru di Out-GridView consente di inviare più elementi nella pipeline. Il parametro PassThru equivale all'uso del valore multiple del parametro OutputMode .

Esempio 8: Creare un collegamento di Windows a "Out-GridView"

In questo esempio viene illustrato come usare il parametro Wait di Out-GridView per creare un collegamento di Windows alla Out-GridView finestra.

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

Questa riga di comando può essere usata in un collegamento a Windows. Senza il parametro Wait , PowerShell viene chiuso non appena viene aperta la Out-GridView finestra, che chiude la Out-GridView finestra quasi immediatamente.

Parametri

-InputObject

Specifica l'oggetto che il cmdlet accetta come input per Out-GridView.

Quando si utilizza il parametro InputObject per inviare una raccolta di oggetti a Out-GridView, Out-GridView la raccolta viene considerata come un oggetto raccolta e viene visualizzata una riga che rappresenta l'insieme. Per visualizzare ogni oggetto nell'insieme, usare un operatore pipeline (|) per inviare oggetti a Out-GridView.

Proprietà dei parametri

Tipo:PSObject
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-OutputMode

Specifica gli elementi inviati dalla finestra interattiva verso il basso della pipeline come input ad altri comandi. Per impostazione predefinita, questo cmdlet non genera alcun output. Per inviare elementi dalla finestra interattiva verso il basso nella pipeline, fare clic per selezionare gli elementi e quindi fare clic su OK.

I valori di questo parametro determinano il numero di elementi che è possibile inviare nella pipeline.

  • None. Nessun elemento. Questo è il valore predefinito.
  • Single. Zero elementi o un elemento. Usare questo valore quando il comando successivo può accettare un solo oggetto di input.
  • Multiple. Zero, uno o più elementi. Usare questo valore quando il comando successivo può accettare più oggetti di input. Questo valore equivale al parametro PassThru .

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Proprietà dei parametri

Tipo:OutputModeOption
Valore predefinito:None
Valori accettati:None, Single, Multiple
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

OutputMode
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-PassThru

Indica che il cmdlet invia elementi dalla finestra interattiva verso il basso nella pipeline come input per altri comandi. Per impostazione predefinita, questo cmdlet non genera alcun output. Questo parametro equivale all'uso del valore multiple del parametro OutputMode .

Per inviare elementi dalla finestra interattiva verso il basso nella pipeline, fare clic per selezionare gli elementi e quindi fare clic su OK. Sono supportati maiusc+clic e ctrl-clic.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

PassThru
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Title

Specifica il testo visualizzato nella barra del titolo della Out-GridView finestra. Per impostazione predefinita, la barra del titolo visualizza il comando che richiama Out-GridView.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Wait

Indica che il cmdlet elimina il prompt dei comandi e impedisce la chiusura di Windows PowerShell fino alla chiusura della Out-GridView finestra. Per impostazione predefinita, il prompt dei comandi viene restituito all'apertura della Out-GridView finestra.

Questa funzionalità consente di usare i Out-GridView cmdlet nei collegamenti a Windows. Quando Out-GridView viene usato in un collegamento senza il parametro Wait , la Out-GridView finestra viene visualizzata solo momentaneamente prima della chiusura di PowerShell.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Wait
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

PSObject

È possibile passare qualsiasi oggetto come input a questo cmdlet.

Output

None

Per impostazione predefinita, questo cmdlet non restituisce alcun output.

PSObject

Quando si utilizza il parametro PassThru , questo cmdlet restituisce oggetti che rappresentano le righe selezionate.

Note

PowerShell include gli alias seguenti per Out-GridView:

  • Windows:
    • ogv

Questo cmdlet è disponibile solo nelle piattaforme Windows. Questo cmdlet è disponibile solo nelle piattaforme Windows.

Non è possibile usare un comando remoto per aprire una finestra di visualizzazione griglia in un altro computer.

L'output del comando inviato a Out-GridView non può essere formattato usando i Format cmdlet, ad esempio Format-Table o Format-Wide cmdlet. Per selezionare le proprietà, usare il Select-Object cmdlet .

L'output deserializzato dai comandi remoti potrebbe non essere formattato correttamente nella finestra di visualizzazione griglia.

Tasti di scelta rapida perOut-GridView

Usare questa chiave: Per eseguire questa azione:
Tab Sposta il cursore dalla casella Filtro al menu Aggiungi criteri alla tabella e indietro.
UpArrow Spostarsi verso l'alto di una riga. Passa alle intestazioni di colonna dalla prima riga di dati.
DownArrow Spostarsi verso il basso di una riga.
LeftArrow Nella riga dell'intestazione di colonna spostare a sinistra una colonna.
RightArrow Nella riga dell'intestazione di colonna spostare a destra una colonna.
ContextMenuKey Nella riga dell'intestazione di colonna viene visualizzata l'opzione Seleziona colonne.
Immettere o barra spaziatrice Nella riga dell'intestazione di colonna ordinare i dati delle colonne (attivare o disattivare A-Z, Z-A).

Come usare le funzionalità della finestra visualizzazione griglia

Per nascondere o visualizzare una colonna:

  1. Fare clic con il pulsante destro del mouse su qualsiasi intestazione di colonna e scegliere Seleziona colonne.
  2. Nella finestra di dialogo Seleziona colonne usare i tasti di direzione per spostare le colonne tra le colonne selezionate nelle caselle Colonne disponibili. Solo le colonne nella casella Seleziona colonne vengono visualizzate nella finestra della visualizzazione griglia.

Per riordinare le colonne:

È possibile trascinare le colonne nella posizione desiderata. In alternativa, seguire questa procedura:

  1. Fare clic con il pulsante destro del mouse su qualsiasi intestazione di colonna e scegliere Seleziona colonne.
  2. Nella finestra di dialogo Seleziona colonne usare i pulsanti Sposta su e Sposta giù per riordinare le colonne. Le colonne nella parte superiore dell'elenco vengono visualizzate a sinistra delle colonne nella parte inferiore dell'elenco nella finestra della visualizzazione griglia.

Come ordinare i dati della tabella

  • Per ordinare i dati, fare clic su un'intestazione di colonna.
  • Per modificare l'ordinamento, fare di nuovo clic sull'intestazione di colonna. Ogni volta che si fa clic sulla stessa intestazione, l'ordinamento passa dall'ordine crescente a quello decrescente. L'ordine corrente è indicato da un triangolo nell'intestazione di colonna.

Come selezionare i dati della tabella

  • Per selezionare una riga, selezionare la riga o usare la freccia su o giù per passare alla riga.
  • Per selezionare tutte le righe (ad eccezione della riga di intestazione), premere CTRL+A.
  • Per selezionare righe consecutive, tenere premuto MAIUSC mentre si fa clic sulle righe o si usano i tasti di direzione.
  • Per selezionare righe nonconsecutive, premere CTRL e fare clic per aggiungere una riga alla selezione.
  • Non è possibile selezionare le colonne e non è possibile selezionare l'intera riga dell'intestazione di colonna.

Come copiare righe

  • Per copiare una o più righe dalla tabella, selezionare le righe e quindi premere CTRL+C.

    È possibile incollare i dati in qualsiasi programma di testo o foglio di calcolo. Non è possibile copiare colonne o parti di righe e non è possibile copiare la riga dell'intestazione di colonna.

Come eseguire ricerche nella tabella (filtro rapido)

Usare la casella Filtro per cercare i dati nella tabella. Quando si digita nella casella, nella tabella vengono visualizzati solo gli elementi che includono il testo tipizzato.

  • Cercare testo. Per cercare testo nella tabella, nella casella Filtro digitare il testo da trovare.

  • Cercare più parole. Per cercare più parole nella tabella, digitare le parole separate da spazi. Out-GridViewvisualizza le righe che includono tutte le parole (AND logico).

  • Cercare frasi letterali. Per cercare frasi che includono spazi o caratteri speciali, racchiudere la frase tra virgolette. Out-GridView visualizza le righe che includono una corrispondenza esatta per la frase.

  • Cercare nelle colonne. Per cercare testo in una o più colonne, usare il formato seguente:

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

    Ad esempio, per trovare "Net" nella colonna DisplayName , nella casella Filtro digitare:

    displayname:net

    Per trovare le righe con "Net" nelle colonne DisplayName e Name , nella casella Filtro digitare:

    displayname:net name:net

  • Disattivare la ricerca. Per visualizzare di nuovo l'intera tabella, fare clic sul pulsante X rosso nell'angolo superiore destro della casella Filtro oppure eliminare il testo dalla casella Filtro .

Usare Criteri per filtrare la tabella

È possibile utilizzare regole o criteri per determinare quali elementi vengono visualizzati nella tabella. Gli elementi vengono visualizzati solo quando soddisfano tutti i criteri stabiliti. I criteri disponibili sono determinati dalle proprietà degli oggetti visualizzati nella finestra di visualizzazione griglia e dai tipi .NET Framework di tali proprietà.

Ogni criterio ha il formato seguente:

<column> <operator> <value>

I criteri per proprietà diverse sono connessi da AND. I criteri per la stessa proprietà sono connessi da OR. Non è possibile modificare i connettori logici.

I criteri influiscono solo sulla visualizzazione. Non elimina gli elementi dalla tabella.

Come aggiungere criteri

  1. Per visualizzare il pulsante di menu Aggiungi criteri , nell'angolo superiore destro della finestra fare clic sulla freccia Espandi.
  2. Fare clic sul pulsante di menu Aggiungi criteri .
  3. Fare clic per selezionare le colonne (proprietà). È possibile selezionare una o più proprietà.
  4. Al termine della selezione delle proprietà, fare clic sul pulsante Aggiungi .
  5. Per annullare le aggiunte, fare clic su Annulla.
  6. Per aggiungere altri criteri, fare di nuovo clic sul pulsante Aggiungi criteri .

Come modificare un criterio

  • Per modificare un operatore, fare clic sul valore dell'operatore blu e quindi selezionare un operatore diverso dall'elenco a discesa.
  • Per immettere o modificare un valore, digitare un valore nella casella valore. Se si immette un valore non valido, viene visualizzata un'icona X circolare. Per rimuoverlo, modificare il valore.
  • Per creare un'istruzione OR , aggiungere criteri con la stessa proprietà.

Come eliminare criteri

  • Per eliminare i criteri selezionati, fare clic sulla X rossa accanto a ogni criterio.
  • Per eliminare tutti i criteri, fare clic sul pulsante Cancella tutto .