Format-Wide

Syntax

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

Beschreibung

Das Format-Wide Cmdlet formatiert Objekte als breite Tabelle, die nur eine Eigenschaft jedes Objekts anzeigt. Sie können den Parameter Property verwenden, um zu bestimmen, welche Eigenschaft angezeigt wird.

Beispiele

Beispiel 1: Formatieren von Namen von Dateien im aktuellen Verzeichnis

Dieser Befehl zeigt die Namen der Dateien im aktuellen Verzeichnis in drei Spalten auf dem Bildschirm an.

Get-ChildItem | Format-Wide -Column 3

Das Get-ChildItem Cmdlet ruft Objekte ab, die jede Datei im Verzeichnis darstellen. Der Pipelineoperator (|) übergibt die Dateiobjekte an die Pipeline Format-Wide, an die sie für die Ausgabe formatiert werden. Der Parameter Column gibt die Anzahl der Spalten an.

Beispiel 2: Formatieren von Namen von Registrierungsschlüsseln

Mit diesem Befehl werden die Namen von Registrierungsschlüsseln im HKEY_CURRENT_USER\Software\Microsoft Schlüssel angezeigt.

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

Das Get-ChildItem Cmdlet ruft Objekte ab, die die Schlüssel darstellen. Der Pfad wird als HKCU:, eines der Laufwerke angegeben, die vom PowerShell-Registrierungsanbieter verfügbar gemacht werden, gefolgt vom Schlüsselpfad. Der Pipelineoperator (|) übergibt die Registrierungsschlüsselobjekte an die Pipeline Format-Wide, an die sie für die Ausgabe formatiert werden. Der Parameter Property gibt den Namen der Eigenschaft an, und der AutoSize-Parameter passt die Spalten zur Lesbarkeit an.

Beispiel 3: Problembehandlung bei Formatfehlern

Die folgenden Beispiele zeigen die Ergebnisse des Hinzufügens der DisplayError - oder ShowError-Parameter mit einem Ausdruck.

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

Parameter

-AutoSize

-Column

-DisplayError

-Expand

-Force

-GroupBy

-InputObject

-Property

-ShowError

-View

Eingaben

PSObject

Sie können jedes Objekt an dieses Cmdlet weiterleiten.

Ausgaben

Microsoft.PowerShell.Commands.Internal.Format

Dieses Cmdlet gibt Formatobjekte zurück, die die Tabelle darstellen.

Hinweise

PowerShell enthält die folgenden Aliase für Format-Wide:

• Alle Plattformen:
  • fw

Der Parameter GroupBy geht davon aus, dass die Objekte sortiert sind. Verwenden Sie Sort-Object vor der Verwendung Format-Custom zum Gruppieren der Objekte.

Mit dem Parameter View können Sie ein alternatives Format für die Tabelle angeben. Sie können die in den *.format.PS1XML Dateien im PowerShell-Verzeichnis definierten Ansichten verwenden oder eigene Ansichten in neuen PS1XML-Dateien erstellen und das Update-FormatData Cmdlet verwenden, um sie in PowerShell einzuschließen.

Die alternative Ansicht für den Parameter "View " muss das Tabellenformat verwenden. Wenn dies nicht der Fall ist, schlägt der Befehl fehl. Wenn es sich bei der alternativen Ansicht um eine Liste handelt, verwenden Sie Format-List. Wenn die alternative Ansicht weder eine Liste noch eine Tabelle ist, verwenden Sie Format-Custom.

Ähnliche Themen

• about_Calculated_Properties
• Format-Custom
• Format-Hex
• Format-List
• Format-Table