Condividi tramite

Get-FormatData

  • Riferimento
Modulo:
Microsoft.PowerShell.Utility

Ottiene i dati di formattazione nella sessione corrente.

Sintassi

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 , e 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 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 i computer remoti che eseguono versioni precedenti di PowerShell.

Tipo:Version
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TypeName

Specifica i nomi dei tipi che questo cmdlet ottiene per i dati di formattazione. Immettere i nomi dei tipi. Sono consentiti caratteri jolly.

Tipo:String[]
Posizione:0
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

Input

None

Non è possibile inviare tramite pipe oggetti a questo cmdlet.

Output

ExtendedTypeDefinition