Ottiene i dati di formattazione della sessione corrente.
Sintassi
Get-FormatData [[-TypeName] <string[]>] [<CommonParameters>]
Descrizione
Il cmdlet Get-FormatData ottiene i dati di formattazione della sessione corrente.
I dati di formattazione della sessione includono dati dei file di formattazione Format.ps1xml (come quelli nella directory $pshome), dati di formattazione per moduli importati nella sessione e dati di formattazione per i comandi importati nella sessione tramite il cmdlet Import-PSSession.
È possibile utilizzare questo cmdlet per esaminare i dati di formattazione. È quindi possibile utilizzare il cmdlet Export-FormatData per serializzare gli oggetti (convertirli in XML) e salvarli nei file Format.ps1xml.
Per ulteriori informazioni sui file di formattazione in Windows PowerShell, vedere about_Format.ps1xml.
Parametri
-TypeName <string[]>
Ottiene solo i dati di formattazione con i nomi dei tipi specificati. Immettere i nomi dei tipi. È consentito l'utilizzo di caratteri jolly.
|
Obbligatorio? |
false |
|
Posizione? |
1 |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
true |
<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 |
Nessuno Non è possibile reindirizzare l'input a questo cmdlet. |
|
Output |
System.Management.Automation.ExtendedTypeDefinition |
Esempio 1
C:\PS>get-formatdata Descrizione ----------- Con questo comando si ottengono tutti i dati di formattazione nella sessione.
Esempio 2
C:\PS>get-formatdata -typename Microsoft.Wsman* Descrizione ----------- Con questo comando si ottengono gli elementi dei dati di formattazione i cui nomi cominciano con "Microsoft.Wsman."
Esempio 3
C:\PS>$f = get-formatdata -typename helpinfoshort
C:\PS> $f
TypeName FormatViewDefinition
-------- --------------------
HelpInfoShort {help , TableControl}
C:\PS> $f.FormatViewDefinition[0].control
Headers Rows
------- ----
{System.Management.Automation.TableControlColumnHeader, System.Manageme... {System.Management.Automation.TableControlRow}
C:\PS> $f.FormatViewDefinition[0].control.headers
Label Alignment Width
----- --------- -----
Name Left 33
Category Left 9
Undefined 0
Descrizione
-----------
In questo esempio viene illustrato come ottenere un oggetto dati di formattazione e come esaminarne le proprietà.
Esempio 4
C:\PS>$a = get-formatdata C:\PS> import-module bitstransfer C:\PS> $b = get-formatdata C:\PS> compare-object $a $b InputObject SideIndicator ----------- ------------- Microsoft.BackgroundIntelligentTransfer.Management.BitsJob => C:\PS> get-formatdata *bits* | export-formatdata -filepath c:\test\bits.format.ps1xml C:\PS> get-content c:\test\bits.format.ps1xml <?xml version="1.0" encoding="utf-8"?><Configuration><ViewDefinitions> <View><Name>Microsoft.BackgroundIntelligentTransfer.Management.BitsJob</Name> ... Descrizione ----------- In questo esempio viene illustrato come utilizzare Get-FormatData ed Export-FormatData per esportare i dati di formattazione aggiunti da un modulo. Nei primi quattro comandi vengono utilizzati i cmdlet Get-FormatData, Import-Module e Compare-Object per identificare il tipo di formato aggiunto alla sessione dal modulo BitsTransfer. Nel quinto comando viene utilizzato il cmdlet Get-FormatData per ottenere il tipo di formato aggiunto dal modulo BitsTransfer. Viene utilizzato un operatore pipeline (|) per inviare l'oggetto tipo di formato al cmdlet Export-FormatData, che lo converte nuovamente in XML e lo salva nel file format.ps1xml specificato. Nel comando finale viene illustrato un estratto del contenuto del file format.ps1xml.
Vedere anche