Export-FormatData

Uloží formátovací data z aktuální relace do souboru formátování.

Syntax

Export-FormatData
      -InputObject <ExtendedTypeDefinition[]>
      -Path <String>
      [-Force]
      [-NoClobber]
      [-IncludeScriptBlock]
      [<CommonParameters>]
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 je vrátí a uloží 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 formátovací soubory 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 pomocí rutiny Get-FormatData získá data formátu v relaci. Hodnota * (all) parametru TypeName nasměruje rutinu tak, aby získala všechna data v relaci.

Příkaz pomocí operátoru kanálu (|) odešle data formátu z Get-FormatData příkazu do Export-FormatData rutiny, která exportuje data formátu do souboru AllFormat.ps1.

Příkaz Export-FormatData používá parametr IncludeScriptBlock k zahrnutí bloků skriptů 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 pro typ HelpInfoShort do souboru Help.format.ps1xml.

První příkaz použije rutinu Get-FormatData k získání dat formátu pro typ HelpInfoShort a uloží je do $F proměnné.

Druhý příkaz použije parametr Export-FormatDataInputObject rutiny k zadání formátovaných dat uložených $F v proměnné. Používá také parametr IncludeScriptBlock k zahrnutí bloků skriptů 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 účinek vynechání parametru IncludeScriptBlock z Export-FormatData příkazu.

První příkaz použije rutinu Get-FormatData k získání dat formátu objektu System.Diagnostics.Process , který Get-Process rutina vrátí. Příkaz pomocí operátoru kanálu (|) odešle do rutiny formátovací data Export-FormatData , která je exportuje do souboru Process.format.ps1xml v aktuálním adresáři.

V tomto případě Export-FormatData příkaz 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 formátování dat pro procesní objekty v souboru Process.format.ps1xml je nalezeno před standardní formátování dat pro procesní objekty.

Třetí příkaz ukazuje účinky této změny. Příkaz pomocí rutiny Get-Process získá procesy, 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

Vynutí spuštění příkazu bez žádosti o potvrzení uživatele.

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

-IncludeScriptBlock

Určuje, jestli se bloky skriptu v datech formátu exportují.

Vzhledem k tomu, že bloky skriptů obsahují kód a dají se použít se zlými úmysly, ve výchozím nastavení se neexportují.

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

-InputObject

Určuje formát datových objektů, které se mají exportovat. Zadejte proměnnou obsahující objekty nebo příkaz, který získá objekty, například Get-FormatData příkaz. Objekty můžete také roušit z Get-FormatData do Export-FormatData.

Type:ExtendedTypeDefinition[]
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters: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é znaky nejsou interpretovány jako zástupné znaky. Pokud cesta obsahuje řídicí znaky, uzavřete ji do jednoduchých uvozovek. Jednoduché uvozovky říkají PowerShellu, aby neinterpretovat žádné znaky jako řídicí sekvence.

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

-NoClobber

Označuje, že rutina nepřepíše existující soubory. Ve výchozím nastavení přepíše soubory bez upozornění, Export-FormatData pokud soubor nemá atribut jen pro čtení.

Pokud chcete přímo Export-FormatData přepsat soubory jen pro čtení, použijte parametr Force .

Type:SwitchParameter
Aliases:NoOverwrite
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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ří se 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 přepíše soubor bez upozornění, pokud soubor nemá atribut jen pro čtení. Pokud chcete přepsat soubor jen pro čtení, použijte parametr Force . Chcete-li zabránit přepsání souborů, použijte parametr NoClobber .

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

Vstupy

ExtendedTypeDefinition

Objekty ExtendedTypeDefinition lze směrovat z Get-FormatData do Export-FormatData.

Výstupy

None

Export-FormatData nevrací žádné objekty. Vygeneruje soubor a uloží ho do zadané cesty.

Poznámky

  • Pokud chcete použít jakýkoli formátovací soubor, včetně exportovaného souboru formátování, musí zásady spouštění relace umožňovat spouštění skriptů a konfiguračních souborů. Další informace najdete v tématu about_Execution_Policies.