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 oggetti che rappresentano ogni file nella directory. L'operatore pipeline (|) passa gli oggetti di file attraverso la pipeline a Format-Wide, che li formatta per l'uscita. 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 HKEY_CURRENT_USER\Software\Microsoft.

Get-ChildItem HKCU:\software\Microsoft | Format-Wide -Property PSChildName -AutoSize

Il cmdlet Get-ChildItem ottiene oggetti che rappresentano le chiavi. Il percorso viene specificato come HKCU:, uno dei percorsi delle unità esposte dal provider del Registro di sistema di PowerShell, seguiti dal percorso della chiave. L'operatore della pipeline (|) trasferisce gli oggetti chiave del Registro di sistema attraverso la pipeline fino 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 oggetti che supportano l'interfaccia System.Collections.ICollection. Il valore predefinito è EnumOnly.

I valori validi sono:

  • EnumOnly: visualizza le proprietà degli oggetti nell'insieme.
  • CoreOnly: visualizza le proprietà dell'oggetto della collezione.
  • Both: visualizza le proprietà dell'oggetto raccolta 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 parametro GroupBy richiede che gli oggetti siano ordinati. Usare il cmdlet Sort-Object prima di usare Format-Wide per raggruppare gli oggetti.

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> o <script block>
  • FormatString - <string>

Per altre informazioni, vedere about_Calculated_Properties.

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 la proprietà dell'oggetto visualizzata nella visualizzazione. Sono consentiti i metacaratteri.

Se si omette questo parametro, le proprietà visualizzate 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:

  • Expression - <string> o <script block>
  • FormatString - <string>

Per altre informazioni, vedere about_Calculated_Properties.

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 passare qualsiasi oggetto come input a questo cmdlet.

Output

Microsoft.PowerShell.Commands.Internal.Format

Questo cmdlet restituisce oggetti di formato che rappresentano la tabella.

Note

Windows PowerShell include gli alias seguenti per Format-Wide:

  • fw

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.