Condividi tramite

Format-Wide

  • Riferimento
Modulo:
Microsoft.PowerShell.Utility

Formatta gli oggetti come tabella estesa che visualizza una sola 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 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 della pipeline (|) passa gli oggetti 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 pipeline (|) trasmette attraverso la pipeline gli oggetti della chiave del registro di sistema 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.

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 comando Format-Wide 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 dell'insieme. 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 della raccolta.
  • Both: visualizza le proprietà dell'oggetto raccolta 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 sostituirà l'attributo di sola lettura o creerà directory per completare un percorso di file, ma non tenterà di modificare le autorizzazioni dei 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 parametro GroupBy si aspetta che gli oggetti siano già 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.

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 contenente 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. Sono consentiti caratteri jolly.

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.

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 comando Format-Wide 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

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.