Export-FormatData
Formázási adatokat ment az aktuális munkamenetből egy formázási fájlba.
Syntax
ByPath (Alapértelmezett)
Export-FormatData
-InputObject <ExtendedTypeDefinition[]>
-Path <String>
[-Force]
[-NoClobber]
[-IncludeScriptBlock]
[<CommonParameters>]
ByLiteralPath
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 ExtendedTypeDefinition olyan objektumokat használ, amelyeket Get-FormatData visszaad, és XML formátumban menti őket.
A PowerShell a fájlok formázási adatait (format.ps1xml) használja a Microsoft .NET-keretrendszer objektumainak alapértelmezett megjelenítéséhez 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.ps1xmlcí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 a AllFormat.ps1xml fájlba.
A parancs a Get-FormatData parancsmagot használja a munkamenet formátumadatainak lekéréséhez. A * paraméter (mind) értéke irányítja a parancsmagot a munkamenet összes adatának lekérésére.
A parancs egy folyamatkezelő (|) használatával küldi el a formátumadatokat a Get-FormatData parancsból a Export-FormatData parancsmagba, amely exportálja a formátumadatokat a AllFormat.ps1xml 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 exportálják a HelpInfoShort formátumadatait a Help.format.ps1xml fájlba.
Az első parancs a Get-FormatData parancsmagot használja a HelpInfoShort típus formátumadatainak lekéréséhez, és a $F változóba menti.
A második parancs a parancsmag Export-FormatData paraméterével adja meg a $F változóban mentett formátumadatokat. Emellett az IncludeScriptBlock paramétert 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 kihagyásának hatását mutatja be egy Export-FormatData parancsból.
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 visszaad. A parancs egy folyamatkezelő (|) használatával küldi el a formázási adatokat a Export-FormatData parancsmagba, 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étert használja annak biztosítására, 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 Get-Process parancsmaggal lekéri a 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.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| 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 |
-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.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| 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 |
-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 Get-FormatData parancsot. Az objektumokat az Get-FormatData és Export-FormatDataközött is becsúszthatja.
Paramétertulajdonságok
| Típus: | |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | True |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-LiteralPath
Megadja a kimeneti fájl helyét. A Path paramétertől eltérően a LiteralPath értéke pontosan a beíráskor lesz használva. A rendszer egyetlen karaktert sem értelmez helyettesítő karakterként. Ha az elérési útvonal escape karaktereket tartalmaz, tedd azt egyes idézőjelek közé. Az egyes idézőjelek azt mondják a PowerShellnek, hogy egyetlen karaktert se értelmezzen escape szekvenciaként.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | PSPath, LP |
Paraméterkészletek
ByLiteralPath
| Position: | Named |
| Kötelező: | True |
| 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 |
-NoClobber
Azt jelzi, hogy a parancsmag nem írja felül a meglévő fájlokat. Alapértelmezés szerint Export-FormatData figyelmeztetés nélkül felülírja a fájlokat, kivéve, ha a fájl írásvédett attribútummal rendelkezik.
Ha a Export-FormatData írásvédett fájlok felülírására szeretné irányítani, használja a Force paramétert.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | NoOverwrite |
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 |
-Path
Megadja a kimeneti fájl helyét. Adjon meg egy elérési utat (nem kötelező) és egy format.ps1xml fájlnévkiterjesztést tartalmazó fájlnevet. Ha kihagyja az elérési utat, Export-FormatData létrehozza a fájlt az aktuális könyvtárban.
Ha nem .ps1xmlfájlnévkiterjeszté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 felülírja a fájlt, kivéve, ha a fájl írásvédett attribútummal rendelkezik. Írásvédett fájlok 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.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | FilePath |
Paraméterkészletek
ByPath
| Position: | Named |
| Kötelező: | True |
| 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
ExtendedTypeDefinition
ExtendedTypeDefinition objektumokat a parancsmagba Get-FormatData.
Kimenetek
None
Ez a parancsmag nem ad vissza kimenetet. Létrehoz egy fájlt, és menti a megadott elérési úton.
