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í .NET objektů 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.

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í .NET objektů 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.

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.