Partager via

Get-FormatData

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

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

Syntaxe

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

Description

L’applet Get-FormatData de commande 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, telles que celles du $PSHOME répertoire, 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 Import-PSSession de commande.

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

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 illustre 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 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 le Get-FormatData, Import-Moduleet Compare-Object les applets de commande pour identifier le type de format que le module BitsTransfer ajoute à la session.

La cinquième commande utilise l’applet Get-FormatData de commande 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 Export-FormatData de commande, qui le convertit en XML et l’enregistre dans le fichier spécifié format.ps1xml .

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

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ée.

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

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

Important

Pour vous assurer que les informations complètes de mise en forme de type sont retournées, vous devez toujours inclure le paramètre PowerShellVersion avec la version appropriée. Si le paramètre et la valeur sont omis, vous risquez de ne pas obtenir toutes les informations de type correctes.

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 des types. 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 les objets vers cette applet de commande.

Sorties

ExtendedTypeDefinition