Salva i dati di formattazione della sessione corrente in un file di formattazione.
Sintassi
Export-FormatData [-Force] [-IncludeScriptBlock] [-InputObject <ExtendedTypeDefinition[]>] [-NoClobber] [-Path <string>] [<CommonParameters>]
Descrizione
Il cmdlet Export-FormatData crea file di formattazione di Windows PowerShell (format.ps1xml) dagli oggetti di formattazione della sessione corrente. Accetta gli oggetti ExtendedTypeDefinition restituiti da Get-FormatData e li salva in un file in formato XML.
Windows PowerShell utilizza i dati nei file di formattazione (format.ps1xml) per generare la visualizzazione predefinita di oggetti Microsoft .NET Framework nella sessione. È possibile visualizzare e modificare i file di formattazione e utilizzare il cmdlet Update-FormatData per aggiungere dati di formattazione a una sessione.
Per ulteriori informazioni sui file di formattazione in Windows PowerShell, vedere about_Format.ps1xml.
Parametri
-Force
Sovrascrive un file di output esistente, anche se per il file è impostato l'attributo di sola lettura.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
False |
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-IncludeScriptBlock
Determina se vengono esportati i blocchi di script nei dati di formato.
Poiché i blocchi di script contengono codice e possono essere utilizzati in modo dannoso, non vengono esportati per impostazione predefinita.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
False |
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-InputObject <ExtendedTypeDefinition[]>
Specifica gli oggetti dati di formato da esportare. Immettere una variabile contenente gli oggetti o un comando che consente di ottenere gli oggetti, ad esempio Get-FormatData. È inoltre possibile reindirizzare gli oggetti da Get-FormatData a Export-FormatData.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByValue) |
|
Accettare caratteri jolly? |
false |
-NoClobber
Impedisce al cmdlet di sovrascrivere i file esistenti. Per impostazione predefinita, Export-FormatData sovrascrive i file senza visualizzare alcun avviso a meno che il file non disponga dell'attributo di sola lettura.
Per fare in modo che Export-FormatData sovrascriva i file di sola lettura, utilizzare il parametro Force.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Path <string>
Specifica un percorso 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 lo sovrascrive senza alcun avviso, a meno che il file non disponga dell'attributo di sola lettura. Per sovrascrivere un file di sola lettura, utilizzare il parametro Force. Per evitare la sovrascrittura dei file, utilizzare il parametro NoClobber.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
nessuno |
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
<CommonParameters>
Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.
Input e output
Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.
|
Input |
System.Management.Automation.ExtendedTypeDefinition È inoltre possibile reindirizzare oggetti ExtendedTypeDefinition da Get-FormatData a Export-FormatData. |
|
Output |
Nessuno Export-FormatData non restituisce alcun oggetto. Genera un file e lo salva nel percorso specificato. |
Note
Per utilizzare qualsiasi file di formattazione, incluso un file di formattazione esportato, è necessario che i criteri di esecuzione per la sessione consentano l'esecuzione di script e file di configurazione. Per ulteriori informazioni, vedere about_Execution_Policies.
Esempio 1
C:\PS>get-formatdata -typename * | export-formatdata -path allformat.ps1xml -IncludeScriptBlock Descrizione ----------- Con questo comando vengono esportati tutti i dati di formato della sessione nel file AllFormat.ps1xml. Viene utilizzato il cmdlet Get-FormatData per ottenere i dati di formato nella sessione. Con il valore * (tutto) per il parametro TypeName viene indicato al cmdlet di ottenere tutti i dati della sessione. Nel comando viene utilizzato un operatore pipeline (|) per inviare i dati di formato dal comando Get-FormatData al cmdlet Export-FormatData che li esporta nel file AllFormat.ps1. Il comando Export-FormatData utilizza il parametro IncludeScriptBlock per includere i blocchi di script nei dati di formato nel file.
Esempio 2
C:\PS>$f = get-formatdata -typename helpinfoshort C:\PS> export-formatdata -inputObject $f -path c:\test\help.format.ps1xml -IncludeScriptBlock Descrizione ----------- Tramite questi comandi vengono esportati i dati di formato per il tipo HelpInfoShort nel file Help.format.ps1xml. Nel primo comando viene utilizzato il cmdlet Get-FormatData per ottenere i dati di formato per il tipo HelpInfoShort che vengono quindi salvati nella variabile $f. Nel secondo comando viene utilizzato il parametro InputObject di Export-FormatData per immettere i dati di formato salvati nella variabile $f. Viene inoltre utilizzato il parametro IncludeScriptBlock per includere blocchi di script nell'output.
Esempio 3
C:\PS>get-formatdata -typename System.Diagnostics.Process | export-FormatData -path process.format.ps1xml
C:\PS> Update-FormatData -prependPath .\process.format.ps1xml
C:\PS> 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
Descrizione
-----------
In questo esempio viene illustrato l'effetto dell'omissione del parametro IncludeScriptBlock da un comando Export-FormatData.
Nel primo comando viene utilizzato il cmdlet Get-FormatData per ottenere i dati di formato per l'oggetto System.Diagnostics.Process restituito dal cmdlet Get-Process. Viene utilizzato 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, nel comando Export-FormatData non viene utilizzato il parametro IncludeScriptBlock.
Nel secondo comando viene utilizzato il cmdlet Update-FormatData per aggiungere il file Process.format.ps1xml alla sessione corrente. Viene utilizzato il parametro PrependPath per assicurarsi che i dati di formattazione per gli oggetti processo nel file Process.format.ps1xml si trovino prima dei dati di formattazione standard per gli oggetti processo.
Il terzo comando illustra gli effetti di questa modifica. Nel comando viene utilizzato il cmdlet Get-Process per ottenere i processi il cui nome inizia con "P". Nell'output viene illustrato che i valori di proprietà calcolati mediante blocchi di script non sono presenti nella visualizzazione.
Vedere anche