Get-FormatData

Modulo:: Microsoft.PowerShell.Utility Module

Ottiene i dati di formattazione nella sessione corrente.

Sintassi

Default (Impostazione predefinita)

Get-FormatData
    [[-TypeName] <String[]>]
    [<CommonParameters>]

Descrizione

Il cmdlet Get-FormatData ottiene i dati di formattazione nella sessione corrente.

I dati di formattazione nella sessione includono i dati di formattazione dai file di formattazione Format.ps1xml, ad esempio quelli nella directory $pshome, i dati di formattazione per i moduli importati nella sessione e i dati di formattazione per i comandi importati nella sessione utilizzando il cmdlet Import-PSSession.

È possibile usare questo cmdlet per esaminare i dati di formattazione. È quindi possibile utilizzare il cmdlet Export-FormatData per serializzare gli oggetti, convertirli in XML e salvarli in 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

Questo comando ottiene tutti i dati di formattazione nella sessione.

Get-FormatData

Esempio 2: Ottenere dati di formattazione in base al nome del tipo

Get-FormatData -TypeName 'System.Management.Automation.Cmd*'

Questo comando consente di ottenere gli elementi di dati di formattazione i cui nomi iniziano con System.Management.Automation.Cmd*.

Esempio 3: Esaminare un oggetto dati di formattazione

$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
-----         ---------      -----
Name          Left           33
Category      Left           9
Undefined      0

In questo esempio viene illustrato come ottenere un oggetto dati di formattazione ed esaminarne le proprietà.

Esempio 4: Ottenere dati di formattazione ed esportarli

$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>
...

In questo esempio viene illustrato come utilizzare Get-FormatData e Export-FormatData per esportare i dati di formattazione aggiunti da un modulo.

I primi quattro comandi utilizzano i cmdlet Get-FormatData, Import-Module e Compare-Object per identificare il tipo di formato che il modulo BitsTransfer aggiunge alla sessione.

Il quinto comando utilizza il cmdlet Get-FormatData per ottenere il tipo di formato aggiunto dal modulo BitsTransfer. Utilizza un operatore pipeline (|) per inviare l'oggetto del tipo di formato al cmdlet Export-FormatData, che lo riconverte in XML e lo salva nel file format.ps1xml specificato.

Il comando finale mostra un estratto del contenuto del file format.ps1xml.

Parametri

-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.

Condividi tramite