Informationen zu Format.ps1xml
Kurze Beschreibung
Ab PowerShell 6 werden die Standardansichten für Objekte im PowerShell-Quellcode definiert.
Sie können eigene Format.ps1xml Dateien erstellen, um die Anzeige von Objekten zu ändern oder Standardanzeigen für neue Objekttypen zu definieren, die Sie in PowerShell erstellen.
Lange Beschreibung
Ab PowerShell 6 werden die Standardansichten im PowerShell-Quellcode definiert. Die Format.ps1xml Dateien aus PowerShell 5.1 und früheren Versionen sind in PowerShell 6 und höher nicht vorhanden.
Der PowerShell-Quellcode definiert die Standardanzeige von Objekten in der PowerShell-Konsole. Sie können eigene Format.ps1xml Dateien erstellen, um die Anzeige von Objekten zu ändern oder Standardanzeigen für neue Objekttypen zu definieren, die Sie in PowerShell erstellen.
Wenn PowerShell ein Objekt anzeigt, werden die Daten in strukturierten Formatierungsdateien verwendet, um die Standardanzeige des Objekts zu ermitteln. Die Daten in den Formatierungsdateien bestimmen, ob das Objekt in einer Tabelle oder in einer Liste gerendert wird und bestimmt, welche Eigenschaften standardmäßig angezeigt werden.
Die Formatierung wirkt sich nur auf die Anzeige aus. Es wirkt sich nicht darauf aus, welche Objekteigenschaften an die Pipeline übergeben werden oder wie sie übergeben werden. Format.ps1xml Dateien können nicht verwendet werden, um das Ausgabeformat für Hashtabellen anzupassen.
Eine .ps1xml Formatierungsdatei kann vier verschiedene Ansichten jedes Objekts definieren:
- Tabelle
- Liste
- Breite
- Benutzerdefiniert
Wenn beispielsweise die Ausgabe eines Get-ChildItem Befehls an einen Format-List Befehl weitergeleitet wird, verwendet die im Quellcode definierte Listenansicht, Format-List um zu bestimmen, wie die Datei- und Ordnerobjekte als Liste angezeigt werden.
Wenn eine Formatierungsdatei mehrere Ansichten eines Objekts enthält, wendet PowerShell die erste Gefundene Ansicht an.
In einer benutzerdefinierten Format.ps1xml Datei wird eine Ansicht durch eine Reihe von XML-Tags definiert, die den Namen der Ansicht beschreiben, den Typ des Objekts, auf das sie angewendet werden kann, die Spaltenüberschriften und die Eigenschaften, die im Textkörper der Ansicht angezeigt werden. Das Format in Format.ps1xml Dateien wird direkt vor der Darstellung der Daten für den Benutzer angewendet.
Erstellen neuer Format.ps1xml-Dateien
Wenn Sie das Anzeigeformat einer vorhandenen Objektansicht ändern oder Ansichten für neue Objekte hinzufügen möchten, erstellen Sie eigene Format.ps1xml Dateien, und fügen Sie sie ihrer PowerShell-Sitzung hinzu.
Verwenden Sie zum Erstellen einer Datei zum Definieren einer Format.ps1xml benutzerdefinierten Ansicht die Cmdlets "Get-FormatData " und " Export-FormatData ". Verwenden Sie einen Text-Editor, um die Datei zu bearbeiten. Die Datei kann in einem beliebigen Verzeichnis gespeichert werden, auf das PowerShell zugreifen kann, z. B. ein Unterverzeichnis von $HOME.
Um die Formatierung einer aktuellen Ansicht zu ändern, suchen Sie die Ansicht in der Formatierungsdatei, und verwenden Sie dann die Tags, um die Ansicht zu ändern. Wenn Sie eine Ansicht für einen neuen Objekttyp erstellen möchten, erstellen Sie eine neue Ansicht, oder verwenden Sie eine vorhandene Ansicht als Modell. Die Tags werden im nächsten Abschnitt beschrieben. Anschließend können Sie alle anderen Ansichten in der Datei löschen, sodass die Änderungen für alle Personen, die die Datei untersuchen, offensichtlich sind.
Nachdem Sie die Änderungen gespeichert haben, verwenden Sie die Update-FormatData , um die neue Datei zu Ihrer PowerShell-Sitzung hinzuzufügen. Wenn Ihre Ansicht Vorrang vor einer in den integrierten Dateien definierten Ansicht haben soll, verwenden Sie den Parameter PrependPath . Update-FormatData betrifft nur die aktuelle Sitzung. Um die Änderung an allen zukünftigen Sitzungen vorzunehmen, fügen Sie den Update-FormatData Befehl zu Ihrem PowerShell-Profil hinzu.
Beispiel: Hinzufügen von Kalenderdaten zu Kulturobjekten
In diesem Beispiel wird gezeigt, wie Sie die Formatierung der Kulturobjekte System.Globalization.CultureInfo ändern, die vom Get-Culture Cmdlet in der aktuellen PowerShell-Sitzung generiert wurden. Die Befehle im Beispiel fügen die Calendar-Eigenschaft der Standardtabellenansicht der Kulturobjekte hinzu.
Rufen Sie zunächst die Formatdaten aus der Quellcodedatei ab, und erstellen Sie eine Format.ps1xml Datei, die die aktuelle Ansicht der Kulturobjekte enthält.
Get-FormatData -TypeName System.Globalization.CultureInfo |
Export-FormatData -Path $HOME\Format\CultureInfo.Format.ps1xml
Öffnen Sie die CultureInfo.Format.ps1xml Datei in einem beliebigen XML- oder Text-Editor, z. B. Visual Studio Code. Im folgenden XML werden die Ansichten des CultureInfo-Objekts definiert.
Die CultureInfo.Format.ps1xml Datei sollte wie im folgenden Beispiel aussehen:
<?xml version="1.0" encoding="utf-8"?>
<Configuration>
<ViewDefinitions>
<View>
<Name>System.Globalization.CultureInfo</Name>
<ViewSelectedBy>
<TypeName>System.Globalization.CultureInfo</TypeName>
</ViewSelectedBy>
<TableControl>
<TableHeaders>
<TableColumnHeader>
<Width>16</Width>
</TableColumnHeader>
<TableColumnHeader>
<Width>16</Width>
</TableColumnHeader>
<TableColumnHeader />
</TableHeaders>
<TableRowEntries>
<TableRowEntry>
<TableColumnItems>
<TableColumnItem>
<PropertyName>LCID</PropertyName>
</TableColumnItem>
<TableColumnItem>
<PropertyName>Name</PropertyName>
</TableColumnItem>
<TableColumnItem>
<PropertyName>DisplayName</PropertyName>
</TableColumnItem>
</TableColumnItems>
</TableRowEntry>
</TableRowEntries>
</TableControl>
</View>
</ViewDefinitions>
</Configuration>
Erstellen Sie eine neue Spalte für die Calendar-Eigenschaft , indem Sie einen neuen Satz von <TableColumnHeader> Tags hinzufügen. Der Wert der Calendar-Eigenschaft kann lang sein. Geben Sie also einen Wert von 45 Zeichen als die <Width>.
<TableHeaders>
<TableColumnHeader>
<Width>16</Width>
</TableColumnHeader>
<TableColumnHeader>
<Width>16</Width>
</TableColumnHeader>
<TableColumnHeader>
<Width>45</Width>
</TableColumnHeader>
<TableColumnHeader/>
</TableHeaders>
Fügen Sie ein neues Spaltenelement für Kalender in den Tabellenzeilen mithilfe der <TableColumnItem> folgenden Tags <PropertyName hinzu:
<TableRowEntries>
<TableRowEntry>
<TableColumnItems>
<TableColumnItem>
<PropertyName>LCID</PropertyName>
</TableColumnItem>
<TableColumnItem>
<PropertyName>Name</PropertyName>
</TableColumnItem>
<TableColumnItem>
<PropertyName>Calendar</PropertyName>
</TableColumnItem>
<TableColumnItem>
<PropertyName>DisplayName</PropertyName>
</TableColumnItem>
</TableColumnItems>
</TableRowEntry>
</TableRowEntries>
Speichern und schließen Sie die Datei. Verwenden Sie Update-FormatData zum Hinzufügen der neuen Formatdatei zur aktuellen PowerShell-Sitzung.
In diesem Beispiel wird der PrependPath-Parameter verwendet, um die neue Datei in einer höheren Rangfolge als die ursprüngliche Datei zu platzieren. Weitere Informationen finden Sie unter Update-FormatData.
Update-FormatData -PrependPath $HOME\Format\CultureInfo.Format.ps1xml
Um die Änderung zu testen, geben Sie Get-Culture die Ausgabe ein, die die Calendar-Eigenschaft enthält.
Get-Culture
LCID Name Calendar DisplayName
---- ---- -------- -----------
1033 en-US System.Globalization.GregorianCalendar English (United States)
Die XML-Datei in Format.ps1xml-Dateien
Die vollständige Schemadefinition finden Sie in Format.xsd im PowerShell-Quellcode-Repository auf GitHub.
Der Abschnitt "ViewDefinitions" jeder Format.ps1xml Datei enthält die <View> Tags, die jede Ansicht definieren. Ein typisches <View> Tag enthält die folgenden Tags:
<Name>gibt den Namen der Ansicht an.<ViewSelectedBy>Gibt den Objekttyp oder die Typen an, für den die Ansicht gilt.<GroupBy>Gibt an, wie Elemente in der Ansicht in Gruppen kombiniert werden.<TableControl>,<ListControl><WideControl>, und<CustomControl>enthalten Sie die Tags, die angeben, wie jedes Element angezeigt wird.
ViewSelectedBy-Tag
Das <ViewSelectedBy> Tag kann ein <TypeName> Tag für jeden Objekttyp enthalten, auf den die Ansicht angewendet wird. Oder es kann ein Tag enthalten, das auf einen <SelectionSetName> Auswahlsatz verweist, der mit einem <SelectionSet> Tag an anderer Stelle definiert wird.
GroupBy-Tag
Das <GroupBy> Tag enthält ein <PropertyName> Tag, das die Objekteigenschaft angibt, nach der Elemente gruppiert werden sollen. Es enthält auch ein Tag, das eine <Label> Zeichenfolge angibt, die als Bezeichnung für jede Gruppe oder ein <CustomControlName> Tag verwendet werden soll, das auf ein benutzerdefiniertes Steuerelement verweist, das an anderer Stelle mithilfe eines <Control> Tags definiert ist. Das <Control> Tag enthält ein <Name> Tag und ein <CustomControl> Tag.
TableControlTag
Das <TableControl> Tag enthält <TableHeaders> normalerweise und <TableRowEntries> Tags, die die Formatierung für die Kopf- und Zeilen der Tabelle definieren. Das Tag enthält in der <TableHeaders> Regel Tags, die Tags enthalten <TableColumnHeader><Label>, <Width>und <Alignment> Tags. Das <TableRowEntries> Tag enthält <TableRowEntry> Tags für jede Zeile in der Tabelle. Das <TableRowEntry> Tag enthält ein <TableColumnItems> Tag, das ein <TableColumnItem> Tag für jede Spalte in der Zeile enthält. In der Regel enthält das <TableColumnItem> Tag entweder ein <PropertyName> Tag, das die Objekteigenschaft identifiziert, die an der definierten Position angezeigt werden soll, oder ein <ScriptBlock> Tag, das Skriptcode enthält, der ein Ergebnis berechnet, das an der Position angezeigt werden soll.
Hinweis
Skriptblöcke können auch an anderen Stellen verwendet werden, an denen berechnete Ergebnisse nützlich sein können.
Das <TableColumnItem> Tag kann auch ein <FormatString> Tag enthalten, das angibt, wie die Eigenschaft oder die berechneten Ergebnisse angezeigt werden.
ListControl-Tag
Das Tag enthält in der <ListControl> Regel ein <ListEntries> Tag. Das <ListEntries> Tag enthält ein <ListEntry> Tag. Das <ListEntry> Tag enthält ein <ListItems> Tag. Das <ListItems> Tag enthält Tags, die Tags enthalten <ListItem><PropertyName> . Die <PropertyName> Tags geben die Objekteigenschaft an, die an der angegebenen Position in der Liste angezeigt werden soll. Wenn die Ansichtsauswahl mithilfe eines Auswahlsatzes definiert ist, können die <ListControl> und <ListEntry> die Tags auch ein <EntrySelectedBy> Tag enthalten, das mindestens eine <TypeName> Markierung enthält. Diese <TypeName> Tags geben den Objekttyp an, den das <ListControl> Tag anzeigen soll.
WideControl-Tag
Das Tag enthält in der <WideControl> Regel ein <WideEntries> Tag. Das <WideEntries> Tag enthält eine oder mehrere <WideEntry> Tags. Ein <WideEntry> Tag enthält in der Regel ein <PropertyName> Tag, das die Eigenschaft angibt, die an der angegebenen Position in der Ansicht angezeigt werden soll. Das <PropertyName> Tag kann ein <FormatString> Tag enthalten, das angibt, wie die Eigenschaft angezeigt werden soll.
CustomControl-Tag
Mit dem <CustomControl> Tag können Sie einen Skriptblock verwenden, um ein Format zu definieren. Ein <CustomControl> Tag enthält in der Regel ein <CustomEntries> Tag, das mehrere <CustomEntry> Tags enthält. Jedes <CustomEntry> Tag enthält ein <CustomItem> Tag, das eine Vielzahl von Tags enthalten kann, die Inhalte und Formatierungen der angegebenen Position in der Ansicht angeben, einschließlich <Text>, <Indentation>, <ExpressionBinding>und <NewLine> Tags.
Ablaufverfolgungsformat.ps1xml-Datei verwenden
Um Fehler beim Laden oder Der Anwendung von Format.ps1xml Dateien zu erkennen, verwenden Sie das Trace-Command Cmdlet mit einer der folgenden Formatkomponenten als Wert des Namensparameters :
- FormatFileLoading
- FormatViewBinding
Weitere Informationen finden Sie unter Trace-Command und Get-TraceSource.
Signieren einer Format.ps1xml-Datei
Um die Benutzer Ihrer Format.ps1xml Datei zu schützen, signieren Sie die Datei mit einer digitalen Signatur. Weitere Informationen finden Sie unter about_Signing.
Beispiel-XML für eine Format-Table benutzerdefinierte Ansicht
Im folgenden XML-Beispiel wird eine Format-Table benutzerdefinierte Ansicht für die von Get-ChildItemSystem.IO.DirectoryInfo und System.IO.FileInfo erstellten Objekte erstellt. Die benutzerdefinierte Ansicht heißt "mygciview " und fügt der Tabelle die Spalte "CreationTime " hinzu.
Zum Erstellen der benutzerdefinierten Ansicht verwenden Sie die Get-FormatData und Export-FormatData cmdlets, um eine .ps1xml Datei zu generieren. Bearbeiten Sie dann Ihre .ps1xml Datei, um den Code für die benutzerdefinierte Ansicht zu erstellen. Die .ps1xml Datei kann in einem beliebigen Verzeichnis gespeichert werden, auf das PowerShell zugreifen kann. Beispiel: Ein Unterverzeichnis von $HOME.
Nachdem die .ps1xml Datei erstellt wurde, verwenden Sie das Update-FormatData Cmdlet, um die Ansicht in die aktuelle PowerShell-Sitzung einzuschließen. Oder fügen Sie den Updatebefehl zu Ihrem PowerShell-Profil hinzu, wenn Die Ansicht in allen PowerShell-Sitzungen verfügbar ist.
In diesem Beispiel muss die benutzerdefinierte Ansicht das Tabellenformat verwenden, andernfalls Format-Table tritt ein Fehler auf.
Verwenden Sie Format-Table den View-Parameter , um den Namen der benutzerdefinierten Ansicht, mygciview anzugeben und die Ausgabe der Tabelle mit der Spalte "CreationTime " zu formatieren. Ein Beispiel für die Ausführung des Befehls finden Sie unter "Format-Table".
Hinweis
Obwohl Sie die Formatierungs-XML aus dem Quellcode abrufen können, um eine benutzerdefinierte Ansicht zu erstellen, ist möglicherweise eine weitere Entwicklung erforderlich, um das gewünschte Ergebnis zu erhalten.
Im folgenden Get-FormatData Befehl gibt es eine Alternative für den PowerShellVersion-Parameter , um sicherzustellen, dass alle lokalen Formatierungsinformationen zurückgegeben werden. Verwenden Sie -PowerShellVersion $PSVersionTable.PSVersion anstelle einer bestimmten PowerShell-Version.
Get-FormatData -PowerShellVersion 5.1 -TypeName System.IO.DirectoryInfo |
Export-FormatData -Path ./Mygciview.Format.ps1xml
Update-FormatData -AppendPath ./Mygciview.Format.ps1xml
<?xml version="1.0" encoding="utf-8"?>
<Configuration>
<ViewDefinitions>
<View>
<Name>mygciview</Name>
<ViewSelectedBy>
<TypeName>System.IO.DirectoryInfo</TypeName>
<TypeName>System.IO.FileInfo</TypeName>
</ViewSelectedBy>
<GroupBy>
<PropertyName>PSParentPath</PropertyName>
</GroupBy>
<TableControl>
<TableHeaders>
<TableColumnHeader>
<Label>Mode</Label>
<Width>7</Width>
<Alignment>Left</Alignment>
</TableColumnHeader>
<TableColumnHeader>
<Label>LastWriteTime</Label>
<Width>26</Width>
<Alignment>Right</Alignment>
</TableColumnHeader>
<TableColumnHeader>
<Label>CreationTime</Label>
<Width>26</Width>
<Alignment>Right</Alignment>
</TableColumnHeader>
<TableColumnHeader>
<Label>Length</Label>
<Width>14</Width>
<Alignment>Right</Alignment>
</TableColumnHeader>
<TableColumnHeader>
<Label>Name</Label>
<Alignment>Left</Alignment>
</TableColumnHeader>
</TableHeaders>
<TableRowEntries>
<TableRowEntry>
<Wrap />
<TableColumnItems>
<TableColumnItem>
<PropertyName>ModeWithoutHardLink</PropertyName>
</TableColumnItem>
<TableColumnItem>
<PropertyName>LastWriteTime</PropertyName>
</TableColumnItem>
<TableColumnItem>
<PropertyName>CreationTime</PropertyName>
</TableColumnItem>
<TableColumnItem>
<PropertyName>Length</PropertyName>
</TableColumnItem>
<TableColumnItem>
<PropertyName>Name</PropertyName>
</TableColumnItem>
</TableColumnItems>
</TableRowEntry>
</TableRowEntries>
</TableControl>
</View>
</ViewDefinitions>
</Configuration>