Condividi tramite

Format-Wide

Modulo:
Microsoft.PowerShell.Utility Module

Formatta gli oggetti come tabella estesa che visualizza una sola proprietà di ogni oggetto.

Sintassi

Default (Impostazione predefinita) 

Format-Wide
    [[-Property] <Object>]
    [-AutoSize]
    [-Column <int>]
    [-GroupBy <Object>]
    [-View <string>]
    [-ShowError]
    [-DisplayError]
    [-Force]
    [-Expand <string>]
    [-InputObject <psobject>]
    [<CommonParameters>]

Descrizione

Il cmdlet Format-Wide formatta gli oggetti come tabella estesa che visualizza solo una proprietà di ogni oggetto. È possibile utilizzare il parametro proprietà per determinare quale proprietà viene visualizzata.

Esempio

Esempio 1: Formattare i nomi dei file nella directory corrente

Questo comando visualizza i nomi dei file nella directory corrente in tre colonne sullo schermo.

Get-ChildItem | Format-Wide -Column 3

Il cmdlet Get-ChildItem ottiene gli oggetti che rappresentano ogni file nella directory. L'operatore pipeline (|) passa gli oggetti file attraverso la pipeline a Format-Wide, che li formatta per l'output. Il parametro colonna specifica il numero di colonne.

Esempio 2: Formattare i nomi delle chiavi del Registro di sistema

Questo comando visualizza i nomi delle chiavi del Registro di sistema nella chiave di HKEY_CURRENT_USER\Software\Microsoft.

Get-ChildItem HKCU:\software\microsoft | Format-Wide -Property pschildname -AutoSize

Il cmdlet Get-ChildItem ottiene gli oggetti che rappresentano le chiavi. Il percorso viene specificato come HKCU:, una delle unità esposte dal provider del Registro di sistema di PowerShell, seguito dal percorso della chiave. L'operatore pipeline (|) passa gli oggetti chiave del Registro di sistema attraverso la pipeline a Format-Wide, che li formatta per l'output. Il parametro Property specifica il nome della proprietà e il parametro AutoSize regola le colonne per la leggibilità.

Esempio 3: Risoluzione degli errori di formato

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

PS /> Get-Date | Format-Wide { $_ / $null } -DisplayError


#ERR

PS /> Get-Date | Format-Wide { $_ / $null } -ShowError


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

Parametri

-AutoSize

Regola le dimensioni della colonna e il numero di colonne in base alla larghezza dei dati. Per impostazione predefinita, le dimensioni e il numero della colonna sono determinati dalla visualizzazione. Non è possibile utilizzare i parametri AutoSize e Column nello stesso comando.

Proprietà dei parametri

Tipo:SwitchParameter
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

-Column

Specifica il numero di colonne nella visualizzazione. Non è possibile utilizzare i parametri AutoSize e Column nello stesso comando.

Proprietà dei parametri

Tipo:Int32
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

-DisplayError

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 comando Format-Wide e le espressioni non sembrano funzionare.

Proprietà dei parametri

Tipo:SwitchParameter
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

-Expand

Formatta l'oggetto della raccolta, nonché gli oggetti dell'insieme. Questo parametro è progettato per formattare gli oggetti che supportano l'interfaccia ICollection (System.Collections). Il valore predefinito è EnumOnly.

I valori validi sono:

  • EnumOnly: visualizza le proprietà degli oggetti nell'insieme.
  • CoreOnly: Visualizza le proprietà dell'oggetto di raccolta.
  • Entrambi: visualizza le proprietà dell'oggetto dell'insieme e le proprietà degli oggetti nell'insieme.

Proprietà dei parametri

Tipo:String
Valore predefinito:EnumOnly
Valori accettati:CoreOnly, EnumOnly, Both
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

-Force

Indica che questo cmdlet esegue l'override delle restrizioni che impediscono il successo del comando, in modo che le modifiche non compromettano la sicurezza. Ad esempio, Force sostituirà l'attributo di sola lettura o creerà directory per completare un percorso di file, ma non tenterà di modificare le autorizzazioni dei file.

Proprietà dei parametri

Tipo:SwitchParameter
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

-GroupBy

Formatta 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. Per creare una proprietà calcolata, utilizzare una tabella hash. I valori accettabili per questo parametro sono:

  • Stringa nome (o etichetta) <>
  • Stringa di< espressione >o <blocco di script>
  • Stringa FormatString <>

Proprietà dei parametri

Tipo:Object
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

-InputObject

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

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

-Property

Specifica le proprietà dell'oggetto visualizzate nella visualizzazione e l'ordine in cui vengono visualizzate. Sono consentiti i metacaratteri.

Se si omette questo parametro, le proprietà visualizzate nella visualizzazione dipendono dall'oggetto visualizzato. Il nome del parametro "Proprietà" è 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:

  • Stringa di< espressione >o <blocco di script>
  • Stringa FormatString <>

Proprietà dei parametri

Tipo:Object
Valore predefinito:None
Supporta i caratteri jolly:True
DontShow:False

Set di parametri

(All)
Posizione:0
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ShowError

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 comando Format-Wide e le espressioni non sembrano funzionare.

Proprietà dei parametri

Tipo:SwitchParameter
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

-View

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

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

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 reindirizzare qualsiasi oggetto a Format-Wide.

Output

Microsoft.PowerShell.Commands.Internal.Format

Format-Wide Restituisce gli oggetti format che rappresentano la tabella.

Note

È anche possibile fare riferimento a Format-Wide dal relativo alias predefinito fw. Per altre informazioni, vedere about_Aliases.

Il parametro GroupBy presuppone che gli oggetti siano ordinati. Utilizzare Sort-Object prima dell'uso Format-Custom per raggruppare gli oggetti.

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

La vista alternativa per il parametro View deve usare il formato tabella; in caso contrario, il comando ha esito negativo. Se la visualizzazione alternativa è un elenco, usare Format-List. Se la visualizzazione alternativa non è né un elenco né una tabella, utilizzare Format-Custom.