Condividi tramite

Out-GridView

  • Riferimento
Modulo:
Microsoft.PowerShell.Utility

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

Sintassi

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

Descrizione

Il cmdlet Out-GridView 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 nelle installazioni dei componenti di base dI Windows Server.

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

  • Nascondi, Mostra e Riordina colonne: per nascondere, visualizzare o riordinare una colonna, fare clic con il pulsante destro del mouse su un'intestazione di colonna e quindi scegliere Seleziona colonne.
  • Sorta. per ordinare i dati, fare clic su un'intestazione di colonna. Fare di nuovo clic per passare dall'ordine crescente all'ordine decrescente.
  • Filtro rapido. Utilizzare la casella Filtro nella parte superiore della finestra per cercare il testo nella tabella. È possibile cercare testo in una colonna specifica, cercare valori letterali e cercare più parole.
  • Filtro criteri. Usare il menu a discesa Aggiungi criteri per creare regole per filtrare i dati. Questa opzione è utile per filtrare set di dati molto grandi, ad esempio i registri eventi.
  • Copia e Incolla. Per copiare righe di dati da Out-GridView, premere CTRL+C (copia). È possibile incollare i dati in qualsiasi foglio di calcolo o file di testo.

Per istruzioni sull'uso di queste funzionalità, digitare Get-Help Out-GridView -Full e vedere Come usare le funzionalità della finestra visualizzazione griglia nella sezione Note.

Esempio

Esempio 1: Processi di output in una visualizzazione griglia

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

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

Esempio 2: Usare una variabile per generare processi di output in una visualizzazione griglia

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

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

Il primo comando usa il cmdlet Get-Process per ottenere i processi nel computer e quindi salva gli oggetti di processo nella variabile $P.

Il secondo comando usa un operatore della pipeline per inviare la variabile $P a Out-GridView.

Esempio 3: Visualizzare una tabella formattata in una visualizzazione griglia

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

Questo comando consente di visualizzare una tabella formattata in una finestra di visualizzazione griglia.

Usa il cmdlet Get-Process per ottenere i processi nel computer.

Usa quindi un operatore pipeline (|) per inviare gli oggetti di processo al cmdlet Select-Object. Il comando usa il parametro Property di Select-Object per selezionare le proprietà Name, WorkingSet e PeakWorkingSet da visualizzare nella tabella.

Un altro operatore della pipeline invia gli oggetti filtrati al cmdlet Sort-Object, che li ordina in ordine decrescente in base al valore della proprietà WorkingSet .

La parte finale del comando usa un operatore pipeline (|) per inviare la tabella formattata 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

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

Questo comando salva il proprio output in una variabile e lo invia a Out-GridView.

Il comando usa il cmdlet Get-ChildItem per ottenere i file nella directory di installazione Windows PowerShell e le relative sottodirectory. Il percorso della directory di installazione viene salvato nella variabile automatica $pshome.

Il comando usa l'operatore di assegnazione (=) per salvare l'output nella variabile $A e l'operatore della pipeline (|) per inviare l'output a Out-GridView.

Le parentesi nel comando stabiliscono l'ordine delle operazioni. Di conseguenza, l'output del comando Get-ChildItem viene salvato nella variabile $A prima che venga inviato a Out-GridView.

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

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

Questo comando consente di visualizzare i processi in esecuzione nel computer Server01 in una finestra di visualizzazione griglia.

Il comando usa ogv, che è l'alias predefinito per il cmdlet Out-GridView , usa il parametro Title per specificare il titolo della finestra.

Esempio 6: Output dei dati dai computer remoti a una visualizzazione griglia

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

Questo esempio illustra il formato corretto per l'invio dei dati raccolti da computer remoti al cmdlet Out-GridView.

Il comando usa il cmdlet Invoke-Command per eseguire un comando Get-Culture in tre computer remoti. Usa un operatore pipeline per inviare i dati restituiti al cmdlet Out-GridView.

Si noti che il blocco di script che contiene i comandi eseguiti in modalità remota non include il comando Out-GridView. In caso contrario, il tentativo di aprire una finestra di visualizzazione griglia in ognuno dei computer remoti avrebbe esito negativo.

Esempio 7: Passare più elementi tramite Out-GridView

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

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

Il comando usa il parametro PassThru di Out-GridView, che consente di inviare più elementi alla pipeline. Il parametro PassThru equivale all'utilizzo del valore Multiple del parametro OutputMode.

Esempio 8: Create un collegamento a Windows per Out-GridView

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

Questo comando mostra come usare il parametro Wait di Out-GridView per creare un collegamento di Windows alla finestra Out-GridView. Senza il parametro Wait, Windows PowerShell verrebbe chiuso all'apertura della finestra Out-GridView causando così l'immediata chiusura della finestra Out-GridView.

Parametri

-InputObject

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

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

Type:PSObject
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-OutputMode

