Delen via

Get-FormatData

  • Referentie
Module:
Microsoft.PowerShell.Utility

Hiermee haalt u de opmaakgegevens op in de huidige sessie.

Syntaxis

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

Description

De cmdlet Get-FormatData haalt de opmaakgegevens op in de huidige sessie.

De opmaakgegevens in de sessie bevatten opmaakgegevens uit format.ps1xml-opmaakbestanden, zoals bestanden in de $pshome-map, opmaakgegevens voor modules die u in de sessie importeert en opmaakgegevens voor opdrachten die u in uw sessie importeert met behulp van de Import-PSSession-cmdlet.

U kunt deze cmdlet gebruiken om de opmaakgegevens te onderzoeken. Vervolgens kunt u de cmdlet Export-FormatData gebruiken om de objecten te serialiseren, te converteren naar XML en op te slaan in Format.ps1xml-bestanden.

Zie about_Format.ps1xml voor meer informatie over het opmaken van bestanden in PowerShell.

Voorbeelden

Voorbeeld 1: Alle opmaakgegevens ophalen

Met deze opdracht worden alle opmaakgegevens in de sessie opgehaald.

Get-FormatData

Voorbeeld 2: Opmaakgegevens ophalen op typenaam

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

Met deze opdracht worden de opmaakgegevensitems opgehaald waarvan de namen beginnen met System.Management.Automation.Cmd*.

Voorbeeld 3: Een opmaakgegevensobject onderzoeken

$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 dit voorbeeld ziet u hoe u een gegevensobject opmaakt en de eigenschappen ervan bekijkt.

Voorbeeld 4: Opmaakgegevens ophalen en exporteren

$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 dit voorbeeld ziet u hoe u Get-FormatData- en Export-FormatData kunt gebruiken om de opmaakgegevens te exporteren die door een module worden toegevoegd.

De eerste vier opdrachten gebruiken de cmdlets Get-FormatData, Import-Module en Compare-Object om het indelingstype te identificeren dat de BitsTransfer-module aan de sessie toevoegt.

De vijfde opdracht maakt gebruik van de cmdlet Get-FormatData om het indelingstype op te halen dat de BitsTransfer-module toevoegt. Er wordt een pijplijnoperator (|) gebruikt om het object voor het indelingstype te verzenden naar de cmdlet Export-FormatData, waarmee het object weer wordt geconverteerd naar XML en wordt opgeslagen in het opgegeven bestand format.ps1xml.

De laatste opdracht toont een fragment van de bestandsinhoud format.ps1xml.

Parameters

-TypeName

Hiermee geeft u de typenamen op die door deze cmdlet worden opgehaald voor de opmaakgegevens. Voer de typenamen in. Jokertekens zijn toegestaan.

Type:String[]
Position:0
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:True

Invoerwaarden

None

U kunt invoer voor deze cmdlet niet doorsluisen.

Uitvoerwaarden

ExtendedTypeDefinition