Condividi tramite

Format-List

  • Riferimento
Modulo:
Microsoft.PowerShell.Utility

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

Sintassi

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

Descrizione

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

Poiché è disponibile più spazio per ogni elemento di un elenco rispetto a una tabella, PowerShell visualizza più proprietà dell'oggetto nell'elenco e i valori delle proprietà sono meno probabili troncati.

Esempio

Esempio 1: Formattare i servizi computer

Get-Service | Format-List

Questo comando formatta le informazioni sui servizi nel computer come elenco. Per impostazione predefinita, i servizi sono formattati come tabella. Il Get-Service cmdlet ottiene oggetti che rappresentano i servizi nel computer. L'operatore pipeline (|) passa i risultati attraverso la pipeline a Format-List. Format-List Il comando formatta quindi le informazioni del servizio in un elenco e le invia al cmdlet di output predefinito per la visualizzazione.

Esempio 2: Formattare i file PS1XML

Questi comandi visualizzano informazioni sui file PS1XML nella directory di PowerShell come elenco.

$A = Get-ChildItem $pshome\*.ps1xml
Format-List -InputObject $A

Il primo comando ottiene gli oggetti che rappresentano i file e li archivia nella $A variabile .

Il secondo comando usa Format-List per formattare le informazioni sugli oggetti archiviati in $A. Questo comando usa il parametro InputObject per passare la variabile a Format-List, che quindi invia l'output formattato al cmdlet di output predefinito per la visualizzazione.

Esempio 3: Formattare le proprietà del processo in base al nome

Questo comando visualizza il nome, la priorità di base e la classe di priorità di ogni processo nel computer.

Get-Process | Format-List -Property Name, BasePriority, PriorityClass

Usa il Get-Process cmdlet per ottenere un oggetto che rappresenta ogni processo. L'operatore pipeline (|) passa gli oggetti processo tramite la pipeline a Format-List. Format-List formatta i processi come elenco delle proprietà specificate. Il nome del parametro Property è facoltativo, quindi è possibile ometterlo.

Esempio 4: Formattare tutte le proprietà per un processo

Questo comando visualizza tutte le proprietà del processo Winlogon.

Get-Process winlogon | Format-List -Property *

Usa il cmdlet Get-Process per ottenere un oggetto che rappresenta il processo Winlogon. L'operatore pipeline (|) passa l'oggetto processo Winlogon tramite la pipeline a Format-List. Il comando usa 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 invia automaticamente i risultati al cmdlet di output predefinito per la visualizzazione.

Esempio 5: Risoluzione degli errori di formato

Negli esempi seguenti vengono illustrati i risultati dell'aggiunta dei parametri DisplayError o ShowError con un'espressione.

PC /> Get-Date | Format-List DayOfWeek,{ $_ / $null } -DisplayError

DayOfWeek    : Friday
 $_ / $null  : #ERR

PC /> Get-Date | Format-List DayOfWeek,{ $_ / $null } -ShowError

DayOfWeek    : Friday
 $_ / $null  :

Failed to evaluate expression " $_ / $null ".
+ CategoryInfo          : InvalidArgument: (12/21/2018 7:59:23 AM:PSObject) [], RuntimeException
+ FullyQualifiedErrorId : PSPropertyExpressionError

Parametri

-DisplayError

Indica che questo cmdlet visualizza gli errori nella riga di comando. Questo parametro viene usato raramente, ma può essere usato come supporto per il debug quando si formattano espressioni in un Format-List comando e le espressioni non sembrano funzionare.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Expand

Specifica l'oggetto insieme formattato, nonché gli oggetti nell'insieme. Questo parametro è progettato per formattare gli oggetti che supportano l'interfaccia System.Collections.ICollection . Il valore predefinito è EnumOnly. I valori validi per questo parametro sono:

  • EnumOnly. Visualizza le proprietà degli oggetti nella raccolta.
  • CoreOnly. Visualizza le proprietà dell'oggetto raccolta.
  • Both. Visualizza le proprietà dell'oggetto raccolta e le proprietà degli oggetti nella raccolta.
Tipo:String
Valori accettati:CoreOnly, EnumOnly, Both
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Force

Indica che questo cmdlet visualizza tutte le informazioni sull'errore. Usare con il parametro DisplayError o ShowError . Per impostazione predefinita, quando un oggetto errore viene scritto nei flussi di errore o di visualizzazione, vengono visualizzate solo alcune informazioni sull'errore.

Obbligatorio anche per la formattazione di determinati tipi .NET. Per altre informazioni, vedere la sezione Note .

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-GroupBy

Specifica l'output in gruppi in base a una proprietà o un valore condiviso. Immettere un'espressione o una proprietà dell'output.

Il valore del parametro GroupBy può essere una nuova proprietà calcolata. La proprietà calcolata può essere un blocco di script o una tabella hash. Le coppie chiave-valore valide sono:

  • Name (o Label) - <string>
  • Expression - <string> oppure <script block>
  • FormatString - <string>

Per altre informazioni, vedere about_Calculated_Properties.

Tipo:Object
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Specifica gli oggetti da formattare. Immettere una variabile che contiene gli oggetti oppure digitare un comando o un'espressione che ottiene gli oggetti.

Tipo:PSObject
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Property

Specifica le proprietà dell'oggetto che vengono presentate nella visualizzazione e l'ordine in cui appaiono. I caratteri jolly sono consentiti.

Se si omette questo parametro, le proprietà presentate nella visualizzazione dipendono dall'oggetto visualizzato. 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. La proprietà calcolata può essere un blocco di script o una tabella hash. Le coppie chiave-valore valide sono:

  • Name (o Label) - <string>
  • Expression - <string> oppure <script block>
  • FormatString - <string>

Per altre informazioni, vedere about_Calculated_Properties.

Tipo:Object[]
Posizione:0
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

-ShowError

Indica che il cmdlet invia errori tramite la pipeline. Questo parametro viene usato raramente, ma può essere usato come supporto per il debug quando si formattano espressioni in un Format-List comando e le espressioni non sembrano funzionare.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-View

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

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

PSObject

È possibile inviare tramite pipe qualsiasi oggetto a questo cmdlet.

Output

Microsoft.PowerShell.Commands.Internal.Format

Questo cmdlet restituisce gli oggetti di formato che rappresentano l'elenco.

Note

PowerShell include gli alias seguenti per Format-List:

  • Tutte le piattaforme:
    • fl

I cmdlet di formato, ad esempio Format-List, dispongono i dati da visualizzare ma non visualizzati. I dati vengono visualizzati dalle funzionalità di output di PowerShell e dai cmdlet che contengono il Out verbo (i Out cmdlet), ad esempio Out-Host o Out-File.

Se non si usa un cmdlet di formato, PowerShell applica il formato predefinito per ogni oggetto visualizzato.

Il parametro GroupBy presuppone che gli oggetti siano ordinati. Utilizzare prima di Sort-Object usare Format-List per raggruppare gli oggetti.

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

La visualizzazione alternativa per il parametro View deve usare il formato elenco. In caso contrario, il comando non riesce. Se la vista alternativa è una tabella, usare Format-Table. Se la visualizzazione alternativa non è un elenco o una tabella, utilizzare Format-Custom.

Se si vuole usare Format-List con il parametro Property , è necessario includere il parametro Force in una delle condizioni seguenti: