Freigeben über

Update-FormatData

  • Referenz
Modul:
Microsoft.PowerShell.Utility

Aktualisiert die Formatierungsdaten in der aktuellen Sitzung.

Syntax

Update-FormatData
      [[-AppendPath] <String[]>]
      [-PrependPath <String[]>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das Update-FormatData Cmdlet lädt die Formatierungsdaten aus Formatierungsdateien in die aktuelle Sitzung neu. Mit diesem Cmdlet können Sie die Formatierungsdaten aktualisieren, ohne PowerShell neu zu starten.

Ohne Parameter Update-FormatData laden Sie die zuvor geladenen Formatierungsdateien neu. Sie können die Parameter Update-FormatData verwenden, um der Sitzung neue Formatierungsdateien hinzuzufügen.

Formatierungsdateien sind Textdateien im XML-Format mit der format.ps1xml Dateinamenerweiterung. Die Formatierungsdaten in den Dateien definieren die Anzeige von Microsoft .NET Framework-Objekten in der Sitzung.

Beim Starten von PowerShell werden die Formatdaten aus dem PowerShell-Quellcode geladen. Sie können jedoch benutzerdefinierte Format.ps1xml-Dateien erstellen, um die Formatierung in der aktuellen Sitzung zu aktualisieren. Sie können die Formatierungsdaten in Update-FormatData die aktuelle Sitzung neu laden, ohne PowerShell neu zu starten. Dies ist nützlich, wenn Sie eine Formatierungsdatei hinzugefügt oder geändert haben, die Sitzung aber nicht unterbrechen möchten.

Weitere Informationen zum Formatieren von Dateien in PowerShell finden Sie unter about_Format.ps1xml.

Beispiele

Beispiel 1: Zuvor geladene Formatierungsdateien erneut laden

Update-FormatData

Mit diesem Befehl werden die zuvor geladenen Formatierungsdateien erneut geladen.

Beispiel 2: Erneutes Laden von Formatierungsdateien und Ablaufverfolgungs- und Protokollformatierungsdateien

Update-FormatData -AppendPath "trace.format.ps1xml, log.format.ps1xml"

Mit diesem Befehl werden die Formatierungsdateien erneut in die Sitzung geladen, einschließlich der zwei neuen Dateien „Trace.format.ps1xml“ und „Log.format.ps1xml“.

Da der Befehl den AppendPath-Parameter verwendet, werden die Formatierungsdaten in den neuen Dateien nach den Formatierungsdaten aus den integrierten Dateien geladen.

Der AppendPath-Parameter wird verwendet, da die neuen Dateien Formatierungsdaten für Objekte enthalten, auf die in den integrierten Dateien nicht verwiesen wird.

Beispiel 3: Bearbeiten einer Formatierungsdatei und erneutes Laden

Update-FormatData -PrependPath "c:\test\NewFiles.format.ps1xml"

# Edit the NewFiles.format.ps1 file.

Update-FormatData

In diesem Beispiel wird veranschaulicht, wie eine Formatierungsdatei nach dem Bearbeiten erneut geladen wird.

Mit dem ersten Befehl wird die Datei „NewFiles.format.ps1xml“ zur Sitzung hinzugefügt. Es verwendet den PrependPath-Parameter , da die Datei Formatierungsdaten für Objekte enthält, auf die in den integrierten Dateien verwiesen wird.

Nachdem Sie die Datei NewFiles.format.ps1xml hinzugefügt und in diesen Sitzungen getestet haben, bearbeitet der Autor die Datei.

Der zweite Befehl verwendet das Update-FormatData Cmdlet, um die Formatierungsdateien neu zu laden. Da die Datei NewFiles.format.ps1xml zuvor geladen wurde, wird sie automatisch neu geladen, Update-FormatData ohne Parameter zu verwenden.

Parameter

-AppendPath

Gibt Formatierungsdateien an, die dieses Cmdlet der Sitzung hinzufügt. Die Dateien werden geladen, nachdem PowerShell die integrierten Formatierungsdateien geladen hat.

Beim Formatieren von .NET-Objekten verwendet PowerShell die erste Formatierungsdefinition, die sie für jeden .NET-Typ findet. Wenn Sie den AppendPath-Parameter verwenden, durchsucht PowerShell die Daten aus den integrierten Dateien, bevor sie auf die Formatierungsdaten trifft, die Sie hinzufügen.

Verwenden Sie diesen Parameter zum Hinzufügen einer Datei, die ein .NET-Objekt formatiert, auf das nicht in den integrierten Formatierungsdateien verwiesen wird.

Typ:String[]
Aliase:PSPath, Path
Position:0
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PrependPath

Gibt Formatierungsdateien an, die dieses Cmdlet der Sitzung hinzufügt. Die Dateien werden geladen, bevor PowerShell die integrierten Formatierungsdateien lädt.

Beim Formatieren von .NET-Objekten verwendet PowerShell die erste Formatierungsdefinition, die sie für jeden .NET-Typ findet. Wenn Sie den PrependPath-Parameter verwenden, durchsucht PowerShell die Daten aus den Dateien, die Sie hinzufügen, bevor die Formatierungsdaten aus den integrierten Dateien gefunden werden.

Verwenden Sie diesen Parameter zum Hinzufügen einer Datei, die ein .NET-Objekt formatiert, auf das auch in den integrierten Formatierungsdateien verwiesen wird.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

String

Sie können eine Zeichenfolge weiterleiten, die den Anfügepfad zu diesem Cmdlet enthält.

Ausgaben

None

Dieses Cmdlet gibt keine Ausgabe zurück.

Hinweise

  • Update-FormatData aktualisiert auch die Formatierungsdaten für Befehle in der Sitzung, die aus Modulen importiert wurden. Wenn sich die Formatierungsdatei für ein Modul ändert, können Sie einen Update-FormatData Befehl ausführen, um die Formatierungsdaten für importierte Befehle zu aktualisieren. Sie müssen das Modul nicht erneut importieren.