Get-FormatData
Hiermee haalt u de opmaakgegevens op in de huidige sessie.
Syntax
Default (Standaard)
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 Bits.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.
Parametereigenschappen
| Type: | Version |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-TypeName
Hiermee geeft u de typenamen op die door deze cmdlet worden opgehaald voor de opmaakgegevens. Voer de typenamen in. Wildcards zijn toegestaan.
Parametereigenschappen
| Type: | String[] |
| Default value: | None |
| Ondersteunt jokertekens: | True |
| DontShow: | False |
Parametersets
(All)
| Position: | 0 |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.
Invoerwaarden
None
U kunt geen objecten doorsluisen naar deze cmdlet.