Update-FormatData

  • Referencia
Modul:
Microsoft.PowerShell.Utility

Frissítések az aktuális munkamenetben lévő formázási adatokat.

Syntax

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

Description

A Update-FormatData parancsmag újra betölti a formázási adatokat a fájlok formázásábó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 Update-FormatData nélkül újra betölti a korábban betöltött formázási fájlokat. A paraméterekkel új formázási Update-FormatData fájlokat adhat hozzá a munkamenethez.

A formázási fájlok a fájlnévkiterjesztéssel xml format.ps1xml formátumú szövegfájlok. A fájlok formázási adatai határozzák meg a Microsoft .NET-keretrendszer objektumok 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 formázási adatok a PowerShell újraindítása nélkül is betölthetők Update-FormatData az aktuális munkamenetbe. 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.ps1xml cí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: Fájlok és nyomkövetési és naplóformázási fájlok újrabetöltése

Update-FormatData -AppendPath "trace.format.ps1xml, log.format.ps1xml"

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

Mivel a parancs az 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.

Az AppendPath paraméter azért használatos, 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, mert a fájl formázási adatokat tartalmaz a beépített fájlokban hivatkozott objektumokhoz.

A NewFiles.format.ps1xml fájl hozzáadása és tesztelése után a szerző szerkessze a fájlt.

A második parancs a Update-FormatData parancsmaggal újra betölti a formázási fájlokat. 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

Megadja a parancsmag által a munkamenethez hozzáadott formázási fájlokat. 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 az 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.

Type:String[]
Aliases:PSPath, Path
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PrependPath

Megadja a parancsmag által a munkamenethez hozzáadott formázási fájlokat. 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 megkeresi a hozzáadott fájlok adatait, mielőtt azok a beépített fájlokból származó 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 is hivatkozott .NET-objektumot formáz.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Bevitelek

String

A parancsmag hozzáfűző elérési útját tartalmazó sztringet csövezhet.

Kimenetek

None

Ez a parancsmag nem ad vissza kimenetet.

Jegyzetek

  • Update-FormatData emellett frissíti a modulokból importált munkamenet parancsainak formázási adatait is. 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.