Export-FormatData
Uloží formátování dat z aktuální relace do souboru formátování.
Syntaxe
ByPath (Výchozí)
Export-FormatData
-InputObject <ExtendedTypeDefinition[]>
-Path <String>
[-Force]
[-NoClobber]
[-IncludeScriptBlock]
[<CommonParameters>]
ByLiteralPath
Export-FormatData
-InputObject <ExtendedTypeDefinition[]>
-LiteralPath <String>
[-Force]
[-NoClobber]
[-IncludeScriptBlock]
[<CommonParameters>]
Description
Rutina Export-FormatData vytvoří soubory formátování PowerShellu (format.ps1xml) z objektů formátování v aktuální relaci. Vezme ExtendedTypeDefinition objekty, které Get-FormatData vrátí a uloží je do souboru ve formátu XML.
PowerShell používá data ve formátovaných souborech (format.ps1xml) k vygenerování výchozího zobrazení objektů rozhraní Microsoft .NET Framework v relaci. Můžete zobrazit a upravit soubory formátování a pomocí rutiny Update-FormatData přidat data formátování do relace.
Další informace o formátování souborů v PowerShellu najdete v tématu about_Format.ps1xml.
Příklady
Příklad 1: Export dat formátu relace
Get-FormatData -TypeName "*" |
Export-FormatData -Path "AllFormat.ps1xml" -IncludeScriptBlock
Tento příkaz exportuje všechna formátová data v relaci do souboru AllFormat.ps1xml.
Příkaz používá rutinu Get-FormatData k získání dat formátu v relaci. Hodnota * (vše) pro parametr TypeName nasměruje rutinu tak, aby získala všechna data v relaci.
Příkaz používá operátor kanálu (|) k odeslání formátových dat z příkazu Get-FormatData do rutiny Export-FormatData, která exportuje data formátu do souboru AllFormat.ps1xml.
Příkaz Export-FormatData používá parametr IncludeScriptBlock k zahrnutí bloků skriptu do formátových dat v souboru.
Příklad 2: Export dat formátu pro typ
$F = Get-FormatData -TypeName "HelpInfoShort"
Export-FormatData -InputObject $F -Path "C:\test\Help.format.ps1xml" -IncludeScriptBlock
Tyto příkazy exportují data formátu HelpInfoShort typu do souboru Help.format.ps1xml.
První příkaz používá rutinu Get-FormatData k získání formátových dat pro HelpInfoShort typ a uloží je do proměnné $F.
Druhý příkaz používá parametr InputObject rutiny Export-FormatData k zadání formátovaných dat uložených v proměnné $F. Používá také parametr IncludeScriptBlock k zahrnutí bloků skriptu do výstupu.
Příklad 3: Export dat formátu bez bloku skriptu
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
Tento příklad ukazuje efekt vynechání parametru IncludeScriptBlock z příkazu Export-FormatData.
První příkaz pomocí rutiny Get-FormatData získá formátová data pro System.Diagnostics.Process objekt, který Get-Process rutina vrátí. Příkaz pomocí operátoru kanálu (|) odešle data formátování do rutiny Export-FormatData, která je exportuje do souboru Process.format.ps1xml v aktuálním adresáři.
V tomto případě příkaz Export-FormatData nepoužívá parametr IncludeScriptBlock.
Druhý příkaz použije rutinu Update-FormatData k přidání souboru Process.format.ps1xml do aktuální relace. Příkaz používá parametr PrependPath k zajištění, že se před standardním formátováním dat pro procesní objekty v souboru Process.format.ps1xml najde standardní formátovací data pro procesní objekty.
Třetí příkaz ukazuje účinky této změny. Příkaz používá rutinu Get-Process k získání procesů, které mají názvy začínající písmenem P. Výstup ukazuje, že v zobrazení chybí hodnoty vlastností vypočítané pomocí bloků skriptu.
Parametry
-Force
Přinutí příkaz ke spuštění bez výzvy k potvrzení uživatele.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-IncludeScriptBlock
Určuje, zda jsou bloky skriptu ve formátových datech exportovány.
Vzhledem k tomu, že bloky skriptu obsahují kód a dají se použít se zlými úmysly, ve výchozím nastavení se neexportují.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-InputObject
Určuje formát datových objektů, které se mají exportovat. Zadejte proměnnou obsahující objekty nebo příkaz, který objekty získá, například příkaz Get-FormatData. Objekty můžete také pipetovat z Get-FormatData do Export-FormatData.
Vlastnosti parametru
| Typ: | |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-LiteralPath
Určuje umístění výstupního souboru. Na rozdíl od parametru Path se hodnota LiteralPath používá přesně tak, jak je zadána. Žádný znak není interpretován jako zástupný znak. Pokud cesta obsahuje únikové znaky, uzavřete ji do jednoduchých uvozovek. Jednoduché uvozovky říkají PowerShellu, aby žádné znaky neinterpretoval jako únikové sekvence.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | PSPath, PO |
Sady parametrů
ByLiteralPath
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-NoClobber
Označuje, že rutina nepřepíše existující soubory. Ve výchozím nastavení Export-FormatData přepsat soubory bez upozornění, pokud soubor nemá atribut jen pro čtení.
Pokud chcete směrovat Export-FormatData k přepsání souborů jen pro čtení, použijte parametr Force.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | NoOverwrite |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Path
Určuje umístění výstupního souboru. Zadejte cestu (volitelné) a název souboru s příponou názvu souboru format.ps1xml. Pokud cestu vynecháte, Export-FormatData vytvoří soubor v aktuálním adresáři.
Pokud použijete jinou příponu názvu souboru než .ps1xml, rutina Update-FormatData soubor nerozpozná.
Pokud zadáte existující soubor, Export-FormatData soubor přepíše bez upozornění, pokud soubor nemá atribut jen pro čtení. K přepsání souboru jen pro čtení použijte parametr Force. Pokud chcete zabránit přepsání souborů, použijte parametr NoClobber.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | FilePath |
Sady parametrů
ByPath
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
Vstupy
ExtendedTypeDefinition
Do této rutiny můžete ExtendedTypeDefinition objekty z Get-FormatData.
Výstupy
None
Tento cmdlet nevrátí žádný výstup. Vygeneruje soubor a uloží ho do zadané cesty.
Poznámky
- Pokud chcete použít jakýkoli formátovací soubor, včetně exportovaného formátovacího souboru, musí zásady spouštění relace umožňovat spouštění skriptů a konfiguračních souborů. Další informace naleznete v části about_Execution_Policies.
