Export-FormatData

Az aktuális munkamenetben lévő formázási adatokat menti 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 a fájlok formázásához használt adatokat (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 a 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 fájlban talál.

Példák

1. példa: Munkamenet-formátum adatainak 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 parancsmagot használja a Get-FormatData munkamenet formátumadatainak lekéréséhez. A TypeName paraméter (mind) értéke * arra utasítja a parancsmagot, hogy lekérje a munkamenet összes adatát.

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

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 parancsmagot használja a Get-FormatDataHelpInfoShort típus formátumadatainak lekéréséhez, és menti azokat 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 parancsfájlblokk 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 való Export-FormatData kihagyásának hatását mutatja be.

Az első parancs a parancsmagot használja a Get-FormatDataSystem.Diagnostics.Process objektum formátumadatainak lekéréséhez, amelyet a Get-Process parancsmag ad vissza. A parancs 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 parancsmag használatával 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 parancsmag a Get-Process parancsmaggal lekéri a P-vel kezdődő nevű 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
Accept pipeline input:False
Accept wildcard characters:False

-IncludeScriptBlock

Azt jelzi, hogy a formátumadatokban lévő szkriptblokkok exportálva vannak-e.

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

Type:SwitchParameter
Position:Named
Default value:None
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 adhatja a célnak Export-FormatData.

Type:ExtendedTypeDefinition[]
Position:Named
Default value:None
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 felhasználva. A rendszer egyetlen karaktert sem értelmez helyettesítő karakterként. Ha az elérési út tartalmaz feloldó karaktereket, akkor azt szimpla idézőjelek közé kell tenni. Az egyszeres idézőjelek arra utasítják a PowerShellt, hogy ne értelmezze a karaktereket feloldósorozatként.

Type:String
Aliases:PSPath, LP
Position:Named
Default value:None
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 csak akkor írja felül a fájlokat figyelmeztetés nélkül, Export-FormatData ha a fájl írásvédett attribútummal rendelkezik.

Export-FormatData Az írásvédett fájlok felülírásához használja a Force paramétert.

Type:SwitchParameter
Aliases:NoOverwrite
Position:Named
Default value:None
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 egy format.ps1xml kiterjesztésű fájlnevet. Ha kihagyja az elérési utat, Export-FormatData létrehozza a fájlt az aktuális könyvtárban.

Ha a .ps1xml fájlnévkiterjesztésen kívül más kiterjesztést használ, a Update-FormatData parancsmag nem ismeri fel a fájlt.

Ha 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
Accept pipeline input:False
Accept wildcard characters:False

Bevitelek

ExtendedTypeDefinition

Az ExtendedTypeDefinition objektumokat Get-FormatData átadhatja a célnakExport-FormatData.

Kimenetek

None

Export-FormatData nem ad vissza objektumokat. 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 a konfigurációs fájlok futtatását. További információ: about_Execution_Policies.