Export-FormatData

Riferimento

Modulo:: Microsoft.PowerShell.Utility

Salva i dati di formattazione dalla 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 cmdlet Export-FormatData crea file di formattazione di PowerShell (format.ps1xml) dagli oggetti di formattazione nella sessione corrente. Accetta l'ExtendedTypeDefinition oggetti restituiti Get-FormatData e li salva in un file in formato XML.

PowerShell usa i dati nei file di formattazione (format.ps1xml) per generare la visualizzazione predefinita degli oggetti di 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 in formato sessione

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

Questo comando esporta tutti i dati di formato nella sessione nel file AllFormat.ps1xml.

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

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

Il comando Export-FormatData usa il parametro IncludeScriptBlock per includere blocchi di script nei dati di formato 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 l'HelpInfoShort tipo nel file Help.format.ps1xml.

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

Il secondo comando usa il parametro InputObject del cmdlet Export-FormatData per immettere i dati di formato salvati nella variabile $F. 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

In questo esempio viene illustrato l'effetto dell'omissione del parametro IncludeScriptBlock da un comando Export-FormatData.

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

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

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

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

Parametri

-Force

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

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-IncludeScriptBlock

Indica se i blocchi di script nei dati di formato vengono esportati.

Poiché i blocchi di script contengono codice e possono essere usati in modo dannoso, non vengono esportati per impostazione predefinita.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-InputObject

Specifica gli oggetti dati di formato da esportare. Immettere una variabile contenente gli oggetti o un comando che ottiene gli oggetti, ad esempio un comando Get-FormatData. È anche possibile inviare tramite pipe gli oggetti da Get-FormatData a Export-FormatData.

Tipo:	ExtendedTypeDefinition[]
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-LiteralPath

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

Tipo:	String
Alias:	PSPath, LP
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	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 indirizzare Export-FormatData alla sovrascrittura dei file di sola lettura, usare il parametro force.

Tipo:	SwitchParameter
Alias:	NoOverwrite
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Path

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

Se si usa un'estensione di file diversa da .ps1xml, il cmdlet Update-FormatData non riconoscerà 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 sovrascrittura dei file, usare il parametro NoClobber.

Tipo:	String
Alias:	FilePath
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

Input

ExtendedTypeDefinition

È possibile inviare tramite pipe oggetti ExtendedTypeDefinition da Get-FormatData a questo cmdlet.

Output

None

Questo cmdlet non restituisce alcun 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 di script e file di configurazione. Per altre informazioni, vedere about_Execution_Policies.