Sdílet prostřednictvím

Update-FormatData

Modul:
Microsoft.PowerShell.Utility Module

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

Syntax

Default (Výchozí) 

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í Windows PowerShellu načte data formátu ze souborů formátování v instalačním adresáři PowerShellu ($PSHOME) do relace. 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 NewFiles.format.ps1xml soubor byl dříve načten, Update-FormatData ho 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á 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.

Vlastnosti parametru

Typ:

String[]

Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:PSPath, Cesta

Sady parametrů

(All)
Position:0
Povinné:False
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-Confirm

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

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False
Aliasy:viz

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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á 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.

Vlastnosti parametru

Typ:

String[]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-WhatIf

Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False
Aliasy:Wi

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

String

Řetězec, který obsahuje cestu k připojení k této rutině, můžete převést.

Výstupy

None

Tento cmdlet 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.