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[]>]
   [-PowerShellVersion <Version>]
   [<CommonParameters>]

Description

L’applet de commande 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 Format.ps1xml fichiers de mise en forme, tels que ceux du répertoire $PSHOME, la mise en forme des données pour les modules que vous importez dans la session et la mise en forme des données pour les 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. Vous pouvez ensuite utiliser l’applet de commande Export-FormatData pour sérialiser les objets, les convertir en XML et les enregistrer dans des 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

Cet exemple 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

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

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

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

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

$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

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

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

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

Les quatre premières commandes utilisent les applets de commande Get-FormatData, Import-Moduleet 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 que le module BitsTransfer ajoute. 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.

Exemple 5 : Obtenir des données de mise en forme en fonction de la version spécifiée de PowerShell

Cet exemple montre comment utiliser Get-FormatData pour obtenir des données de format pour une version TypeName et PowerShell spécifiées.

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

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

Paramètres

-PowerShellVersion

Spécifiez la version de PowerShell que cette applet de commande obtient pour les données de mise en forme. Entrez un nombre à deux chiffres séparé par un point.

Ce paramètre a été ajouté dans PowerShell 5.1 pour améliorer la compatibilité lors de la communication à distance des ordinateurs exécutant des versions antérieures de PowerShell.

Type:Version
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-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