Sdílet prostřednictvím

Update-FormatData

  • Reference
Modul:
Microsoft.PowerShell.Utility

Aktualizuje formátovací data v aktuální relaci.

Syntaxe

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

Description

Rutina Update-FormatData znovu načte formátovací data z formátování souborů do aktuální relace. Tato rutina umožňuje aktualizovat formátovaná data bez restartování Windows PowerShellu.

Bez parametrů Update-FormatData znovu načte soubory formátování, které načetl dříve. K přidání nových souborů formátování do relace můžete použít parametry Update-FormatData.

Formátovací soubory jsou textové soubory ve formátu XML s příponou názvu souboru format.ps1xml. Formátovací data v souborech definují zobrazení objektů rozhraní Microsoft .NET Framework v relaci.

Při spuštění Windows PowerShellu načte data formátu ze souborů formátování v instalačním adresáři Windows PowerShellu ($pshome) do relace. Pomocí Update-FormatData můžete znovu načíst data formátování do aktuální relace bez restartování Windows PowerShellu. To je užitečné, když jste přidali nebo změnili formátovací soubor, ale nechcete přerušit relaci.

Další informace o formátování souborů ve Windows PowerShellu najdete v tématu about_Format.ps1xml.

Příklady

Příklad 1: Opětovné načtení dříve načtených formátových souborů

PS C:\> Update-FormatData

Tento příkaz znovu načte soubory formátování, které načetl dříve.

Příklad 2: Opětovné načtení souborů formátování a trasování a souborů formátování protokolu

PS C:\> Update-FormatData -AppendPath "trace.format.ps1xml, log.format.ps1xml"

Tento příkaz znovu načte soubory formátování do relace, včetně dvou nových souborů Trace.format.ps1xml a Log.format.ps1xml.

Protože příkaz používá parametr AppendPath, formátování dat v nových souborech se načte po formátování dat z předdefinovaných souborů.

Parametr AppendPath se používá, protože nové soubory obsahují formátovací data pro objekty, které nejsou odkazovány v předdefinovaných souborech.

Příklad 3: Úprava souboru formátování a jeho opětovné načtení

PS C:\> Update-FormatData -PrependPath "c:\test\NewFiles.format.ps1xml"

# Edit the NewFiles.format.ps1 file.

PS C:\> Update-FormatData

Tento příklad ukazuje, jak po úpravě znovu načíst formátovací soubor.

První příkaz přidá do relace soubor NewFiles.format.ps1xml. Používá parametr PrependPath, protože soubor obsahuje formátovací data pro objekty odkazované v předdefinovaných souborech.

Po přidání souboru NewFiles.format.ps1xml a jeho otestování v těchto relacích autor soubor upraví.

Druhý příkaz používá rutinu Update-FormatData k opětovnému načtení souborů formátování. Vzhledem k tomu, že soubor NewFiles.format.ps1xml byl dříve načten, Update-FormatData automaticky znovu načte bez použití parametrů.

Parametry

-AppendPath

Určuje formátovací soubory, které tato rutina přidá do relace. Soubory se načtou po načtení předdefinovaných souborů formátování v prostředí Windows PowerShell.

Při formátování objektů .NET používá Windows PowerShell první definici formátování, kterou najde pro každý typ .NET. Pokud použijete parametr AppendPath, Windows PowerShell před přidáním vyhledá data z předdefinovaných souborů.

Tento parametr použijte k přidání souboru, který formátuje objekt .NET, který není odkazován v předdefinovaných formátovacích souborech.

Typ:String[]
Aliasy:PSPath, Path
Position:0
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PrependPath

Určuje formátovací soubory, které tato rutina přidá do relace. Soubory se načtou před načtením předdefinovaných souborů formátování prostředí Windows PowerShell.

Při formátování objektů .NET používá Windows PowerShell první definici formátování, kterou najde pro každý typ .NET. Pokud použijete parametr PrependPath, Windows PowerShell vyhledá data ze souborů, které přidáváte, než narazí na formátovací data z předdefinovaných souborů.

Tento parametr použijte k přidání souboru, který formátuje objekt .NET, na který se odkazuje také v předdefinovaných formátovacích souborech.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

String

Řetězec, který obsahuje cestu k připojení Update-FormatData, můžete převést řetězec, který obsahuje cestu k připojení .

Výstupy

None

Rutina nevrací žádný výstup.

Poznámky

  • Update-FormatData také aktualizuje formátovací data pro příkazy v relaci importované z modulů. Pokud se formátovací soubor modulu změní, můžete spustit příkaz Update-FormatData a aktualizovat formátovací data pro importované příkazy. Modul nemusíte znovu importovat.