Update-FormatData
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
lädt 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 format.ps1xml
Dateinamenerweiterung. Die Formatierungsdaten in den Dateien definieren die Anzeige von Microsoft .NET Framework-Objekten in der Sitzung.
Wenn PowerShell gestartet wird, 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 verwenden Update-FormatData
, 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 aber nicht unterbrechen möchten.
Weitere Informationen zum Formatieren von Dateien in PowerShell finden Sie unter about_Format.ps1xml.
Beispiele
Beispiel 1: Erneutes Laden von zuvor geladenen Formatierungsdateien
Update-FormatData
Mit diesem Befehl werden die zuvor geladenen Formatierungsdateien erneut geladen.
Beispiel 2: Erneutes Laden von Formatierungsdateien sowie 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 einer Formatierungsdatei
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 Die Datei NewFiles.format.ps1xml hinzugefügt und in diesen Sitzungen getestet wurde, bearbeitet der Autor die Datei.
Der zweite Befehl verwendet das Update-FormatData
Cmdlet, um die Formatierungsdateien erneut zu laden. Da die Datei NewFiles.format.ps1xml zuvor geladen wurde, lädt sie automatisch neu, 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 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 zum Hinzufügen einer Datei, die ein .NET-Objekt formatiert, auf das nicht in den integrierten Formatierungsdateien verwiesen wird.
Type: | String[] |
Aliases: | PSPath, Path |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 für jeden .NET-Typ gefunden wird. Wenn Sie den Parameter PrependPath 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.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Eingaben
Sie können eine Zeichenfolge, die den Anfügepfad enthält, an dieses Cmdlet übergeben.
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 einenUpdate-FormatData
Befehl ausführen, um die Formatierungsdaten für importierte Befehle zu aktualisieren. Sie müssen das Modul nicht erneut importieren.