Partager via

Get-FormatData

  • Référence
Module:
Microsoft.PowerShell.Utility

Obtient les données de mise en forme dans la session active.

Syntaxe

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

Description

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.

Exemples

Exemple 1 : Obtenir toutes les données de mise en forme

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

Get-FormatData

Exemple 2 : Obtenir des données de mise en forme par nom de type

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

Exemple 3 : Examiner un objet de données de mise en forme

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

Exemple 4 : Obtenir des données de mise en forme et les exporter

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

Paramètres

-TypeName

Spécifie les noms de type que cette applet de commande obtient pour les données de mise en forme. Entrez les noms de type. Les caractères génériques sont autorisés.

Type:String[]
Position:0
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:True

Entrées

None

Vous ne pouvez pas diriger l’entrée vers cette applet de commande.

Sorties

ExtendedTypeDefinition