Megosztás a következőn keresztül:

Update-FormatData

Modul:
Microsoft.PowerShell.Utility Module

Frissíti a formázási adatokat az aktuális munkamenetben.

Syntax

Default (Alapértelmezett) 

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

Description

A Update-FormatData parancsmag újra betölti a formázási adatokat a formázási fájlokból az aktuális munkamenetbe. Ez a parancsmag lehetővé teszi a formázási adatok frissítését a PowerShell újraindítása nélkül.

Paraméterek nélkül Update-FormatData újra betölti a korábban betöltött formázási fájlokat. A Update-FormatData paramétereit használva új formázási fájlokat adhat hozzá a munkamenethez.

A formázási fájlok xml formátumú, format.ps1xml fájlnévkiterjesztéssel rendelkező szövegfájlok. A fájlok formázási adatai határozzák meg a Microsoft .NET-keretrendszer objektumainak megjelenítését a munkamenetben.

Amikor a PowerShell elindul, betölti a formátumadatokat a PowerShell-forráskódból. Létrehozhat azonban egyéni format.ps1xml fájlokat az aktuális munkamenet formázásának frissítéséhez. A Update-FormatData használatával újra betöltheti a formázási adatokat az aktuális munkamenetbe a PowerShell újraindítása nélkül. Ez akkor hasznos, ha hozzáadott vagy módosított egy formázási fájlt, de nem szeretné megszakítani a munkamenetet.

A fájlok PowerShellben való formázásáról további információt a about_Format.ps1xmlcímű témakörben talál.

Példák

1. példa: Korábban betöltött formázási fájlok újratöltése

Update-FormatData

Ez a parancs újra betölti a korábban betöltött formázási fájlokat.

2. példa: Formázási fájlok újratöltése, és a nyomkövetési és naplózási formázási fájlok követése és naplózása.

Update-FormatData -AppendPath Trace.format.ps1xml, Log.format.ps1xml

Ez a parancs újra betölti a formázási fájlokat a munkamenetbe, beleértve két új fájlt, Trace.format.ps1xml és Log.format.ps1xml.

Mivel a parancs a AppendPath paramétert használja, az új fájlok formázási adatai a beépített fájlokból származó formázási adatok betöltése után töltődnek be.

A AppendPath paramétert azért használja a rendszer, mert az új fájlok formázási adatokat tartalmaznak a beépített fájlokban nem hivatkozott objektumokhoz.

3. példa: Formázási fájl szerkesztése és újratöltése

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

# Edit the NewFiles.format.ps1 file.

Update-FormatData

Ez a példa bemutatja, hogyan tölthető be újra egy formázási fájl a szerkesztés után.

Az első parancs hozzáadja a NewFiles.format.ps1xml fájlt a munkamenethez. A PrependPath paramétert használja, mivel a fájl formázási adatokat tartalmaz a beépített fájlokban hivatkozott objektumokhoz.

Miután hozzáadta a NewFiles.format.ps1xml fájlt, és tesztelte ezekben a munkamenetekben, a szerző szerkessze a fájlt.

A második parancs a Update-FormatData parancsmagot használja a formázási fájlok újratöltéséhez. Mivel a NewFiles.format.ps1xml fájl korábban betöltődött, Update-FormatData automatikusan újra betölti paraméterek használata nélkül.

Paraméterek

-AppendPath

Meghatározza azokat a formázási fájlokat, amelyeket ez a parancsmag a munkamenethez hozzáad. A fájlok a PowerShell beépített formázási fájljainak betöltése után töltődnek be.

A .NET-objektumok formázásakor a PowerShell az egyes .NET-típusokhoz talált első formázási definíciót használja. Ha a AppendPath paramétert használja, a PowerShell a beépített fájlokból keres adatokat, mielőtt azok a hozzáadott formázási adatokkal találkoznak.

Ezzel a paraméterrel olyan fájlt adhat hozzá, amely a beépített formázási fájlokban nem hivatkozott .NET-objektumot formáz.

Paramétertulajdonságok

Típus:

String[]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:PSPath, Útvonal

Paraméterkészletek

(All)
Position:0
Kötelező:False
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-Confirm

Megerősítést kér a parancsmag futtatása előtt.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:False
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:Cf

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-PrependPath

Meghatározza azokat a formázási fájlokat, amelyeket ez a parancsmag a munkamenethez hozzáad. A fájlok betöltése előtt a PowerShell betölti a beépített formázási fájlokat.

A .NET-objektumok formázásakor a PowerShell az egyes .NET-típusokhoz talált első formázási definíciót használja. Ha a PrependPath paramétert használja, a PowerShell a hozzáadott fájlokban keres adatokat, mielőtt azok a beépített fájlok formázási adataival találkoznak.

Ezzel a paraméterrel olyan fájlt adhat hozzá, amely a beépített formázási fájlokban is hivatkozott .NET-objektumot formáz.

Paramétertulajdonságok

Típus:

String[]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-WhatIf

Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:False
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:Wi

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

String

Ehhez a parancsmaghoz átirányíthat egy karakterláncot, amely tartalmazza a hozzáfűzendő elérési útvonalat.

Kimenetek

None

Ez a parancsmag nem ad vissza kimenetet.

Jegyzetek

  • Update-FormatData a modulokból importált munkamenet parancsainak formázási adatait is frissíti. Ha egy modul formázási fájlja megváltozik, futtathat egy Update-FormatData parancsot az importált parancsok formázási adatainak frissítéséhez. Nem kell újra importálnia a modult.