Format-List

Formatta l'output come un elenco di proprietà in cui ogni proprietà è visualizzata su una nuova riga.

Sintassi

Format-List [[-Property] <Object[]>] [-DisplayError] [-Expand <string>] [-Force] [-GroupBy <Object>] [-InputObject <psobject>] [-ShowError] [-View <string>] [<CommonParameters>]

Descrizione

Il cmdlet Format-List formatta l'output di un comando come un elenco di proprietà in cui ogni proprietà viene visualizzata su una riga distinta. È possibile utilizzare Format-List per formattare e visualizzare come elenco (format-list *) tutte le proprietà o solo le proprietà selezionate di un oggetto.

Poiché per ogni voce di un elenco è disponibile più spazio rispetto a una tabella, nell'elenco verrà visualizzato un numero maggiore di proprietà e i valori delle proprietà saranno meno soggetti a troncamento.

Parametri

-DisplayError

Visualizza gli errori sulla riga di comando.

-Expand <string>

Formatta l'oggetto insieme, nonché gli oggetti inclusi nell'insieme. Questo parametro è progettato in modo da formattare oggetti che supportano l'interfaccia ICollection (System.Collections). Il valore predefinito è EnumOnly.

I valori validi sono:

-- EnumOnly: visualizza le proprietà degli oggetti presenti nella raccolta.

-- CoreOnly: visualizza le proprietà dell'oggetto raccolta.

-- Both: visualizza le proprietà dell'oggetto raccolta e degli oggetti inclusi nella raccolta.

-Force

Indica al cmdlet di visualizzare tutte le informazioni sull'errore. Utilizzare con il parametro DisplayError o ShowError. Per impostazione predefinita, quando un oggetto errore viene scritto nei flussi di errore o di visualizzazione, solo una parte delle informazioni sull'errore viene visualizzata.

-GroupBy <Object>

Formatta l'output in gruppi basati su un valore o una proprietà condivisa. Immettere un'espressione o una proprietà dell'output.

Il valore del parametro GroupBy può essere una nuova proprietà calcolata. Per creare una proprietà calcolata, utilizzare una tabella hash. Le chiavi valide sono le seguenti:

-- Name (o Label) <stringa>

-- Expression <stringa> o <blocco di script>

-- FormatString <stringa>

-InputObject <psobject>

Specifica gli oggetti da formattare. Immettere una variabile contenente gli oggetti oppure digitare un comando o un'espressione che consente di ottenere gli oggetti.

-Property <Object[]>

Specifica le proprietà dell'oggetto incluse nella visualizzazione e l'ordine in cui vengono visualizzate. È consentito l'utilizzo di caratteri jolly.

Se questo parametro viene omesso, le proprietà incluse nella visualizzazione dipenderanno dall'oggetto da visualizzare. Il nome del parametro ("Property") è facoltativo. Non è possibile utilizzare i parametri Property e View nello stesso comando.

Il valore del parametro Property può essere una nuova proprietà calcolata. Per creare una proprietà calcolata, utilizzare una tabella hash. Le chiavi valide sono le seguenti:

-- Name (o Label) <stringa>

-- Expression <stringa> o <blocco di script>

-- FormatString <stringa>

-ShowError

Invia gli errori attraverso la pipeline.

-View <string>

Specifica il nome di un formato elenco o di una "visualizzazione" alternativa. Non è possibile utilizzare i parametri Property e View nello stesso comando.

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

Note

È inoltre possibile fare riferimento a Format-List tramite il relativo alias predefinito "FL". Per ulteriori informazioni, vedere about_Aliases.

I cmdlet di formato, ad esempio Format-List, consentono di specificare la disposizione dei dati da visualizzare, ma non di visualizzarli. Per la visualizzazione dei dati vengono utilizzate altre funzionalità di output di Windows PowerShell, nonché i cmdlet che contengono il verbo Out (cmdlet Out), ad esempio Out-Host, Out-File e Out-Printer.

Se non si utilizza un cmdlet di formato, verrà applicato il formato predefinito di ciascun oggetto visualizzato in Windows PowerShell.

Per il parametro GroupBy si presuppone che gli oggetti siano ordinati. Prima di utilizzare Format-Custom per raggruppare gli oggetti, ordinarli con Sort-Object.

Il parametro View consente di specificare un formato alternativo per la tabella. È possibile utilizzare le visualizzazioni definite nei file *.format.PS1XML della directory Windows PowerShell oppure creare visualizzazioni personalizzate in nuovi file PS1XML e utilizzare il cmdlet Update-FormatData per includerle in Windows PowerShell.

Per la visualizzazione alternativa del parametro View deve essere utilizzato il formato elenco. In caso contrario, il comando non verrà eseguito. Se la visualizzazione alternativa è una tabella, utilizzare Format-Table. Se la visualizzazione alternativa non è né un elenco né una tabella, utilizzare Format-Custom.

Esempio 1

C:\PS>get-service | format-list

Descrizione
-----------
Tramite questo comando le informazioni relative ai servizi disponibili nel computer locale verranno formattate come elenco. Per impostazione predefinita, i servizi vengono formattati come tabella. Il cmdlet Get-Service ottiene gli oggetti che rappresentano i servizi disponibili nel computer. L'operatore pipeline (|) passa i risultati a Format-List attraverso la pipeline. Tramite il comando Format-List, infine, le informazioni relative ai servizi vengono formattate come elenco e inviate al cmdlet output predefinito per la visualizzazione.

Esempio 2

C:\PS>$a = get-childitem $pshome\*.ps1xml

Descrizione
-----------
Tramite questi comandi le informazioni sui file PS1XML della directory Windows PowerShell vengono visualizzate come elenco. Tramite il primo comando vengono ottenuti gli oggetti che rappresentano i file che verranno quindi archiviati nella variabile $a. Nel secondo comando viene utilizzato Format-List per formattare le informazioni relative agli oggetti archiviati in $a. Viene utilizzato il parametro InputObject per passare la variabile a Format-List, che invia l'output formattato al cmdlet output predefinito per la visualizzazione.

Esempio 3

C:\PS>get-process | format-list -property name, basepriority, priorityclass

Descrizione
-----------
Tramite questo comando verranno visualizzati il nome, la priorità di base e la classe di priorità di ogni processo disponibile nel computer. Verrà utilizzato il cmdlet Get-Process per ottenere un oggetto che rappresenta il singolo processo. L'operatore pipeline (|) passa gli oggetti processo attraverso la pipeline a Format-List, attraverso cui i processi vengono formattati come un elenco delle proprietà specificate. Il nome del parametro "Property" è facoltativo, pertanto può essere omesso.

Esempio 4

C:\PS>get-process winlogon | format-list -property *

Descrizione
-----------
Tramite questo comando verranno visualizzate tutte le proprietà del processo Winlogon. Viene utilizzato il cmdlet Get-Process per ottenere un oggetto che rappresenta il processo Winlogon. L'operatore pipeline (|) passa l'oggetto processo Winlogon a Format-List attraverso la pipeline. Verranno utilizzati il parametro Property per specificare le proprietà e * per indicare tutte le proprietà. Poiché il nome del parametro Property è facoltativo, è possibile ometterlo e digitare il comando come: "format-list * ". Format-List automaticamente invia i risultati al cmdlet di output predefinito per la visualizzazione.