Condividi tramite

Export-FormatData

Modulo:
Microsoft.PowerShell.Utility Module

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

Sintassi

ByPath (Impostazione predefinita) 

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

ByLiteralPath 

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

Descrizione

Il cmdlet Export-FormatData crea i file di formattazione di Windows PowerShell (format.ps1xml) dagli oggetti di formattazione nella sessione corrente. Prende gli oggetti ExtendedTypeDefinition restituiti Get-FormatData e li salva in un file in formato XML.

Windows 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 ulteriori informazioni sulla formattazione dei file in Windows PowerShell, vedere about_Format.ps1xml.

Esempio

Esempio 1: Esportare i dati in formato sessione

PS C:\> 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. Il valore * (all) per il parametro TypeName indica al cmdlet di ottenere tutti i dati nella sessione.

Il comando utilizza 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.ps1.

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

Esempio 2: Esportare i dati di formato per un tipo

PS C:\> $F = Get-FormatData -TypeName "helpinfoshort"
PS C:\> 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 utilizza il cmdlet Get-FormatData per ottenere i dati di formato per il tipo HelpInfoShort e li salva nella $F variabile.

Il secondo comando utilizza 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 formattati senza un blocco di script

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

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

Il primo comando utilizza 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 li esporta nel file Process.format.ps1xml nella directory corrente.

In questo caso, il comando Export-FormatData non utilizza 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 processo nel file Process.format.ps1xml vengano trovati prima dei dati di formattazione standard per gli oggetti processo.

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

Parametri

-Force

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-InputObject

Specifica gli oggetti dati di formato da esportare. Immettere una variabile che contiene gli oggetti o un comando che ottiene gli oggetti, ad esempio un comando Get-FormatData . È inoltre possibile reindirizzare gli oggetti da Get-FormatData a Export-FormatData.

Proprietà dei parametri

Tipo:

ExtendedTypeDefinition[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-LiteralPath

Specifica una posizione 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 metacaratteri. Se il percorso include caratteri di escape, racchiudilo tra virgolette singole. Le virgolette singole indicano a Windows PowerShell di non interpretare alcun carattere come sequenze di escape.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:PSPath

Set di parametri

ByLiteralPath
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-NoClobber

Inidicatest che il cmdlet non sovrascriva i file esistenti. Per impostazione predefinita, Export-FormatData sovrascrive i file senza preavviso, a meno che il file non disponga dell'attributo di sola lettura.

Per indicare a Export-FormatData di sovrascrivere i file di sola lettura, utilizzare il parametro Force .

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:NoOverwrite

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Path

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

Se si utilizza 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 disponga dell'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.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:FilePath

Set di parametri

ByPath
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

ExtendedTypeDefinition

È possibile reindirizzare gli oggetti ExtendedTypeDefinition da Get-FormatData a Export-FormatData.

Output

None

Export-FormatData non restituisce alcun oggetto. 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 ulteriori informazioni, vedere about_Execution_Policies.