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. Parametry můžete použít Update-FormatData k přidání nových formátovaných souborů do relace.

Formátovací soubory jsou textové soubory ve formátu XML s příponou format.ps1xml názvu souboru. 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. Můžete použít Update-FormatData k opětovnému načtení formátových dat 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 pomocí rutiny Update-FormatData znovu načte soubory formátování. Protože byl dříve načten soubor NewFiles.format.ps1xml, Update-FormatData automaticky ho 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 formátovací data, 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 zobrazí výzvu 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

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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 aktualizuje také formátovací data pro příkazy v relaci, které byly importovány z modulů. Pokud se formátovací soubor modulu změní, můžete spustit Update-FormatData příkaz pro aktualizaci dat formátování pro importované příkazy. Modul nemusíte znovu importovat.