Invia l'output a una tabella interattiva in una finestra separata.
Sintassi
Out-GridView [-InputObject <psobject>] [-Title <string>] [<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. Questa funzionalità richiede Microsoft .NET Framework 3.5 con Service Pack 1.
Per esaminare i dati, è possibile utilizzare le seguenti funzionalità della tabella:
-- Nascondere, visualizzare e riordinare colonne: per nascondere, visualizzare o riordinare una colonna, fare clic con il pulsante destro del mouse su un'intestazione di colonna, quindi scegliere "Seleziona colonne".
-- Ordinare. Per ordinare i dati, fare clic su un'intestazione di colonna. Fare nuovamente clic per passare dall'ordine crescente a quello decrescente.
-- Filtro rapido. Utilizzare la casella "Filtro" nella parte superiore della finestra per cercare il testo nella tabella. È possibile cercare il testo in una particolare colonna, cercare valori letterali e più parole.
-- Filtro dei criteri. Utilizzare il menu a discesa "Aggiungi criteri" per creare regole per filtrare i dati. È molto utile per i set di dati di grandi dimensioni, 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 programma di foglio di calcolo o testo.
Per istruzioni sull'utilizzo di queste funzionalità, digitare "Get-Help out-gridview -full" e vedere "Modalità di utilizzo delle funzionalità della finestra di visualizzazione griglia" nella sezione NOTE.
Parametri
-InputObject <psobject>
Accetta input per Out-GridView.
Quando si utilizza il parametro InputObject per inviare una raccolta (più di uno) di oggetti a Out-GridView, Out-GridView considera la raccolta come un oggetto raccolta e visualizza una riga che lo rappresenta. Per visualizzare ciascun oggetto nella raccolta, utilizzare un operatore pipeline (|) per inviare oggetti a Out-GridView.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByValue) |
|
Accettare caratteri jolly? |
false |
-Title <string>
Specifica il testo visualizzato nella barra del titolo della finestra Out-GridView.
Per impostazione predefinita, nella barra del titolo viene visualizzato il comando che richiama Out-GridView.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
The current command |
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
<CommonParameters>
Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.
Input e output
Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.
|
Input |
System.Management.Automation.PSObject È possibile inviare qualsiasi oggetto a Out-GridView. |
|
Output |
Nessuno Out-GridView non restituisce alcun oggetto. |
Note
NOTE PER OUT-GRIDVIEW
----------------------
È possibile scaricare Microsoft .NET Framework 3.5 con Service Pack 1 dall'Area download Microsoft.
Poiché questo cmdlet richiede un'interfaccia utente, non funziona nelle installazioni Server Core di Windows Server.
Non è possibile utilizzare un comando remoto per aprire una finestra di visualizzazione griglia in un computer remoto.
Impossibile preformattare l'output dei comandi inviato, ad esempio utilizzando i cmdlet Format-Table o Format-Wide. Per selezionare le proprietà, utilizzare il cmdlet Select-Object.
È possibile che l'output deserializzato dei comandi remoti non sia formattato correttamente nella finestra di visualizzazione griglia.
TASTI DI SCELTA RAPIDA PER OUT-GRIDVIEW
-----------------------------------
Tramite i tasti di scelta rapida seguenti, è possibile eseguire rapidamente molte attività.
Utilizzare questa chiave: Per eseguire questa azione:
------------- ----------------------------------------------------------------
TAB Sposta il cursore dalla casella Filtro al menu Aggiungi criteri nella tabella e viceversa.
FRECCIA SU Spostarsi nella riga superiore. Sposta il cursore nelle intestazioni di colonna.
FRECCIA GIÙ Spostarsi nella riga inferiore.
FRECCIA SINISTRA Nella riga dell'intestazione di colonna, spostarsi nella colonna a sinistra.
FRECCIA DESTRA Nella riga dell'intestazione di colonna, spostarsi nella colonna a destra.
TASTO MENU DI SCELTA RAPIDA: nella riga dell'intestazione di colonna, visualizza l'opzione "Seleziona colonne".
INVIO o BARRA SPAZIATRICE Nella riga dell'intestazione di colonna, ordinare i dati della colonna (attivare A-Z, Z-A).
MODALITÀ DI UTILIZZO DELLE FUNZIONALITÀ DELLA FINESTRA DI VISUALIZZAZIONE GRIGLIA
----------------------------------------
Negli argomenti seguenti viene illustrato come utilizzare le funzionalità della finestra visualizzata da Out-GridView.
Come nascondere, mostrare e riordinare colonne
--------------------------------------
Per nascondere o mostrare 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", utilizzare i tasti di direzione per spostare le colonne tra le caselle "Colonne selezionate" e "Colonne disponibili". Solo le colonne presenti nella casella "Colonne selezionate" vengono visualizzate nella finestra di visualizzazione griglia.
Per riordinare le colonne:
--Trascinare la colonna nella posizione desiderata.
oppure
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", utilizzare i pulsanti "Sposta in alto" e "Sposta in basso" per riordinare le colonne. Nella finestra di visualizzazione griglia le colonne nella parte superiore dell'elenco sono visualizzate a sinistra delle colonne nella parte inferiore dell'elenco.
Modalità di ordinamento dei dati della tabella
----------------------
-- Per ordinare i dati, fare clic su un'intestazione di colonna.
-- Per modificare l'ordinamento, fare nuovamente clic sull'intestazione di colonna. Ogni volta che si fa clic sulla stessa intestazione, l'ordinamento cambia da crescente a decrescente. L'ordine corrente è indicato da un triangolo nell'intestazione di colonna.
Modalità di selezione dei dati della tabella
------------------------
-- Per selezionare una riga, fare clic sulla riga o utilizzare la freccia su o la freccia giù per passare alla riga.
-- Per selezionare tutte le righe (eccetto la riga dell'intestazione), premere CTRL+A.
-- Per selezionare righe consecutive, premere e tenere premuto il tasto MAIUSC mentre si fa clic sulle righe o mentre si utilizzano i tasti di direzione.
-- Per selezionare righe non consecutive, premere il tasto CTRL e fare clic per aggiungere una riga alla selezione.
Non è possibile selezionare colonne e l'intera riga dell'intestazione di colonna.
Modalità di copia di righe
----------------------
-- Per copiare una o più righe dalla tabella, selezionare le righe, quindi premere CTRL+C.
È possibile incollare i dati in qualsiasi programma di foglio di calcolo o testo. Non è possibile copiare colonne o parti di righe e la riga dell'intestazione di colonna.
Modalità di ricerca nella tabella (Filtro rapido)
---------------------------------
Utilizzare la casella "Filtro" per cercare dati nella tabella. Quando si digita nella casella, solo gli elementi che includono il testo digitato vengono visualizzati nella tabella.
-- Cerca testo. Per cercare testo nella tabella, digitare il testo da trovare nella casella "Filtro".
-- Cerca più parole. Per cercare più parole nella tabella, digitare le parole separate da spazi. Out-GridView visualizzerà le righe che includono tutte le parole (AND logico).
-- Cerca frasi letterali. Per cercare frasi che includono spazi o caratteri speciali, racchiudere la frase tra virgolette. Out-GridView visualizzerà le righe che includono una corrispondenza esatta per la frase.
-- Cerca in colonne. Per cercare testo in una o più colonne, utilizzare il formato seguente:
<colonna>:<testo> [<colonna>:<testo>] ...
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
-- Disattiva ricerca. Per visualizzare nuovamente l'intera tabella, fare clic sul pulsante con la X rossa nell'angolo superiore destro della casella "Filtro" o eliminare il testo dalla casella.
Utilizzo di 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à.
Ciascun criterio ha il formato seguente:
<colonna> <operatore> <valore>
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 hanno effetto solo sulla visualizzazione. Non elimina elementi dalla tabella.
Modalità di aggiunta di criteri
---------------------------
1. Per visualizzare il pulsante di menu "Aggiungi criteri", fare clic sul pulsante "Espandi" nell'angolo superiore destro della finestra.
2. Fare clic sul pulsante "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 più criteri, fare nuovamente clic sul pulsante Aggiungi criteri.
Modalità di modifica di un criterio
--------------------
-- Per modificare un operatore, fare clic sul valore dell'operatore blu, quindi fare clic per selezionare un operatore
diverso dall'elenco a discesa.
-- Per immettere o modificare un valore, digitare il valore nella relativa casella. Se si immette un valore non valido, viene visualizzata un'icona circolare con una X. Per rimuoverla, modificare il valore.
-- Per creare un'istruzione OR, aggiungere un criterio con la stessa proprietà.
Modalità di eliminazione di criteri
-------------------------
-- Per eliminare criteri selezionati, fare clic sulla X rossa accanto a ciascun criterio.
-- Per eliminare tutti i criteri, fare clic sul pulsante "Cancella tutto".
Esempio 1
C:\PS>get-process | out-gridview Descrizione ----------- Questo comando ottiene i processi in esecuzione nel computer locale e li invia a una finestra di visualizzazione griglia.
Esempio 2
C:\PS>$p = get-process C:\PS> $p | out-gridview Descrizione ----------- Questo comando ottiene inoltre i processi in esecuzione nel computer locale e li invia a una finestra di visualizzazione griglia. Il primo comando utilizza il comando Get-Process per ottenere i processi nel computer, quindi salva gli oggetti processo nella variabile $p. Nel secondo comando viene utilizzato un operatore pipeline per inviare la variabile $p a Out-GridView.
Esempio 3
C:\PS>get-process | select-object -property name, workingset, peakworkingset | sort-object -property workingset -desc | out-gridview Descrizione ----------- Questo comando visualizza una tabella formattata in una finestra di visualizzazione griglia. Utilizza il cmdlet Get-Process per ottenere i processi disponibili nel computer. Utilizza quindi un operatore pipeline (|) per inviare gli oggetti processo al cmdlet Select-Object. Il comando utilizza il parametro Property di Select-Object per selezionare le proprietà Name, WorkingSet e PeakWorkingSet da visualizzare nella tabella. Un altro operatore pipeline invia gli oggetti filtrati al cmdlet Sort-Object che li ordina in modo decrescente in base al valore della proprietà WorkingSet. La parte finale del comando utilizza un operatore pipeline (|) per inviare la tabella formattata a Out-GridView. È ora possibile utilizzare le funzionalità della visualizzazione griglia per cercare, ordinare e filtrare i dati.
Esempio 4
C:\PS>($a = get-childitem -path $pshome -recurse) | out-gridview Descrizione ----------- Questo comando salva l'output in una variabile e lo invia a Out-GridView. Il comando utilizza il cmdlet Get-ChildItem per ottenere i file nella directory di installazione e nelle relative sottodirectory di Windows PowerShell. Il percorso alla directory di installazione viene salvato nella variabile automatica $pshome. Il comando utilizza l'operatore di assegnazione (=) per salvare l'output nella variabile $a e l'operatore pipeline (|) per inviare l'output a Out-GridView. Le parentesi nel comando stabiliscono l'ordine delle operazioni. L'output dal comando Get-ChildItem viene salvato nella variabile $a prima dell'invio a Out-GridView.
Esempio 5
C:\PS>get-process -computername Server01| ogv -title "Processes - Server01" Descrizione ----------- Con questo comando vengono visualizzati i processi in esecuzione nel computer Server01 in una finestra di visualizzazione griglia. Nel comando viene utilizzato "ogv" che è l'alias predefinito per il cmdlet Out-GridView; viene inoltre utilizzato il parametro Title per specificare il titolo della finestra.
Esempio 6
C:\PS>invoke-command -ComputerName S1, S2, S3 -scriptblock {get-culture} | out-gridview
Descrizione
-----------
In questo esempio viene illustrato il formato corretto per l'invio dei dati raccolti dai computer remoti al cmdlet Out-GridView.
Nel comando viene utilizzato il cmdlet Invoke-Command per eseguire un comando Get-Culture in tre computer remoti. Per inviare i dati restituiti al cmdlet Out-GridView, viene utilizzato un operatore pipeline.
Si noti che il blocco di script che contiene i comandi eseguiti in modalità remota non include il comando Out-GridView. Se così fosse, il comando non sarebbe in grado di aprire una finestra di visualizzazione griglia in ogni computer remoto.