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

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. * Värdet (alla) för parametern TypeName dirigerar cmdleten för att hämta alla data i sessionen.

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

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"
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 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" | 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 det System.Diagnostics.Process-objekt som get-process-cmdleten 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 Export-FormatData använder 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 ut objekten 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

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

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

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 Export-FormatData skapar du 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 Export-FormatData skriver du över filen utan varning, såvida inte filen har det skrivskyddade attributet. Om du vill skriva över en skrivskyddad fil använder du force-parametern. 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 den här cmdleten.

Utdata

None

Den här cmdleten returnerar inga utdata. 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.