Freigeben über

Update-FormatData

Modul:
Microsoft.PowerShell.Utility Module

Aktualisiert die Formatierungsdaten in der aktuellen Sitzung.

Syntax

Default (Standardwert) 

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

Beschreibung

Das Cmdlet Update-FormatData lädt die Formatierungsdaten aus Formatierungsdateien erneut in die aktuelle Sitzung. 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 zu Formatierungsdateien in Windows 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: Formatierungsdateien neu laden sowie Formatierungsdateien verfolgen und protokollieren

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 AppendPath-Parameter verwendet, werden die Formatierungsdaten in die neuen Dateien nach den Formatierungsdaten in 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 NewFiles.format.ps1xml Datei 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 NewFiles.format.ps1xml Datei 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 NewFiles.format.ps1xml Datei 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.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:PSPath, Pfad

Parametersätze

(All)
Position:0
Obligatorisch.:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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 es auf die Formatierungsdaten aus den integrierten Dateien stößt.

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

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WhatIf

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

String

Sie können eine Zeichenfolge mit dem Anhängepfad (AppendPath) an dieses Cmdlet weiterreichen.

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.