Condividi tramite

Export-FormatData

  • Riferimento
Modulo:
Microsoft.PowerShell.Utility

Salva i dati di formattazione della sessione corrente in un file di formattazione.

Sintassi

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

Descrizione

Il Export-FormatData cmdlet crea file di formattazione di PowerShell (format.ps1xml) dagli oggetti di formattazione nella sessione corrente. Accetta gli oggetti ExtendedTypeDefinition che Get-FormatData li restituiscono e li salvano in un file in formato XML.

PowerShell usa i dati nei file di formattazione (format.ps1xml) per generare la visualizzazione predefinita degli oggetti Microsoft .NET Framework nella sessione. È possibile visualizzare e modificare i file di formattazione e usare il cmdlet Update-FormatData per aggiungere i dati di formattazione a una sessione.

Per altre informazioni sulla formattazione dei file in PowerShell, vedere about_Format.ps1xml.

Esempio

Esempio 1: Esportare i dati del formato sessione

Get-FormatData -TypeName "*" | Export-FormatData -Path "allformat.ps1xml" -IncludeScriptBlock

Questo comando esporta tutti i dati di formattazione della sessione nel file AllFormat.ps1xml.

Il comando usa il Get-FormatData cmdlet per ottenere i dati di formato nella sessione. Un valore di * (tutti) per il parametro TypeName indirizza il cmdlet per ottenere tutti i dati nella sessione.

Il comando usa un operatore della pipeline (|) per inviare i dati di formato dal Get-FormatData comando al Export-FormatData cmdlet, che esporta i dati di formato nel file AllFormat.ps1.

Il Export-FormatData comando usa il parametro IncludeScriptBlock per includere blocchi di script nel formato dei dati nel file.

Esempio 2: Esportare i dati di formato per un tipo

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

Questi comandi esportano i dati di formato per il tipo HelpInfoShort nel file Help.format.ps1xml.

Il primo comando usa il Get-FormatData cmdlet per ottenere i dati di formato per il tipo HelpInfoShort e lo salva nella $F variabile.

Il secondo comando usa il parametro InputObject del cmdlet per immettere i dati di Export-FormatData formato salvati nella $F variabile. Usa anche il parametro IncludeScriptBlock per includere blocchi di script nell'output.

Esempio 3: Esportare i dati di formato senza un blocco di script

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

Questo esempio mostra l'effetto di omettere il parametro IncludeScriptBlock da un Export-FormatData comando.

Il primo comando usa il Get-FormatData cmdlet per ottenere i dati di formato per l'oggetto System.Diagnostics.Process restituito dal cmdlet Get-Process. Il comando usa un operatore della pipeline (|) per inviare i dati di formattazione al Export-FormatData cmdlet, che lo esporta nel file Process.format.ps1xml nella directory corrente.

In questo caso, il comando non usa il Export-FormatData parametro IncludeScriptBlock .

Il secondo comando usa il cmdlet per aggiungere il Update-FormatData file Process.format.ps1xml alla sessione corrente. Il comando usa il parametro PrependPath per assicurarsi che i dati di formattazione per gli oggetti di elaborazione nel file Process.format.ps1xml vengano trovati prima della formattazione standard dei dati per gli oggetti di elaborazione.

Il terzo comando mostra gli effetti di questa modifica. Il comando usa il Get-Process cmdlet per ottenere processi con nomi che iniziano con P. L'output mostra che i valori delle proprietà calcolati usando i blocchi di script mancano dalla visualizzazione.

Parametri

-Force

Forza l'esecuzione del comando senza chiedere conferma all'utente.

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

-IncludeScriptBlock

Indica se i blocchi di script nel formato vengono esportati.

Poiché i blocchi di script contengono codice e possono essere usati da utenti malintenzionati, non vengono esportati per impostazione predefinita.

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

-InputObject

Specifica i dati di formattazione da esportare. Immettere una variabile contenente gli oggetti o un comando che ottiene gli oggetti, ad esempio un Get-FormatData comando. È anche possibile eseguire la pipe degli oggetti da Get-FormatData a Export-FormatData.

Type:ExtendedTypeDefinition[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-LiteralPath

Specifica un percorso per il file di output. A differenza del parametro Path, il valore di LiteralPath viene usato esattamente com'è digitato. Nessun carattere viene interpretato come carattere jolly. Se il percorso include caratteri di escape, racchiuderlo tra virgolette singole. Le virgolette singole indicano a PowerShell di non interpretare i caratteri come sequenze di escape.

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

-NoClobber

Indica che il cmdlet non sovrascrive i file esistenti. Per impostazione predefinita, Export-FormatData sovrascrive i file senza avviso a meno che il file non abbia l'attributo di sola lettura.

Per passare direttamente Export-FormatData ai file di sola lettura, usare il parametro Force .

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

-Path

Specifica un percorso per il file di output. Immettere un percorso (facoltativo) e il nome del file con l'estensione format.ps1xml. Se si omette il percorso, Export-FormatData crea il file nella directory corrente.

Se si usa un'estensione del nome file diversa da .ps1xml, il cmdlet non riconoscerà Update-FormatData il file.

Se si specifica un file esistente, Export-FormatData sovrascrive il file senza avviso, a meno che il file non abbia l'attributo di sola lettura. Per sovrascrivere un file di sola lettura, usare il parametro Force . Per impedire la sovrascrizione dei file, usare il parametro NoClobber .

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

Input

ExtendedTypeDefinition

È possibile eseguire la pipe degli oggetti ExtendedTypeDefinition da Get-FormatData a questo cmdlet.

Output

None

Questo cmdlet non restituisce output. Genera un file e lo salva nel percorso specificato.

Note

  • Per usare qualsiasi file di formattazione, incluso un file di formattazione esportato, i criteri di esecuzione per la sessione devono consentire l'esecuzione degli script e dei file di configurazione. Per altre informazioni, vedere about_Execution_Policies.