Export-FormatData
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 cmdlet Export-FormatData crea Windows PowerShell file di formattazione (format.ps1xml) dagli oggetti di formattazione nella sessione corrente. Accetta gli oggetti ExtendedTypeDefinition che Get-FormatData restituisce e li salva in un file in formato XML.
Windows PowerShell usa i dati dei 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 sui file di formattazione in Windows PowerShell, vedere about_Format.ps1xml.
Esempio
Esempio 1: Esportare i dati del formato sessione
PS C:\> 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 cmdlet Get-FormatData per ottenere i dati di formattazione della sessione. Il valore * (tutti) per il parametro TypeName indica al cmdlet di 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.ps1.
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
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 formattazione del tipo HelpInfoShort 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 del formato 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 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 che i dati di formattazione standard per gli oggetti di elaborazione.
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 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 nei dati di 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 comando Get-FormatData . È anche possibile inviare tramite pipe gli 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 Windows PowerShell di non interpretare i caratteri come sequenze di escape.
Type: | String |
Aliases: | PSPath |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NoClobber
Inidicatest 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 a sovrascrivere i 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 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 evitare che i file vengano sovrascritti, usare il parametro NoClobber .
Type: | String |
Aliases: | FilePath |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Input
È possibile inviare tramite pipe 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 degli script e dei file di configurazione. Per altre informazioni, vedere about_Execution_Policies.