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 estesa che visualizza una sola proprietà di ogni oggetto. È possibile utilizzare il parametro Property 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 disposti in tre colonne sullo schermo.

Get-ChildItem | Format-Wide -Column 3

Il Get-ChildItem cmdlet ottiene oggetti che rappresentano ogni file nella directory. L'operatore 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 HKEY_CURRENT_USER\Software\Microsoft chiave.

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

Il Get-ChildItem cmdlet ottiene 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 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

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 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 utilizzare i parametri AutoSize e Column nello stesso comando.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Column

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

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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 Format-Wide comando e le espressioni non sembrano funzionare.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Expand

Formatta l'oggetto raccolta, nonché gli oggetti nella raccolta. Questo parametro è progettato per formattare gli 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 raccolta.
  • Both: visualizza le proprietà dell'oggetto insieme e le proprietà degli oggetti nell'insieme.
Tipo:String
Valori accettati:CoreOnly, EnumOnly, Both
Posizione:Named
Valore predefinito:EnumOnly
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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 eseguirà l'override dell'attributo di sola lettura o creerà directory per completare un percorso di file, ma non tenterà di modificare le autorizzazioni per i file.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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. 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> oppure <script block>
  • FormatString - <string>

Per altre informazioni, vedere about_Calculated_Properties.

Tipo:Object
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:PSObject
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Property

Specifica la proprietà dell'oggetto visualizzata nella visualizzazione. 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 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> oppure <script block>
  • FormatString - <string>

Per altre informazioni, vedere about_Calculated_Properties.

Tipo:Object
Posizione:0
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-View

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

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

PSObject

È possibile inviare tramite pipe qualsiasi oggetto a questo cmdlet.

Output

Microsoft.PowerShell.Commands.Internal.Format

Questo cmdlet restituisce oggetti di formato che rappresentano la tabella.

Note

PowerShell include gli alias seguenti per Format-Wide:

  • Tutte le piattaforme:
    • fw

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

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