Partager via

Get-FormatData

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

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

Syntax

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 dans la session incluent la mise en forme des données des fichiers de Format.ps1xml mise en forme, telles que celles du répertoire, la $PSHOME 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 -PowerShellVersion 5.1

Important

Pour vous assurer que les informations de mise en forme de type complètes sont retournées, vous devez toujours inclure le paramètre PowerShellVersion avec la valeur 5.1 lors de l’utilisation d’un appel local de Get-FormatData. Si le paramètre et la valeur sont omis, vous risquez de ne pas obtenir toutes les informations de type correctes.

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

Cet exemple obtient la mise en forme des éléments de données dont le nom commence par System.Management.Automation.Cmd.

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

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*' -PowerShellVersion 5.1
$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 -PowerShellVersion 5.1
Import-Module bitstransfer
$B = Get-FormatData -PowerShellVersion 5.1
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 Get-FormatDataapplets de commande , Import-Moduleet Compare-Object 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 format à l’applet Export-FormatData de commande, qui le reconvertit 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 basées sur 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}

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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

Entrées

None

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

Sorties

ExtendedTypeDefinition