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 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.

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 PowerShell finns i about_Format.ps1xml.

Exempel

Exempel 1: Exportera sessionsformatdata

Get-FormatData -TypeName "*" -PowerShellVersion 5.1 | 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

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

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

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

Det andra kommandot använder parametern InputObject för 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

Get-FormatData -TypeName "System.Diagnostics.Process" -PowerShellVersion 5.1 | 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

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 Export-FormatData-kommandot 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 PowerShell inte tolkar några tecken som escape-sekvenser.

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

-NoClobber

Anger 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 att 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.