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 Cmdlet Update-FormatData 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 lädt Update-FormatData die zuvor geladenen Formatierungsdateien neu. Sie können die Parameter von Update-FormatData verwenden, um der Sitzung neue Formatierungsdateien hinzuzufügen.

Formatierungsdateien sind Textdateien im XML-Format mit der Dateinamenerweiterung format.ps1xml. 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 Update-FormatData verwenden, um die Formatierungsdaten in die aktuelle Sitzung neu zu laden, ohne PowerShell neu zu starten. Dies ist nützlich, wenn Sie eine Formatierungsdatei hinzugefügt oder geändert haben, die Sitzung jedoch 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 neu 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 in die Sitzung neu geladen, darunter zwei neue Dateien, Trace.format.ps1xml und Log.format.ps1xml.

Da der Befehl den parameter AppendPath 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 gezeigt, wie Sie eine Formatierungsdatei neu laden, nachdem Sie sie bearbeitet haben.

Der erste Befehl fügt der Sitzung die Datei NewFiles.format.ps1xml hinzu. 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 Cmdlet Update-FormatData, um die Formatierungsdateien neu zu laden. Da die Datei NewFiles.format.ps1xml zuvor geladen wurde, lädt Update-FormatData sie automatisch neu, 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 parameter "AppendPath" verwenden, durchsucht PowerShell die Daten aus den integrierten Dateien, bevor sie auf die formatierungsdaten trifft, die Sie hinzufügen.

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

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

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

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, um eine Datei hinzuzufügen, 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 passiert, 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 mit dem Anfügepfad an Update-FormatDataübergeben.

Ausgaben

None

Das 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.