Format-Wide

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.