Freigeben über

Format-Custom

Modul:
Microsoft.PowerShell.Utility Module

Verwendet eine angepasste Ansicht, um die Ausgabe zu formatieren.

Syntax

Default (Standardwert) 

Format-Custom
    [[-Property] <Object[]>]
    [-Depth <Int32>]
    [-GroupBy <Object>]
    [-View <String>]
    [-ShowError]
    [-DisplayError]
    [-Force]
    [-Expand <String>]
    [-InputObject <PSObject>]
    [<CommonParameters>]

Beschreibung

Das Cmdlet Format-Custom formatiert die Ausgabe eines Befehls wie in einer alternativen Ansicht definiert. Format-Custom dient zum Anzeigen von Ansichten, die nicht nur Tabellen oder nur Listen sind. Sie können die in PowerShell definierten Ansichten verwenden oder eigene Ansichten in einer neuen format.ps1xml Datei erstellen und das cmdlet Update-FormatData verwenden, um sie zu PowerShell hinzuzufügen.

Beispiele

Beispiel 1: Ausgabe mit einer angepassten Ansicht formatieren

Get-Command Start-Transcript | Format-Custom -View MyView

Mit diesem Befehl werden Informationen zum Cmdlet Start-Transcript im Format dargestellt, das durch die MyView-Ansicht definiert wurde — eine benutzerdefinierte Ansicht, die vom Nutzer erstellt wurde. Um diesen Befehl erfolgreich auszuführen, müssen Sie zuerst eine neue PS1XML-Datei erstellen, die MyView--Ansicht definieren und dann den befehl Update-FormatData verwenden, um die PS1XML-Datei zu PowerShell hinzuzufügen.

Beispiel 2: Ausgabe formatieren mit Standardansicht

Get-Process Winlogon | Format-Custom

Dieser Befehl formatiert Informationen über den Prozess Winlogon in einer alternativen, angepassten Ansicht. Da der Befehl den Parameter View nicht verwendet, verwendet Format-Custom eine benutzerdefinierte Standardansicht, um die Daten zu formatieren.

Beispiel 3: Problembehandlung bei Formatfehlern

Die folgenden Beispiele zeigen die Ergebnisse, wenn Sie die Parameter DisplayError oder ShowError mit einem Ausdruck hinzufügen.

PC /> Get-Date | Format-Custom DayOfWeek,{ $_ / $null } -DisplayError

class DateTime
{
  DayOfWeek = Friday
   $_ / $null  = #ERR
}

PC /> Get-Date | Format-Custom DayOfWeek,{ $_ / $null } -ShowError

class DateTime
{
  DayOfWeek = Friday
   $_ / $null  =
}

Failed to evaluate expression " $_ / $null ".
+ CategoryInfo          : InvalidArgument: (12/21/2018 8:01:04 AM:PSObject) [], RuntimeException
+ FullyQualifiedErrorId : PSPropertyExpressionError

Parameter

-Depth

Gibt die Anzahl der Spalten in der Anzeige an.

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-Custom 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 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 Sammlungsobjekts an.
  • Beides: Zeigt die Eigenschaften des Auflistungsobjekts und die Objekte 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

Leitet das Cmdlet an, um alle Fehlerinformationen anzuzeigen. Wird mit den Parametern DisplayError oder ShowError verwendet. Wenn ein Fehlerobjekt standardmäßig in den Fehler- oder Anzeigedatenstrom geschrieben wird, werden nur einige der Fehlerinformationen angezeigt.

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 parameter GroupBy erwartet, dass die Objekte sortiert werden. Verwenden Sie das Cmdlet Sort-Object, bevor Sie Format-Custom verwenden, um die Objekte zu gruppieren.

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

  • Name (oder Bezeichnung) – <string>
  • Ausdruck – <string> oder <script block>
  • FormatString – <string>

Weitere Informationen finden Sie unter about_Calculated_Properties.

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 einen Ausdruck ein, durch den die Objekte abgerufen werden.

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. Die berechnete Eigenschaft kann ein Skriptblock oder eine Hashtabelle sein. Gültige Schlüsselwertpaare sind:

  • Ausdruck – <string> oder <script block>
  • Tiefe – <int32>

Weitere Informationen finden Sie unter about_Calculated_Properties.

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-Custom 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 Formats oder einer anderen Ansicht an. Wenn Sie diesen Parameter weglassen, verwendet Format-Custom eine benutzerdefinierte Standardansicht. 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 dieses Cmdlet weiterleiten.

Ausgaben

Microsoft.PowerShell.Commands.Internal.Format

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

Hinweise

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

  • Alle Plattformen:
    • fc

Format-Custom dient zum Anzeigen von Ansichten, die nicht nur Tabellen oder nur Listen sind. Verwenden Sie Format-Table, um eine alternative Tabellenansicht anzuzeigen. Verwenden Sie Format-List, um eine alternative Listenansicht anzuzeigen.

Der parameter GroupBy geht davon aus, dass die Objekte sortiert sind. Bevor Sie Format-Custom zum Gruppieren der Objekte verwenden, verwenden Sie Sort-Object, um sie zu sortieren.