Get-FormatData

  • Referentie
Module:
Microsoft.PowerShell.Utility

Hiermee haalt u de opmaakgegevens op in de huidige sessie.

Syntax

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 omvatten het opmaken van gegevens uit Format.ps1xml opmaakbestanden, zoals die in de $PSHOME map, het opmaken van gegevens voor modules die u in de sessie importeert en het opmaken van gegevens 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 Export-FormatData cmdlet 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

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 de opmaakgegevens kunt gebruiken Get-FormatData en Export-FormatData 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 BitsTransfer-module aan de sessie toevoegt.

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

Met de laatste opdracht wordt een fragment van de format.ps1xml bestandsinhoud weergegeven.

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

In dit voorbeeld ziet u hoe Get-FormatData u gegevens opzoekt 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
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters:True

Invoerwaarden

None

U kunt geen objecten doorsluisen naar deze cmdlet.

Uitvoerwaarden

ExtendedTypeDefinition