Formatiert Objekte als breite Tabelle, in der nur eine Eigenschaft jedes Objekts angezeigt wird.
Syntax
Format-Wide [[-Eigenschaft] <Object>] [-AutoSize] [-Column <int>] [-DisplayError] [-Expand <string>] [-Force] [-GroupBy <Object>] [-InputObject <psobject>] [-ShowError] [-View <string>] [<CommonParameters>]
Beschreibung
Mit dem Cmdlet "Format-Wide" werden Objekte als breite Tabelle formatiert, in der nur eine Eigenschaft jedes Objekts angezeigt wird. Mit dem Property-Parameter können Sie bestimmen, welche Eigenschaft angezeigt wird.
Parameter
-AutoSize
Passt Größe und Anzahl der Spalten entsprechend der Länge der Daten an. Größe und Anzahl der Spalten werden standardmäßig durch die Ansicht bestimmt. Sie können den AutoSize-Parameter nicht zusammen mit dem Column-Parameter in einem Befehl verwenden.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Column <int>
Gibt die Anzahl der Spalten in der Anzeige an. Sie können den AutoSize-Parameter nicht zusammen mit dem Column-Parameter in einem Befehl verwenden.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-DisplayError
Zeigt Fehler in der Befehlszeile an.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Expand <string>
Formatiert das Auflistungsobjekt sowie die Objekte in der Auflistung. Mit diesem Parameter werden Objekte formatiert, die die ICollection-Schnittstelle (System.Collections) unterstützen. Der Standardwert ist "EnumOnly".
Gültige Werte:
– 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 der Objekte in der Auflistung an.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Force
Überschreibt Einschränkungen, die eine erfolgreiche Ausführung des Befehls verhindern, vorausgesetzt, dass dadurch die Sicherheit nicht gefährdet wird. Beispielsweise überschreibt "Force" das Schreibschutzattribut oder erstellt in einem Dateipfad fehlende Verzeichnisse. Es wird jedoch nicht versucht, Dateiberechtigungen zu ändern.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-GroupBy <Object>
Formatiert die Ausgabe anhand einer freigegebenen Eigenschaft oder eines freigegebenen Werts in Gruppen. Geben Sie einen Ausdruck oder eine Eigenschaft der Ausgabe ein.
Bei dem Wert des GroupBy-Parameters kann es sich um eine neu berechnete Eigenschaft handeln. Verwenden Sie zum Erstellen einer berechneten Eigenschaft eine Hashtabelle. Gültige Schlüssel sind:
– Name (oder Label) <Zeichenfolge>
– Expression <Zeichenfolge> oder <Skriptblock>
– FormatString <Zeichenfolge>
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-InputObject <psobject>
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.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
true (ByValue) |
|
Platzhalterzeichen akzeptieren? |
false |
-Eigenschaft <Object>
Gibt die Objekteigenschaften an, die angezeigt werden, sowie die Reihenfolge ihrer Anzeige. Platzhalter sind zulässig.
Wenn Sie diesen Parameter auslassen, hängen die angezeigten Eigenschaften vom angezeigten Objekt ab. Der Parametername ("Property") ist optional. Sie können den Property-Parameter nicht zusammen mit dem View-Parameter in einem Befehl verwenden.
Bei dem Wert des Property-Parameters kann es sich um eine neu berechnete Eigenschaft handeln. Verwenden Sie zum Erstellen einer berechneten Eigenschaft eine Hashtabelle. Gültige Schlüssel sind:
– Expression <Zeichenfolge> oder <Skriptblock>
– FormatString <Zeichenfolge>
|
Erforderlich? |
false |
|
Position? |
1 |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-ShowError
Übergibt Fehler über die Pipeline.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-View <string>
Gibt den Namen eines alternativen Tabellenformats bzw. einer alternativen Tabellenansicht an. Sie können den Property-Parameter nicht zusammen mit dem View-Parameter in einem Befehl verwenden.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
<CommonParameters>
Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.
Eingaben und Ausgaben
Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.
|
Eingaben |
System.Management.Automation.PSObject Sie können jedes Objekt über die Pipeline an Format-Wide übergeben. |
|
Ausgaben |
Microsoft.PowerShell.Commands.Internal.Format Format-Wide gibt Formatobjekte zurück, die die Tabelle darstellen. |
Hinweise
Sie können auch über den integrierten Alias "fw" auf Format-Wide verweisen. Weitere Informationen finden Sie unter "about_Aliases".
Für den GroupBy-Parameter wird vorausgesetzt, dass die Objekte sortiert sind. Bevor Sie die Objekte mit Format-Custom gruppieren, sortieren Sie sie mit Sort-Object.
Mit dem -View-Parameter können Sie ein alternatives Format für die Tabelle angeben. Sie können die in den *.FORMAT.PS1XML-Dateien im Windows PowerShell-Verzeichnis definierten Ansichten verwenden oder eigene Ansichten in neuen PS1XML-Dateien erstellen und sie mit dem Cmdlet "Update-FormatData" in Windows PowerShell einfügen.
Die alternative Ansicht für den View-Parameter muss als Tabelle formatiert werden. Andernfalls verursacht der Befehl einen Fehler. 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.
Beispiel 1
C:\PS>get-childitem | format-wide -column 3 Beschreibung ----------- Mit diesem Befehl werden die Namen der Dateien im aktuellen Verzeichnis in drei Spalten auf dem gesamten Bildschirm angezeigt. Mit dem Cmdlet "Get-ChildItem" werden Objekte abgerufen, die die einzelnen Dateien im Verzeichnis darstellen. Mit dem Pipelineoperator (|) werden die Dateiobjekte über die Pipeline an das Cmdlet "Format-Wide" übergeben, das sie für die Ausgabe formatiert. Der Column-Parameter gibt die Anzahl der Spalten an.
Beispiel 2
C:\PS>get-childitem HKCU:\software\microsoft | format-wide -property pschildname -autosize Beschreibung ----------- Mit diesem Befehl werden die Namen der Registrierungsschlüssel im Schlüssel "HKEY_CURRENT_USER\Software\Microsoft" angezeigt. Mit dem Cmdlet "Get-ChildItem" werden Objekte abgerufen, die die Schlüssel darstellen. Als Pfad wird "HKCU:", eines der vom Windows PowerShell-Registry-Anbieter verfügbar gemachten Laufwerke angegeben, auf den der Pfad der Schlüssel folgt. Mit dem Pipelineoperator (|) werden die Registrierungsschlüsselobjekte über die Pipeline an das Cmdlet "Format-Wide" übergeben, das sie für die Ausgabe formatiert. Der Property-Parameter gibt den Namen der Eigenschaft an, und der AutoSize-Parameter passt die Spalten für eine bessere Lesbarkeit an.