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í PowerShellu.

Bez parametrů Update-FormatData znovu načte formátovací soubory, které načetl dříve. Pomocí parametrů Update-FormatData můžete do relace přidat nové formátovací soubory.

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í PowerShellu načte formátová data ze zdrojového kódu PowerShellu. Můžete ale vytvořit vlastní soubory format.ps1xml pro aktualizaci formátování v aktuální relaci. Pomocí Update-FormatData můžete znovu načíst formátovaná data do aktuální relace bez restartování 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ů v 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ů

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

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í

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

# Edit the NewFiles.format.ps1 file.

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 byl dříve načten soubor NewFiles.format.ps1xml, Update-FormatData jej 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 PowerShellu.

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

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í v PowerShellu.

Při formátování objektů .NET používá PowerShell první definici formátování, kterou najde pro každý typ .NET. Pokud použijete parametr PrependPath, 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í k této rutině, můžete převést.

Výstupy

None

Tato rutina nevrátí žá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, který aktualizuje formátovací data pro importované příkazy. Modul nemusíte znovu importovat.