Specifica gli elementi che la finestra interattiva invia la pipeline come input ad altri comandi. Per impostazione predefinita, il cmdlet non genera alcun output. Per inviare gli elementi dalla finestra interattiva alla 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 alla pipeline.

  • Nessuno. Nessun elemento. Si tratta del valore predefinito.
  • Singolo: Zero elementi o un elemento. Usare questo valore quando il comando successivo può accettare un solo oggetto di input.
  • Più. Zero, uno o più elementi. Usare questo valore quando il comando successivo può accettare più oggetti di input. Questo valore è equivalente al parametro Passthru.

Questo parametro è stato introdotto in 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 che il cmdlet invia elementi dalla finestra interattiva verso il basso della pipeline come input ad altri comandi. Per impostazione predefinita, il cmdlet non genera alcun output. Questo parametro equivale all'utilizzo del valore Multiple del parametro OutputMode.

Per inviare gli elementi dalla finestra interattiva alla pipeline, fare clic per selezionare gli elementi e quindi fare clic su OK. Le scelte rapide da tastiera MAIUSC+clic e CTRL+clic sono supportate.

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Title

Specifica il testo visualizzato nella barra del titolo della finestra Out-GridView.

Per impostazione predefinita, la barra del titolo visualizza il comando che richiama Out-GridView.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Wait

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

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

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

PSObject

È possibile inviare qualsiasi oggetto a questo cmdlet.

Output

None

Out-GridView non restituisce oggetti.

Note

  • In Windows PowerShell 2.0, il cmdlet Out-GridView viene installato per impostazione predefinita nelle versioni client di Windows, ma è una funzionalità facoltativa nelle versioni server di Windows. In Windows PowerShell 3.0, viene installato in tutti i sistemi per impostazione predefinita. Tuttavia, se si disattiva o si rimuove la funzionalità Windows PowerShell ISE, il cmdlet Out-GridView viene disattivato o rimosso.

  • Per aprire una finestra di visualizzazione griglia in un altro computer, non è possibile usare un comando remoto.

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

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

  • Tasti di scelta rapida per Out-GridView

    Le scelte rapide da tastiera seguenti consentono di eseguire rapidamente molte attività.

    Usare questa chiave:Per eseguire questa azione:

    TAB Sposta il cursore dalla casella Filtro al menu Aggiungi criteri alla tabella e indietro.

    FRECCIA SU Sposta su una riga. fino ad arrivare alle intestazioni di colonna.

    FRECCIA GIÙ Sposta verso il basso una riga.

    FRECCIA SINISTRA Nella riga dell'intestazione di colonna spostare a sinistra una colonna.

    FRECCIA DESTRA Nella riga dell'intestazione di colonna spostare a destra una colonna.

    MENU DI SCELTA RAPIDA NELLA riga di intestazione di colonna visualizza l'opzione Seleziona colonne.

    INVIO o BARRA SPAZIATRICE Nella riga di intestazioni di colonna, consente di ordinare i dati della colonna (da A-Z e da Z-A).

    Come usare le funzionalità della finestra visualizzazione griglia

    Gli argomenti seguenti illustrano come usare le funzionalità della finestra visualizzata da Out-GridView .

    Come nascondere, visualizzare e riordinare le colonne

    Per nascondere o visualizzare una colonna:

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. Nella finestra visualizzazione griglia vengono visualizzate solo colonne nella casella Colonne selezionate.

Per riordinare le colonne:

  • Trascinare e rilasciare la colonna nella posizione desiderata.

  • oppure

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 verso l'alto e Sposta verso il basso per riordinare le colonne. Le colonne nella parte superiore dell'elenco vengono visualizzate a sinistra delle colonne nella parte inferiore dell'elenco nella finestra di visualizzazione griglia.

Come ordinare i dati della tabella

  • per ordinare i dati, fare clic su un'intestazione di colonna.

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

Come selezionare i dati della tabella

  • Per selezionare una riga, fare clic sulla riga o usare la freccia su o verso il basso per passare alla riga.

  • Per selezionare tutte le righe (ad eccezione della riga di intestazione), premere CTRL+A.

  • Per selezionare righe consecutive, premere e tenere premuto il tasto MAIUSC facendo clic sulle righe o usando i tasti di direzione.

  • Per selezionare righe nonconsecutive, premere CTRL e fare clic su per aggiungere una riga alla selezione.

Non è possibile selezionare colonne e non è possibile selezionare l'intera riga di intestazioni di colonna.

Come copiare le righe

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

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

Come Search nella tabella (filtro rapido)

Utilizzare 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 digitato.

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

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

  • Search per 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.

  • Search nelle colonne. Per cercare un 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 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 o eliminare il testo dalla casella Filtro.

Usare i criteri per filtrare la tabella

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

Ogni criterio presenta il formato seguente:

<valore dell'operatore><di colonna><>

I criteri per proprietà diversi sono connessi tramite l'operatore AND. I criteri per la stessa proprietà sono connessi tramite l'operatore OR. Non è possibile modificare i connettori logici.

I criteri hanno effetto solo sulla visualizzazione e non eliminano 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 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 fare clic su per 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, verrà visualizzata un'icona con una X circolare. Per rimuoverla, 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.