Format-Wide
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 Eigenschaftsparameter verwenden, um zu bestimmen, welche Eigenschaft angezeigt wird.
Beispiele
Beispiel 1: Formatieren von Dateinamen 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 3Das Cmdlet „Get-ChildItem“ ruft die Objekte ab, die jede Datei im Verzeichnis darstellen. Der Pipelineoperator (|) übergibt die Dateiobjekte durch die Pipeline Format-Wide, an die sie für die Ausgabe formatiert werden. Der Spaltenparameter gibt die Anzahl der Spalten an.
Beispiel 2: Formatieren von Namen von Registrierungsschlüsseln
Dieser Befehl zeigt die Namen der Registrierungsschlüssel im Schlüssel „HKEY_CURRENT_USER\Software\Microsoft“ an.
Get-ChildItem HKCU:\software\microsoft | Format-Wide -Property pschildname -AutoSizeDas Cmdlet „Get-ChildItem“ ruft die 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 durch die Pipeline Format-Wide, an die sie für die Ausgabe formatiert werden. Der Eigenschaftsparameter gibt den Namen der Eigenschaft an, und der AutoSize-Parameter passt die Spalten für die 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 : PSPropertyExpressionErrorParameter
-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 "Spalte " nicht im gleichen 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 "Spalte " nicht im gleichen 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 jedoch als Debughilfe verwendet werden, wenn Sie Ausdrücke in einem Format-Wide Befehl formatieren und die Ausdrücke nicht 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 dient zum Formatieren der Objekte, die die ICollection (System.Collections)-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.
- Beides: 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 verläuft, so dass die Änderungen keine Sicherheit kompromittieren. Beispielsweise überschreibt Force das Schreibschutzattribut oder erstellt Verzeichnisse zum Vervollständigen eines Dateipfads. Es wird jedoch nicht etwa versucht, 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 Bezeichnung) -
<string> - Ausdruck -
<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 in der Anzeige angezeigten Objekteigenschaften und die Reihenfolge an, in der sie angezeigt werden. 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 "Eigenschaft " und " Ansicht " nicht im gleichen Befehl verwenden.
Der Wert des Eigenschaftsparameters 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> - 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 jedoch als Debughilfe verwendet werden, wenn Sie Ausdrücke in einem Format-Wide Befehl formatieren und die Ausdrücke nicht 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 Ansicht an. Sie können die Parameter "Eigenschaft " und " Ansicht " nicht im gleichen Befehl verwenden.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Eingaben
Sie können ein beliebiges Objekt an Format-Wide.
Ausgaben
Microsoft.PowerShell.Commands.Internal.Format
Format-Wide gibt Formatobjekte zurück, die die Tabelle darstellen.
Hinweise
Sie können auch Format-Wide über den integrierten Alias verweisen fw. Weitere Informationen finden Sie unter about_Aliases.
Der Parameter "GroupBy " geht davon aus, dass die Objekte sortiert werden. Verwenden Sie die Verwendung Sort-ObjectFormat-Custom , um die Objekte zu gruppieren.
Mit dem Parameter "Ansicht " 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 Ansichtsparameter muss das Tabellenformat verwenden; falls nicht, schlägt der Befehl fehl. Wenn die alternative Ansicht eine Liste ist, verwenden Sie Format-List. Wenn die alternative Ansicht weder eine Liste noch eine Tabelle ist, verwenden Sie Format-Custom.