Get-FormatData
Ottiene i dati di formattazione nella sessione corrente.
Sintassi
Default (impostazione predefinita).
Get-FormatData
[[-TypeName] <String[]>]
[-PowerShellVersion <Version>]
[<CommonParameters>]
Descrizione
Il cmdlet Get-FormatData ottiene i dati di formattazione nella sessione corrente.
I dati di formattazione nella sessione includono la formattazione dei dati di Format.ps1xml file di formattazione, ad esempio quelli nella directory $PSHOME, la formattazione dei dati per i moduli importati nella sessione e la formattazione dei dati per i comandi importati nella sessione usando il cmdlet Import-PSSession.
È possibile usare questo cmdlet per esaminare i dati di formattazione. È quindi possibile usare il cmdlet Export-FormatData per serializzare gli oggetti, convertirli in XML e salvarli nei file Format.ps1xml.
Per altre informazioni sulla formattazione dei file in PowerShell, vedere about_Format.ps1xml.
Esempio
Esempio 1: Ottenere tutti i dati di formattazione
In questo esempio vengono visualizzati tutti i dati di formattazione nella sessione.
Get-FormatData
Esempio 2: Ottenere dati di formattazione in base al nome del tipo
Questo esempio ottiene gli elementi di dati di formattazione i cui nomi iniziano con System.Management.Automation.Cmd.
Get-FormatData -TypeName 'System.Management.Automation.Cmd*'
Esempio 3: Esaminare un oggetto dati di formattazione
In questo esempio viene illustrato come ottenere un oggetto dati di formattazione ed esaminarne le proprietà.
$F = Get-FormatData -TypeName 'System.Management.Automation.Cmd*'
$F
TypeName FormatViewDefinition
-------- --------------------
HelpInfoShort {help , TableControl}
$F.FormatViewDefinition[0].Control
Headers : {System.Management.Automation.TableControlColumnHeader,
System.Management.Automation.TableControlColumnHeader,
System.Management.Automation.TableControlColumnHeader,
System.Management.Automation.TableControlColumnHeader}
Rows : {System.Management.Automation.TableControlRow}
AutoSize : False
HideTableHeaders : False
GroupBy :
OutOfBand : False
$F.FormatViewDefinition[0].Control.Headers
Label Alignment Width
----- --------- -----
CommandType Undefined 15
Name Undefined 50
Version Undefined 10
Source Undefined 0
Esempio 4: Ottenere dati di formattazione ed esportarli
Questo esempio illustra come usare Get-FormatData e Export-FormatData per esportare i dati di formattazione aggiunti da un modulo.
$A = Get-FormatData
Import-Module BitsTransfer
$B = Get-FormatData
Compare-Object $A $B
InputObject SideIndicator
----------- -------------
Microsoft.BackgroundIntelligentTransfer.Management.BitsJob =>
Get-FormatData *bits* | Export-FormatData -FilePath C:\test\Bits.format.ps1xml
Get-Content C:\test\Bits.format.ps1xml
<?xml version="1.0" encoding="utf-8"?><Configuration><ViewDefinitions>
<View><Name>Microsoft.BackgroundIntelligentTransfer.Management.BitsJob</Name>
...
I primi quattro comandi usano i cmdlet Get-FormatData, Import-Modulee Compare-Object per identificare il tipo di formato aggiunto dal modulo BitsTransfer alla sessione.
Il quinto comando usa il cmdlet Get-FormatData per ottenere il tipo di formato aggiunto dal modulo BitsTransfer. Usa un operatore pipeline (|) per inviare l'oggetto tipo di formato al cmdlet Export-FormatData, che lo converte di nuovo in XML e lo salva nel file di Bits.format.ps1xml specificato.
Il comando finale mostra un estratto del contenuto del file format.ps1xml.
Esempio 5: Ottenere dati di formattazione in base alla versione specificata di PowerShell
In questo esempio viene illustrato come usare Get-FormatData per ottenere dati di formato per una TypeName specificata e versione di PowerShell.
Get-FormatData -TypeName 'Microsoft.Powershell.Utility.FileHash' -PowerShellVersion $PSVersionTable.PSVersion
TypeNames FormatViewDefinition
--------- --------------------
{Microsoft.Powershell.Utility.FileHash} {Microsoft.Powershell.Utility.FileHash}
Parametri
-PowerShellVersion
Specificare la versione di PowerShell che questo cmdlet ottiene per i dati di formattazione. Immettere un numero a due cifre separato da un punto.
Questo parametro è stato aggiunto in PowerShell 5.1 per migliorare la compatibilità quando si esegue la comunicazione remota ai computer che eseguono versioni precedenti di PowerShell.
Proprietà dei parametri
| Tipo: | Version |
| 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 |
-TypeName
Specifica i nomi dei tipi che questo cmdlet ottiene per i dati di formattazione. Immettere i nomi dei tipi. Sono consentiti i metacaratteri.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | True |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 0 |
| Obbligatorio: | False |
| 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
None
Gli oggetti non possono essere inviati tramite pipe a questo cmdlet.
