Out-GridView
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
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 Server Core di Windows Server.
Per esaminare i dati, è possibile usare le funzionalità seguenti della tabella:
- Nascondere, mostrare e riordinare le colonne: per nascondere, mostrare 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 a quello decrescente.
- Filtro rapido. Utilizzare la casella Filtro nella parte superiore della finestra per cercare il testo nella tabella. È possibile cercare testo in una determinata colonna, cercare valori letterali e cercare più parole.
- Filtro criteri. Utilizza il menu a discesa Aggiungi criteri per creare regole per filtrare i dati. Ciò è molto utile per set di dati di grandi dimensioni, ad esempio i registri eventi.
- Copiare e incollare. Per copiare righe di dati da Out-GridView, premere CTRL+C (copia). È possibile incollare i dati in qualsiasi programma di testo o foglio di calcolo.
Per istruzioni sull'utilizzo di queste funzionalità, digitare Get-Help Out-GridView -Full e vedere Come utilizzare le funzionalità della finestra di 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 l'output dei processi 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 utilizza il cmdlet Get-Process per ottenere i processi nel computer e quindi salva gli oggetti processo nella variabile $P.
Il secondo comando usa un operatore 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 visualizza 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 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 l'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 di Windows PowerShell e nelle relative sottodirectory. Il percorso della 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. Di conseguenza, l'output del comando Get-ChildItem viene salvato nella variabile $A prima di essere 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 visualizza 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: Restituire dati da computer remoti a una visualizzazione griglia
PS C:\> Invoke-Command -ComputerName S1, S2, S3 -ScriptBlock {Get-Culture} | Out-GridView
In questo esempio viene illustrato il formato corretto per l'invio di 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 remoto non include il comando Out-GridView. 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 attraverso Out-GridView
PS C:\> Get-Process | Out-GridView -PassThru | Export-Csv -Path .\ProcessLog.csv
Questo comando consente di selezionare più processi dalla finestra di Out-GridView
Il comando usa il parametro
Esempio 8: Creare un collegamento di Windows a Out-GridView
PS C:\> Powershell.exe -Command "Get-Service | Out-GridView -Wait"
Questo comando illustra come usare il parametro
Parametri
-InputObject
Specifica che il cmdlet accetta l'input per Out-GridView.
Quando si utilizza il parametro InputObject per inviare una raccolta di oggetti a Out-GridView, Out-GridView considera la raccolta come un unico oggetto raccolta e visualizza una riga che rappresenta la raccolta. 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.
- Nessuno. Nessun elemento. Questo è il valore predefinito.
- Singolo. Zero elementi o un elemento. Usare questo valore quando il comando successivo può accettare un solo oggetto di input.
- Multiplo. 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'utilizzo 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.
Questo parametro è stato introdotto in Windows PowerShell 3.0.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| 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 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 finestra Out-GridView . Per impostazione predefinita, il prompt dei comandi viene restituito quando viene visualizzata la finestra Out-GridView .
Questa funzionalità consente di usare i cmdlet di Out-GridView nei collegamenti a Windows.
Quando
Questo parametro è stato introdotto in Windows PowerShell 3.0.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| 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 inviare qualsiasi oggetto a questo cmdlet.
Output
None
Out-GridView non restituisce oggetti.
Note
In Windows PowerShell 2.0 il cmdlet Out-GridView
è 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à ISE di Windows PowerShell, anche il cmdlet Out-GridView viene disattivato o rimosso. 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, ad esempio usando i cmdlet Format-Table o Format-Wide. Per selezionare le proprietà, usare il cmdlet Select-Object.
L'output deserializzato dai comandi remoti potrebbe non essere formattato correttamente nella finestra di visualizzazione griglia.
Scorciatoie da tastiera per Out-GridView
Usando i tasti di scelta rapida seguenti, è possibile eseguire rapidamente molte attività.
Utilizzare questo tasto: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. Verrà spostato nelle intestazioni di colonna.
FRECCIA GIÙ Sposta verso il basso di 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.
TASTO DEL MENU CONTESTUALE Nella riga dell'intestazione della colonna, viene visualizzata l'opzione Seleziona colonne.
INVIO o BARRA SPAZIATRICE Nella riga dell'intestazione di colonna ordinare i dati delle colonne (attivare o disattivare A-Z, Z-A).
Come utilizzare le funzionalità della finestra di visualizzazione griglia
Negli argomenti seguenti viene illustrato come utilizzare le funzionalità della finestra visualizzata in 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 fare clic su Seleziona colonne.
2. Nella finestra di dialogo Seleziona colonne, utilizzare i tasti freccia per spostare le colonne tra le caselle Colonne selezionate e Colonne disponibili. Nella finestra di visualizzazione griglia vengono visualizzate solo le colonne della casella Colonne selezionate.
Per riordinare le colonne:
Trascinare e rilasciare la colonna nella posizione desiderata.
o-
Fare clic con il pulsante destro del mouse su qualsiasi intestazione di colonna e fare clic su Seleziona colonne.
2. Nella finestra di dialogo Seleziona colonne, utilizzare 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, fare clic sulla 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. In Out-GridView vengono visualizzate 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:
< >colonna :<> di testo [<colonna>:<testo>] ...
Ad esempio, per trovare "Net" nella colonna DisplayName, nella casella Filtro digitare:
Nome visualizzato:NET
Per trovare le righe con "Net" nelle colonne DisplayName e Name, nella casella Filtro digitare:
nome display:net nome:net
- Disattivare la ricerca. Per visualizzare nuovamente l'intera tabella, fare clic sul pulsante X rosso nell'angolo in alto a destra della casella Filtro o 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:
< > valore dell'operatore<>colonna<>
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 del menu Aggiungi criteri, nell'angolo in alto a destra 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 blu dell'operatore, quindi fare clic 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, 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.