Delen via

Get-FormatData

  • Referentie
Module:
Microsoft.PowerShell.Utility

Hiermee haalt u de opmaakgegevens op in de huidige sessie.

Syntaxis

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

Description

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

De opmaakgegevens in de sessie bevatten opmaakgegevens uit Format.ps1xml opmaakbestanden, zoals die in de map $PSHOME, 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.ps1xmlvoor meer informatie over het opmaken van bestanden in PowerShell.

Voorbeelden

Voorbeeld 1: Alle opmaakgegevens ophalen

In dit voorbeeld worden alle opmaakgegevens in de sessie opgehaald.

Get-FormatData

Voorbeeld 2: Opmaakgegevens ophalen op typenaam

In dit voorbeeld worden de opmaakgegevensitems opgehaald waarvan de namen beginnen met System.Management.Automation.Cmd.

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

Voorbeeld 3: Een opmaakgegevensobject onderzoeken

In dit voorbeeld ziet u hoe u een gegevensobject opmaakt en de eigenschappen ervan bekijkt.

$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

Voorbeeld 4: Opmaakgegevens ophalen en exporteren

In dit voorbeeld ziet u hoe u Get-FormatData en Export-FormatData gebruikt om de opmaakgegevens te exporteren die door een module worden toegevoegd.

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

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

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

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

Voorbeeld 5: Opmaakgegevens ophalen op basis van de opgegeven versie van PowerShell

In dit voorbeeld ziet u hoe u Get-FormatData gebruikt om gegevens op te halen voor een opgegeven TypeName en PowerShell-versie.

Get-FormatData -TypeName 'Microsoft.PowerShell.Utility.FileHash' -PowerShellVersion $PSVersionTable.PSVersion

TypeNames                               FormatViewDefinition
---------                               --------------------
{Microsoft.PowerShell.Utility.FileHash} {Microsoft.PowerShell.Utility.FileHash}

Parameters

-PowerShellVersion

Geef de versie van PowerShell op die door deze cmdlet wordt opgehaald voor de opmaakgegevens. Voer een getal van twee cijfers in, gescheiden door een punt.

Deze parameter is toegevoegd in PowerShell 5.1 om de compatibiliteit te verbeteren bij externe computers met oudere versies van PowerShell.

Type:Version
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-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