Get-FormatData

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

La cmdlet Get-FormatData obtient les données de mise en forme dans la session active.

Les données de mise en forme de la session incluent des données de mise en forme à partir de fichiers de mise en forme Format.ps1xml, telles que celles du répertoire $pshome, les données de mise en forme des modules que vous importez dans la session et les données de mise en forme des commandes que vous importez dans votre session à l’aide de l’applet de commande Import-PSSession.

Vous pouvez utiliser cette applet de commande pour examiner les données de mise en forme. Ensuite, vous pouvez utiliser l’applet de commande Export-FormatData pour sérialiser les objets, les convertir en XML et les enregistrer dans les fichiers Format.ps1xml.

Pour plus d’informations sur la mise en forme des fichiers dans PowerShell, consultez about_Format.ps1xml.

Cette commande obtient toutes les données de mise en forme dans la session.

Get-FormatData

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

Cette commande obtient les éléments de données de mise en forme dont les noms commencent par System.Management.Automation.Cmd*.

$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

Cet exemple montre comment obtenir un objet de données de mise en forme et examiner ses propriétés.

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

Cet exemple montre comment utiliser Get-FormatData et Export-FormatData pour exporter les données de mise en forme ajoutées par un module.

Les quatre premières commandes utilisent les applets de commande Get-FormatData, Import-Module et Compare-Object pour identifier le type de format que le module BitsTransfer ajoute à la session.

La cinquième commande utilise l’applet de commande Get-FormatData pour obtenir le type de format ajouté par le module BitsTransfer. Il utilise un opérateur de pipeline (|) pour envoyer l’objet de type de format à l’applet de commande Export-FormatData, qui le convertit en XML et l’enregistre dans le fichier format.ps1xml spécifié.

La commande finale affiche un extrait du contenu du fichier format.ps1xml.

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Vous ne pouvez pas diriger d'entrée vers cette applet de commande.