Format-Wide

  • Referenz
Modul:
Microsoft.PowerShell.Utility

Formatiert Objekte als eine große Tabelle, in der nur eine Eigenschaft pro Objekt angezeigt wird.

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

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

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

-Column

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

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

-DisplayError

Zeigt Fehler in 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.

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

-Expand

Formatiert das Auflistungsobjekt und die Objekte in der Auflistung. Dieser Parameter wurde entwickelt, um Objekte zu formatieren, die die System.Collections.ICollection-Schnittstelle 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 Auflistungsobjekts an.
  • Both: Zeigt die Eigenschaften des Auflistungsobjekts und die Eigenschaften von Objekten in der Auflistung an.
Type:String
Accepted values:CoreOnly, EnumOnly, Both
Position:Named
Default value:EnumOnly
Required:False
Accept pipeline input:False
Accept wildcard characters: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 schreibgeschützte Attribut oder erstellt Verzeichnisse zum Abschließen eines Dateipfads, versucht jedoch nicht, Dateiberechtigungen zu ändern.

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

-GroupBy

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

Der Wert des GroupBy-Parameters kann eine neue berechnete Eigenschaft sein. Die berechnete Eigenschaft kann ein Skriptblock oder eine Hashtabelle sein. Gültige Schlüsselwertpaare sind:

  • Name (oder Label) - <string>
  • Expression - <string> oder <script block>
  • FormatString - <string>

Weitere Informationen finden Sie unter about_Calculated_Properties.

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

-InputObject

Gibt die zu formatierenden Objekte an. Geben Sie eine Variable ein, die die Objekte enthält, oder geben Sie einen Befehl oder einen Ausdruck ein, mit dem die Objekte abgerufen werden.

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

-Property

Gibt die Objekteigenschaft an, die in der Anzeige angezeigt wird. Platzhalter sind zulässig.

Wenn Sie diesen Parameter weglassen, hängen die in der Anzeige dargestellten Eigenschaften von dem angezeigten Objekt ab. Der Parametername -Eigenschaft 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. Die berechnete Eigenschaft kann ein Skriptblock oder eine Hashtabelle sein. Gültige Schlüsselwertpaare sind:

  • Expression - <string> oder <script block>
  • FormatString - <string>

Weitere Informationen finden Sie unter about_Calculated_Properties.

Type:Object
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

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.