Freigeben über

Format-Wide

Modul:
Microsoft.PowerShell.Utility Module

Formatiert Objekte als breite Tabelle, die nur eine Eigenschaft jedes Objekts anzeigt.

Syntax

Default (Standard) 

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

Beschreibung

Das cmdlet Format-Wide 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

Mit diesem Befehl werden die Namen von Dateien im aktuellen Verzeichnis in drei Spalten auf dem Bildschirm angezeigt.

Get-ChildItem | Format-Wide -Column 3

Das Cmdlet Get-ChildItem ruft Objekte ab, die die einzelnen Dateien im Verzeichnis darstellen. Der Pipelineoperator (|) übergibt die Dateiobjekte durch die Pipeline an Format-Wide, wodurch 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 der Registrierungsschlüssel im HKEY_CURRENT_USER\Software\Microsoft Schlüssel angezeigt.

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

Das Cmdlet Get-ChildItem ruft Objekte ab, die die Schlüssel darstellen. Der Pfad wird als HKCU: angegeben, eines der Laufwerke, die vom PowerShell-Registrierungsanbieter verfügbar gemacht werden, gefolgt vom Schlüsselpfad. Der Pipelineoperator (|) übergibt die Registrierungsschlüsselobjekte über die Pipeline an Format-Wide, wodurch 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, wenn Sie die Parameter DisplayError oder ShowError mit einem Ausdruck hinzufügen.

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

Passt die Spaltengröße und die Anzahl der Spalten basierend auf der Breite der Daten an. Standardmäßig werden die Spaltengröße und -zahl durch die Ansicht bestimmt. Sie können die parameter AutoSize und Column im selben Befehl nicht verwenden.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Column

Gibt die Anzahl der Spalten in der Anzeige an. Sie können die parameter AutoSize und Column im selben Befehl nicht verwenden.

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DisplayError

Zeigt Fehler an der Befehlszeile an. Dieser Parameter wird selten verwendet, kann aber als Debugginghilfe verwendet werden, wenn Sie Ausdrücke in einem Format-Wide Befehl formatieren, und die Ausdrücke scheinen nicht zu funktionieren.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Expand

Formatiert das Auflistungsobjekt und die Objekte in der Auflistung. Dieser Parameter wurde entwickelt, um Objekte zu formatieren, die die ICollection-Schnittstelle (System.Collections) unterstützen. Der Standardwert ist EnumOnly.

Gültige Werte sind:

  • EnumOnly: Zeigt die Eigenschaften der Objekte in der Auflistung an.
  • CoreOnly: Zeigt die Eigenschaften des Sammlungsobjekts an.
  • Beides: Zeigt die Eigenschaften des Auflistungsobjekts und die Eigenschaften von Objekten in der Auflistung an.

Parametereigenschaften

Typ:String
Standardwert:EnumOnly
Zulässige Werte:CoreOnly, EnumOnly, Both
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Force

Gibt an, dass dieses Cmdlet Einschränkungen außer Kraft setzt, die verhindern, dass der Befehl erfolgreich ausgeführt wird, sodass die Änderungen keine Sicherheit gefährden. Beispielsweise überschreibt Force das Schreibschutzattribut oder erstellt Verzeichnisse zum Vervollständigen eines Dateipfads. Es wird jedoch nicht versucht, Dateiberechtigungen zu ändern.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-GroupBy

Formatiert die Ausgabe in Gruppen basierend auf einer gemeinsamen Eigenschaft oder einem gemeinsamen Wert. Geben Sie einen Ausdruck oder eine Eigenschaft der Ausgabe ein.

Der Wert des parameters GroupBy kann eine neue berechnete Eigenschaft sein. Verwenden Sie zum Erstellen einer berechneten Eigenschaft eine Hashtabelle. Die zulässigen Werte für diesen Parameter sind:

  • Name (oder Bezeichnung) <Zeichenfolge>
  • Ausdruck <Zeichenfolge> oder <Skriptblocks>
  • FormatString-<Zeichenfolgen->

Parametereigenschaften

Typ:Object
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-InputObject

Gibt die zu formatierenden Objekte an. Geben Sie eine Variable ein, die die Objekte enthält, oder geben Sie einen Befehl oder Ausdruck ein, der die Objekte ermittelt.

Parametereigenschaften

Typ:PSObject
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Property

Legt die Objekteigenschaften fest, die in der Anzeige erscheinen, sowie die Reihenfolge ihres Erscheinens. Wildcards sind zulässig.

Wenn Sie diesen Parameter weglassen, hängen die eigenschaften, die in der Anzeige angezeigt werden, vom angezeigten Objekt ab. Der Parametername "Property" ist optional. Sie können die Parameter Property und View nicht im selben Befehl verwenden.

Der Wert des Property-Parameters kann eine neue berechnete Eigenschaft sein. Verwenden Sie zum Erstellen einer berechneten Eigenschaft eine Hashtabelle. Gültige Schlüssel sind:

  • Ausdruck <Zeichenfolge> oder <Skriptblocks>
  • FormatString-<Zeichenfolgen->

Parametereigenschaften

Typ:Object
Standardwert:None
Unterstützt Platzhalter:True
Nicht anzeigen:False

Parametersätze

(All)
Position:0
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ShowError

Sendet Fehler über die Pipeline. Dieser Parameter wird selten verwendet, kann aber als Debugginghilfe verwendet werden, wenn Sie Ausdrücke in einem Format-Wide Befehl formatieren, und die Ausdrücke scheinen nicht zu funktionieren.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-View

Gibt den Namen eines alternativen Tabellenformats oder einer anderen Ansicht an. Sie können die Parameter Property und View nicht im selben Befehl verwenden.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

PSObject

Sie können jedes Objekt an Format-Widepfeifen.

Ausgaben

Microsoft.PowerShell.Commands.Internal.Format

Format-Wide gibt Formatobjekte zurück, die die Tabelle darstellen.

Hinweise

Sie können sich auch an Format-Wide durch seinen eingebauten Alias, fw. Weitere Informationen finden Sie unter about_Aliases.

Der parameter GroupBy geht davon aus, dass die Objekte sortiert sind. Vor der Verwendung Sort-Object verwendenFormat-Custom, um die Objekte zu gruppieren.

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 cmdlet Update-FormatData verwenden, um sie in PowerShell einzuschließen.

Die alternative Ansicht für den Parameter Ansicht 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 es sich bei der alternativen Ansicht weder um eine Liste noch um eine Tabelle handelt, verwenden Sie Format-Custom.