Dela via

Export-FormatData

  • Referens
Modul:
Microsoft.PowerShell.Utility

Sparar formatering av data från den aktuella sessionen i en formateringsfil.

Syntax

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

Description

Cmdleten Export-FormatData skapar Windows PowerShell-formateringsfiler (format.ps1xml) från formateringsobjekten i den aktuella sessionen. Det tar ExtendedTypeDefinition objekt som Get-FormatData returnerar och sparar dem i en fil i XML-format.

Windows PowerShell använder data i formateringsfiler (format.ps1xml) för att generera standardvisningen av Microsoft .NET Framework-objekt i sessionen. Du kan visa och redigera formateringsfilerna och använda cmdleten Update-FormatData för att lägga till formateringsdata i en session.

Mer information om hur du formaterar filer i Windows PowerShell finns i about_Format.ps1xml.

Exempel

Exempel 1: Exportera sessionsformatdata

PS C:\> Get-FormatData -TypeName "*" | Export-FormatData -Path "allformat.ps1xml" -IncludeScriptBlock

Det här kommandot exporterar alla formatdata i sessionen till filen AllFormat.ps1xml.

Kommandot använder cmdleten Get-FormatData för att hämta formatdata i sessionen. Ett värde på * (alla) för parametern TypeName dirigerar cmdleten till att hämta alla data i sessionen.

Kommandot använder en pipelineoperator (|) för att skicka formatdata från kommandot Get-FormatData till cmdleten Export-FormatData som exporterar formatdata till AllFormat.ps1-filen.

Kommandot Export-FormatData använder parametern IncludeScriptBlock för att inkludera skriptblock i formatdata i filen.

Exempel 2: Exportera formatdata för en typ

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

Dessa kommandon exporterar formatdata för typen HelpInfoShort till filen Help.format.ps1xml.

Det första kommandot använder cmdleten Get-FormatData för att hämta formatdata för typen HelpInfoShort och sparar dem i variabeln $F.

Det andra kommandot använder parametern InputObject i cmdleten Export-FormatData för att ange formatdata som sparats i variabeln $F. Den använder också parametern IncludeScriptBlock för att inkludera skriptblock i utdata.

Exempel 3: Exportera formatdata utan skriptblock

PS C:\> Get-FormatData -TypeName "System.Diagnostics.Process" | Export-FormatData -Path process.format.ps1xml
PS C:\> Update-FormatData -PrependPath ".\process.format.ps1xml"
PS C:\> 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

Det här exemplet visar effekten av att utelämna parametern IncludeScriptBlock från ett Export-FormatData-kommando.

Det första kommandot använder cmdleten Get-FormatData för att hämta formatdata för objektet System.Diagnostics.Process som cmdleten Get-Process returnerar. Kommandot använder en pipelineoperator (|) för att skicka formateringsdata till cmdleten Export-FormatData, som exporterar dem till filen Process.format.ps1xml i den aktuella katalogen.

I det här fallet använder kommandot Export-FormatData inte parametern IncludeScriptBlock.

Det andra kommandot använder cmdleten Update-FormatData för att lägga till filen Process.format.ps1xml i den aktuella sessionen. Kommandot använder parametern PrependPath för att säkerställa att formateringsdata för processobjekt i filen Process.format.ps1xml hittas före standardformateringsdata för processobjekt.

Det tredje kommandot visar effekterna av den här ändringen. Kommandot använder cmdleten Get-Process för att hämta processer som har namn som börjar med P. Utdata visar att egenskapsvärden som beräknas med hjälp av skriptblock saknas i visningen.

Parametrar

-Force

Tvingar kommandot att köras utan att be om användarbekräftelse.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-IncludeScriptBlock

Anger om skriptblock i formatet data exporteras.

Eftersom skriptblock innehåller kod och kan användas skadligt exporteras de inte som standard.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-InputObject

Anger vilket format dataobjekt som ska exporteras. Ange en variabel som innehåller objekten eller ett kommando som hämtar objekten, till exempel ett Get-FormatData kommando. Du kan också skicka objekt från Get-FormatData till Export-FormatData.

Typ:ExtendedTypeDefinition[]
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-LiteralPath

Anger en plats för utdatafilen. Till skillnad från parametern Path används värdet för LiteralPath precis som det skrivs. Inga tecken tolkas som jokertecken. Om sökvägen innehåller escape-tecken omger du den med enkla citattecken. Enkla citattecken gör att Windows PowerShell inte tolkar några tecken som escape-sekvenser.

Typ:String
Alias:PSPath
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-NoClobber

Inidicatesta att cmdleten inte skriver över befintliga filer. Som standard skriver Export-FormatData över filer utan varning såvida inte filen har det skrivskyddade attributet.

Om du vill dirigera Export-FormatData skriva över skrivskyddade filer använder du parametern Force.

Typ:SwitchParameter
Alias:NoOverwrite
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Path

Anger en plats för utdatafilen. Ange en sökväg (valfritt) och ett filnamn med filnamnstillägget format.ps1xml. Om du utelämnar sökvägen skapar Export-FormatData filen i den aktuella katalogen.

Om du använder ett annat filnamnstillägg än .ps1xml kommer cmdleten Update-FormatData inte att känna igen filen.

Om du anger en befintlig fil skriver Export-FormatData över filen utan varning, såvida inte filen har det skrivskyddade attributet. Om du vill skriva över en skrivskyddad fil använder du parametern Force. Om du vill förhindra att filer skrivs över använder du parametern NoClobber.

Typ:String
Alias:FilePath
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

ExtendedTypeDefinition

Du kan skicka ExtendedTypeDefinition objekt från Get-FormatData till Export-FormatData.

Utdata

None

Export-FormatData returnerar inga objekt. Den genererar en fil och sparar den i den angivna sökvägen.

Kommentarer

  • Om du vill använda valfri formateringsfil, inklusive en exporterad formateringsfil, måste körningsprincipen för sessionen tillåta att skript och konfigurationsfiler körs. Mer information finns i about_Execution_Policies.