Formatta gli oggetti come tabella ampia in cui è visualizzata una sola proprietà di ciascun oggetto.
Sintassi
Format-Wide [[-Property] <Object>] [-AutoSize] [-Column <int>] [-DisplayError] [-Expand <string>] [-Force] [-GroupBy <Object>] [-InputObject <psobject>] [-ShowError] [-View <string>] [<CommonParameters>]
Descrizione
Il cmdlet Format-Wide consente di formattare gli oggetti come tabella ampia in cui viene visualizzata una sola proprietà di ciascun oggetto. È possibile utilizzare il parametro Property per determinare la proprietà che verrà visualizzata.
Parametri
-AutoSize
Adatta le dimensioni e il numero delle colonne in base alla larghezza dei dati. Per impostazione predefinita, le dimensioni e il numero delle colonne sono determinate dalla visualizzazione. Non è possibile utilizzare i parametri AutoSize e Column nello stesso comando.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Column <int>
Specifica il numero di colonne della visualizzazione. Non è possibile utilizzare i parametri AutoSize e Column nello stesso comando.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-DisplayError
Visualizza gli errori sulla riga di comando.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-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.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Force
Ignora le restrizioni che impediscono la corretta esecuzione del comando, purché le modifiche non abbiano effetti negativi sulla sicurezza. Force, ad esempio, ignora l'attributo di sola lettura o crea directory per completare un percorso di file, ma non tenta di modificare le autorizzazioni per il file.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-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>
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-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.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByValue) |
|
Accettare caratteri jolly? |
false |
-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:
-- Expression <stringa> o <blocco di script>
-- FormatString <stringa>
|
Obbligatorio? |
false |
|
Posizione? |
1 |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-ShowError
Invia gli errori attraverso la pipeline.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-View <string>
Specifica il nome di un formato tabella o di una "visualizzazione" alternativa. Non è possibile utilizzare i parametri Property e View nello stesso comando.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
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 reindirizzare qualsiasi oggetto a Format-Wide. |
|
Output |
Microsoft.PowerShell.Commands.Internal.Format Format-Wide restituisce gli oggetti formato che rappresentano la tabella. |
Note
È inoltre possibile fare riferimento a Format-Wide tramite il relativo alias predefinito "fw". Per ulteriori informazioni, vedere about_Aliases.
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 tabella. In caso contrario, il comando non verrà eseguito. Se la visualizzazione alternativa è un elenco, utilizzare Format-List. Se la visualizzazione alternativa non è né un elenco né una tabella, utilizzare Format-Custom.
Esempio 1
C:\PS>get-childitem | format-wide -column 3 Descrizione ----------- Tramite questo comando i nomi dei file presenti nella directory corrente verranno visualizzati in tre colonne che occupano tutta la schermata. Verrà utilizzato il cmdlet Get-ChildItem per ottenere gli oggetti che rappresentano i singoli file presenti nella directory. Verrà quindi utilizzato l'operatore pipeline (|) per passare gli oggetti file attraverso la pipeline a Format-Wide, tramite il quale verranno formattati per l'output. Il numero di colonne verrà specificato nel parametro Column.
Esempio 2
C:\PS>get-childitem HKCU:\software\microsoft | format-wide -property pschildname -autosize Descrizione ----------- Tramite questo comando verranno visualizzati i nomi delle chiavi del Registro della chiave HKEY_CURRENT_USER\Software\Microsoft. Verrà utilizzato il cmdlet Get-ChildItem per ottenere gli oggetti che rappresentano le chiavi. Il percorso verrà specificato come "HKCU:", ovvero una delle unità esposte dal provider Registry di Windows PowerShell, seguito dal percorso della chiave. Verrà quindi utilizzato l'operatore pipeline (|) per passare gli oggetti chiave del Registro di sistema attraverso la pipeline a Format-Wide, tramite il quale verranno formattati per l'output. Per specificare il nome della proprietà, verrà utilizzato il parametro Property, mentre il parametro Autosize consentirà di adattare la larghezza delle colonne in modo che risultino facilmente leggibili.