Update-FormatData
Aktualisiert die Formatierungsdaten in der aktuellen Sitzung.
Syntax
Default (Standard)
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 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: 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, einschließlich zwei neuer 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 gezeigt, wie Sie eine Formatierungsdatei neu laden, nachdem Sie sie bearbeitet haben.
Der erste Befehl fügt die NewFiles.format.ps1xml Datei der Sitzung 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 Update-FormatData Cmdlet, um die Formatierungsdateien neu zu laden. Da die NewFiles.format.ps1xml Datei 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 .NET Objekte verwendet PowerShell die erste Formatierungsdefinition, die für jeden .NET Typ gefunden wird. 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, 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: | Cf |
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 .NET Objekte verwendet PowerShell die erste Formatierungsdefinition, die für jeden .NET Typ gefunden wird. 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.
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 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.
Warning
Eingeschränkte Endpunkte, z. B. JEA, dürfen den Update-FormatData Befehl nicht verfügbar machen. Mit diesem Befehl können Sie scriptBlock-Elemente zur Formatierung für einen Typ hinzufügen.
Der ScriptBlock kann im FullLanguage Modus ausgewertet werden, auch wenn die Sitzung so konfiguriert ist, dass ein restriktiverer Sprachmodus verwendet wird.
