Export-FormatData

  • Referencia
Modul:
Microsoft.PowerShell.Utility

Formázási adatokat ment az aktuális munkamenetből egy formázási fájlba.

Syntax

Export-FormatData
      -InputObject <ExtendedTypeDefinition[]>
      -Path <String>
      [-Force]
      [-NoClobber]
      [-IncludeScriptBlock]
      [<CommonParameters>]
Export-FormatData
      -InputObject <ExtendedTypeDefinition[]>
      -LiteralPath <String>
      [-Force]
      [-NoClobber]
      [-IncludeScriptBlock]
      [<CommonParameters>]

Description

A Export-FormatData parancsmag PowerShell-formázási fájlokat (format.ps1xml) hoz létre az aktuális munkamenet formázási objektumaiból. A visszaadott ExtendedTypeDefinition-objektumokat Get-FormatData xml formátumú fájlba menti.

A PowerShell az adatokat formázó fájlokban (format.ps1xml) használja a Microsoft .NET-keretrendszer objektumok alapértelmezett megjelenítésének létrehozásához a munkamenetben. Megtekintheti és szerkesztheti a formázási fájlokat, és az Update-FormatData parancsmaggal hozzáadhatja a formázási adatokat egy munkamenethez.

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: Munkamenet formátumadatainak exportálása

Get-FormatData -TypeName "*" | Export-FormatData -Path "allformat.ps1xml" -IncludeScriptBlock

Ez a parancs exportálja a munkamenet összes formátumadatát az AllFormat.ps1xml fájlba.

A parancs a Get-FormatData parancsmaggal lekéri a munkamenet formátumadatait. A TypeName paraméter (mind) értéke * arra utasítja a parancsmagot, hogy az összes adatot lekérje a munkamenetben.

A parancs folyamatkezelővel (|) küldi el a parancs formátumadatait Get-FormatData a Export-FormatData parancsmagnak, amely a formátumadatokat az AllFormat.ps1 fájlba exportálja.

A Export-FormatData parancs az IncludeScriptBlock paramétert használja a parancsfájlblokkok fájlformátum-adatokba való belefoglalásához.

2. példa: Formátumadatok exportálása típushoz

$F = Get-FormatData -TypeName "helpinfoshort"
Export-FormatData -InputObject $F -Path "c:\test\help.format.ps1xml" -IncludeScriptBlock

Ezek a parancsok a HelpInfoShort típus formátumadatait exportálják a Help.format.ps1xml fájlba.

Az első parancs a Get-FormatData parancsmaggal lekéri a HelpInfoShort típus formátumadatait , és menti őket a $F változóba.

A második parancs a parancsmag InputObject paraméterével Export-FormatData adja meg a változóban $F mentett formátumadatokat. Az IncludeScriptBlock paramétert is használja a szkriptblokkok kimenetbe való belefoglalásához.

3. példa: Formátumadatok exportálása szkriptblokk nélkül

Get-FormatData -TypeName "System.Diagnostics.Process" | Export-FormatData -Path process.format.ps1xml
Update-FormatData -PrependPath ".\process.format.ps1xml"
Get-Process p*

Handles  NPM(K)  PM(K)  WS(K) VM(M)   CPU(s)    Id ProcessName
-------  ------  -----  ----- -----   ------    -- -----------
323                                       5600 powershell
336                                       3900 powershell_ise
138                                       4076 PresentationFontCache

Ez a példa az IncludeScriptBlock paraméter parancsból Export-FormatData való kihagyásának hatását mutatja be.

Az első parancs a Get-FormatData parancsmagot használja a System.Diagnostics.Process objektum formátumadatainak lekéréséhez, amelyet a Get-Process parancsmag ad vissza. A parancs egy folyamatkezelővel (|) küldi el a formázási adatokat a Export-FormatData parancsmagnak, amely exportálja azokat az aktuális könyvtár Process.format.ps1xml fájljához.

Ebben az esetben a Export-FormatData parancs nem használja az IncludeScriptBlock paramétert .

A második parancs a Update-FormatData parancsmaggal adja hozzá a Process.format.ps1xml fájlt az aktuális munkamenethez. A parancs a PrependPath paraméter használatával biztosítja, hogy a Process.format.ps1xml fájlban lévő folyamatobjektumok formázási adatai a folyamatobjektumok szabványos formázási adatai előtt legyenek megtalálhatók.

A harmadik parancs a változás hatásait mutatja be. A parancs a parancsmaggal lekéri a Get-Process P kezdetű neveket tartalmazó folyamatokat. A kimenet azt mutatja, hogy a szkriptblokkok használatával kiszámított tulajdonságértékek hiányoznak a megjelenítésből.

Paraméterek

-Force

Kényszeríti a parancs futtatását anélkül, hogy felhasználói megerősítést kérne.

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

-IncludeScriptBlock

Azt jelzi, hogy a formátumadatok szkriptblokkjai exportálva vannak-e.

Mivel a szkriptblokkok kódokat tartalmaznak, és rosszindulatúan használhatók, alapértelmezés szerint nem exportálják őket.

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

-InputObject

Megadja az exportálandó adatobjektumok formátumát. Adjon meg egy változót, amely tartalmazza az objektumokat, vagy egy parancsot, amely lekéri az objektumokat, például egy parancsot Get-FormatData . Az objektumokat Get-FormatData át is csövezheti a célba Export-FormatData.

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

-LiteralPath

Megadja a kimeneti fájl helyét. Az Elérési út paramétertől eltérően a LiteralPath értéke pontosan a beírt módon lesz használva. A rendszer egyetlen karaktert sem értelmez helyettesítő karakterként. Ha az elérési út tartalmaz escape karaktereket, csatolja egy idézőjelek közé. Az idézőjelek azt mondják a PowerShellnek, hogy ne értelmezzen karaktereket feloldósorozatként.

Type:String
Aliases:PSPath, LP
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-NoClobber

Azt jelzi, hogy a parancsmag nem írja felül a meglévő fájlokat. Alapértelmezés szerint figyelmeztetés nélkül felülírja a fájlokat, Export-FormatData kivéve, ha a fájl írásvédett attribútummal rendelkezik.

Ha írásvédett Export-FormatData fájlokat szeretne felülírni, használja a Force paramétert.

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

-Path

Megadja a kimeneti fájl helyét. Adjon meg egy elérési utat (nem kötelező) és fájlnevet a format.ps1xml fájlnévkiterjesztéssel. Ha kihagyja az elérési utat, Export-FormatData hozza létre a fájlt az aktuális könyvtárban.

Ha nem .ps1xml fájlnévkiterjesztést használ, a Update-FormatData parancsmag nem ismeri fel a fájlt.

Ha egy meglévő fájlt ad meg, Export-FormatData figyelmeztetés nélkül írja felül a fájlt, kivéve, ha a fájl írásvédett attribútummal rendelkezik. Írásvédett fájl felülírásához használja a Force paramétert. A fájlok felülírásának megakadályozásához használja a NoClobber paramétert.

Type:String
Aliases:FilePath
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Bevitelek

ExtendedTypeDefinition

Az ExtendedTypeDefinition objektumokat Get-FormatData ebbe a parancsmagba csövezheti.

Kimenetek

None

Ez a parancsmag nem ad vissza kimenetet. Létrehoz egy fájlt, és menti a megadott elérési úton.

Jegyzetek

  • Ha bármilyen formázási fájlt szeretne használni, beleértve az exportált formázási fájlt is, a munkamenet végrehajtási szabályzatának engedélyeznie kell a szkriptek és konfigurációs fájlok futtatását. További információ: about_Execution_Policies.