Condividi tramite

Format-Wide

  • Riferimento
Modulo:
Microsoft.PowerShell.Utility

Formatta gli oggetti come una tabella estesa in larghezza che visualizza solo una proprietà di ogni oggetto.

Sintassi

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

Descrizione

Il Format-Wide cmdlet formatta gli oggetti come tabella wide che visualizza solo una proprietà di ogni oggetto. È possibile usare il parametro Property per determinare la proprietà visualizzata.

Esempio

Esempio 1: Formattare i nomi dei file nella directory corrente

Questo comando visualizza i nomi dei file nella directory corrente disposti 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 della pipeline (|) passa gli oggetti file tramite la pipeline a Format-Wide, che li formatta per l'output. Il parametro Column 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 gli oggetti che rappresentano le chiavi. Il percorso viene specificato come HKCU:, una delle unità esposte dal provider del Registro di sistema di PowerShell, seguita dal percorso della chiave. L'operatore della pipeline (|) passa gli oggetti chiave del Registro di sistema tramite 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

Gli esempi seguenti mostrano 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 e il numero di colonne in base alla larghezza dei dati. Per impostazione predefinita, le dimensioni e il numero di colonne dipendono dalla visualizzazione. Non è possibile usare i parametri AutoSize e Column nello stesso comando.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Column

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayError

Visualizza gli errori nella riga di comando. Questo parametro viene usato raramente, ma può essere usato come aiuto di debug quando si formattano espressioni in un Format-Wide comando e le espressioni non sembrano funzionare.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Expand

Formatta l'oggetto raccolta, nonché gli oggetti nella raccolta. 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 raccolta.
  • Entrambi: visualizza le proprietà dell'oggetto raccolta e le proprietà degli oggetti nell'insieme.
Type:String
Accepted values:CoreOnly, EnumOnly, Both
Position:Named
Default value:EnumOnly
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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, usare una tabella hash. I valori validi per questo parametro sono:

  • Nome (o etichetta) <stringa>
  • Stringa> di espressione <o <blocco di script>
  • Stringa FormatString <>
Type:Object
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:PSObject
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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 usare i parametri Proprietà e Visualizzazione nello stesso comando.

Il valore del parametro Property può essere una nuova proprietà calcolata. Per creare una proprietà calcolata, usare una tabella hash. Le chiavi valide sono:

  • Stringa> di espressione <o <blocco di script>
  • Stringa FormatString <>
Type:Object
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-ShowError

Invia errori tramite la pipeline. Questo parametro viene usato raramente, ma può essere usato come aiuto di debug quando si formattano espressioni in un Format-Wide comando e le espressioni non sembrano funzionare.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-View

Specifica il nome di un formato di tabella o di una visualizzazione alternativi. Non è possibile usare i parametri Proprietà e Visualizzazione nello stesso comando.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

PSObject

È possibile eseguire la pipe di qualsiasi oggetto in Format-Wide.

Output

Microsoft.PowerShell.Commands.Internal.Format

Format-Wide restituisce oggetti di formato che rappresentano la tabella.

Note

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

Il parametro GroupBy presuppone che gli oggetti siano ordinati. Usare Sort-Object prima di usare 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 nella directory di PowerShell oppure creare visualizzazioni personalizzate nei *.format.PS1XML nuovi file PS1XML e usare il Update-FormatData cmdlet per includerli in PowerShell.

La visualizzazione alternativa per il parametro View deve usare il formato tabella; se non lo fa, 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, usare Format-Custom.