Update-FormatData
Aktualisiert die Formatierungsdaten in der aktuellen Sitzung.
Syntax
Default (Standard)
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 Windows PowerShell neu zu starten.
Ohne Parameter lädt Update-FormatData die Formatierungsdateien, die zuvor geladen wurden, 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.
Wenn Windows PowerShell gestartet wird, werden die Formatdaten aus den Formatierungsdateien im Windows PowerShell-Installationsverzeichnis ($pshome) in die Sitzung geladen. Sie können Update-FormatData verwenden, um die Formatierungsdaten erneut in die aktuelle Sitzung zu laden, ohne Windows 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 Windows PowerShell finden Sie unter about_Format.ps1xml.
Beispiele
Beispiel 1: Zuvor geladene Formatierungsdateien erneut laden
PS C:\> Update-FormatData
Mit diesem Befehl werden die zuvor geladenen Formatierungsdateien neu geladen.
Beispiel 2: Formatierungsdateien neu laden sowie Formatierungsdateien verfolgen und protokollieren
PS C:\> 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
PS C:\> Update-FormatData -PrependPath "c:\test\NewFiles.format.ps1xml"
# Edit the NewFiles.format.ps1 file.
PS C:\> 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.
Nach dem Hinzufügen und Testen der Datei „NewFiles.format.ps1xml“ in diesen Sitzungen bearbeitet der Autor die Datei.
Im zweiten Befehl wird das Cmdlet Update-FormatData verwendet, um die Formatierungsdateien neu zu laden. Da die Datei NewFiles.format.ps1xml zuvor geladen wurde, wird sie von Update-FormatData automatisch ohne Verwendung von Parametern neu geladen.
Parameter
-AppendPath
Gibt Formatierungsdateien an, die dieses Cmdlet der Sitzung hinzufügt. Die Dateien werden geladen, nachdem Windows PowerShell die integrierten Formatierungsdateien geladen hat.
Beim Formatieren von .NET-Objekten verwendet Windows PowerShell die erste Formatierungsdefinition, die für jeden .NET-Typ gefunden wird. Wenn Sie den parameter "AppendPath" verwenden, durchsucht Windows 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 Windows PowerShell die integrierten Formatierungsdateien lädt.
Beim Formatieren von .NET-Objekten verwendet Windows PowerShell die erste Formatierungsdefinition, die für jeden .NET-Typ gefunden wird. Wenn Sie den PrependPath Parameter verwenden, durchsucht Windows 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, die den Anfügepfad enthält, über die Pipeline 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 den Befehl Update-FormatData ausführen, um die Formatierungsdaten für importierte Befehle zu aktualisieren. Sie müssen das Modul nicht erneut importieren.