Benutzerdefinierte Formatierungsdateien

Das Anzeigeformat für die von Cmdlets, Funktionen und Skripts zurückgegebenen Objekte werden mithilfe von Formatierungsdateien (format.ps1xml Dateien) definiert. Einige dieser Dateien werden von Windows PowerShell bereitgestellt, um das Standardanzeigeformat für diese Objekte zu definieren, die von Windows PowerShell-Cmdlets zurückgegeben werden. Sie können jedoch auch eigene benutzerdefinierte Formatierungsdateien erstellen, um die Standardanzeigeformate zu überschreiben oder die Anzeige von Objekten zu definieren, die von Ihren eigenen Befehlen zurückgegeben werden.

Windows PowerShell verwendet die Daten in diesen Formatierungsdateien, um zu bestimmen, was angezeigt wird und wie die Daten formatiert werden. Die angezeigten Daten können die Eigenschaften eines Objekts oder den Wert eines Skriptblocks enthalten. Skriptblöcke werden verwendet, wenn Sie einen Wert anzeigen möchten, der nicht direkt aus den Eigenschaften eines Objekts verfügbar ist. Sie können z. B. den Wert von zwei Eigenschaften eines Objekts hinzufügen und die Summe als separate Datenmenge anzeigen. Wenn Sie eine eigene Formatierungsdatei schreiben, müssen Sie Ansichten für die Anzuzeigenden Objekte definieren. Sie können eine einzelne Ansicht für jedes Objekt definieren, eine einzelne Ansicht für mehrere Objekte definieren oder mehrere Ansichten für dasselbe Objekt definieren. Es gibt keine Beschränkung auf die Anzahl der Ansichten, die Sie definieren können.

Wichtig

Formatierungsdateien bestimmen nicht die Elemente eines Objekts, die an die Pipeline zurückgegeben werden. Wenn ein Objekt an die Pipeline zurückgegeben wird, sind alle Elemente dieses Objekts verfügbar.

Formatieren von Ansichten

Formatierungsansichten können Objekte in einem Tabellenformat, einem Listenformat, einem breiten Format und einem benutzerdefinierten Format anzeigen. In den meisten Fällen wird jede Formatierungsdefinition durch eine Reihe von XML-Tags beschrieben, die eine Ansicht beschreiben. Jede Ansicht enthält den Namen der Ansicht, die Objekte, die die Ansicht verwenden, und die Elemente der Ansicht, z. B. die Spalten- und Zeileninformationen für eine Tabellenansicht.

Die folgenden Ansichten sind verfügbar.

In der Tabellenansicht werden die Eigenschaften eines Objekts oder eines Skriptblockwerts in einer oder mehreren Spalten aufgelistet. Jede Spalte stellt eine Eigenschaft des Objekts oder eines Skriptblockwerts dar. Sie können eine Tabellenansicht definieren, die alle Eigenschaften eines Objekts, eine Teilmenge der Eigenschaften eines Objekts oder eine Kombination aus Eigenschaften und Skriptblockwerten anzeigt. Jede Zeile der Tabelle stellt ein zurückgegebenes Objekt dar. Weitere Informationen zu dieser Ansicht finden Sie unter Tabellenansicht.

Listenansicht Listet die Eigenschaften eines Objekts oder eines Skriptblockwerts in einer einzelnen Spalte auf. Jede Zeile der Liste zeigt eine optionale Beschriftung oder den Eigenschaftennamen gefolgt vom Wert der Eigenschaft oder des Skriptblocks an. Weitere Informationen zu dieser Ansicht finden Sie unter Listenansicht.

In der breiten Ansicht wird eine einzelne Eigenschaft eines Objekts oder eines Skriptblockwerts in einer oder mehreren Spalten aufgelistet. Für diese Ansicht gibt es keine Beschriftung oder Kopfzeile. Weitere Informationen zu dieser Ansicht finden Sie unter Wide View.

Benutzerdefinierte Ansicht zeigt eine anpassbare Ansicht von Objekteigenschaften oder Skriptblockwerten an, die nicht der starren Struktur von Tabellenansichten, Listenansichten oder breiten Ansichten entsprechen. Sie können eine eigenständige benutzerdefinierte Ansicht definieren oder eine benutzerdefinierte Ansicht definieren, die von einer anderen Ansicht verwendet wird, z. B. einer Tabellen- oder Listenansicht. Weitere Informationen zu dieser Ansicht finden Sie unter benutzerdefinierte Ansicht.

XML-Elemente anzeigen

Das folgende Beispiel zeigt die XML-Tags, mit denen eine Tabellenansicht definiert wird, die zwei Spalten enthält. Das ViewDefinitions--Element ist das Containerelement für alle Ansichten, die in der Formatierungsdatei definiert sind. Das View-Element definiert die spezifische Tabelle, Liste, breite oder benutzerdefinierte Ansicht. Innerhalb jeder Ansicht gibt das Name Element den Namen der Ansicht an, das ViewSelectedBy Element definiert die Objekte, die die Ansicht verwenden, und die verschiedenen Steuerelementelemente (z. B. das TableControl Element) definieren das Format der Ansicht.

ViewDefinitions
  <View>
    <Name>Name of View</Name>
    <ViewSelectedBy>
      <TypeName>Object to display using this view</TypeName>
      <TypeName>Object to display using this view</TypeName>
    </ViewSelectedBy>
    <TableControl>
      <TableHeaders>
        <TableColumnHeader>
          <Width></Width>
        </TableColumnHeader>
        <TableColumnHeader>
          <Width></Width>
        </TableColumnHeader>
      </TableHeaders>
      <TableRowEntries>
        <TableRowEntry>
          <TableColumnItems>
            <TableColumnItem>
              <PropertyName>Header for column 1</PropertyName>
            </TableColumnItem>
            <TableColumnItem>
              <PropertyName>Header for column 2</PropertyName>
            </TableColumnItem>
          </TableColumnItems>
        </TableRowEntry>
      </TableRowEntries>
    </TableControl)
  </View>
</ViewDefinitions>

Siehe auch

Tabellenansicht

Listenansicht

benutzerdefinierte Ansicht

Schreiben eines Windows PowerShell-Cmdlets