Get-FormatData

NOM
    Get-FormatData

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

SYNTAXE
    Get-FormatData [[-TypeName] <string[]>] [<CommonParameters>]


DESCRIPTION
    L'applet de commande Get-FormatData obtient les données de mise en forme de la session active.

    Les données de mise en forme de la session incluent les données de mise en forme issues des fichiers de mise en forme Format.ps1xml (notamment ceux figurant dans le 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 au format XML) et les enregistrer dans les fichiers Format.ps1xml.

    Pour plus d'informations sur les fichiers de mise en forme dans Windows PowerShell, consultez about_Format.ps1xml.


PARAMÈTRES
    -TypeName <string[]>
        Obtient uniquement les données de mise en forme ayant les noms de types spécifiés. Entrez les noms de types. Les caractères génériques sont autorisés.

        Obligatoire ?                false
        Position ?                   1
        Valeur par défaut
        Accepter l'entrée de pipeline ?       false
        Accepter les caractères génériques ?  true

    <CommonParameters>
        Cette applet de commande prend en charge les paramètres courants : Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer et OutVariable. Pour plus d'informations, tapez
        « get-help about_commonparameters ».

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


SORTIES
    System.Management.Automation.ExtendedTypeDefinition



NOTES





    -------------------------- EXEMPLE 1 --------------------------

    C:\PS>get-formatdata


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





    -------------------------- EXEMPLE 2 --------------------------

    C:\PS>get-formatdata -typename Microsoft.Wsman*


    Description
    -----------
    Cette commande obtient les éléments des données de mise en forme dont les noms commencent par « Microsoft.Wsman ».





    -------------------------- EXEMPLE 3 --------------------------

    C:\PS>$f = get-formatdata -typename helpinfoshort

    C:\PS> $f

    TypeName        FormatViewDefinition
    --------        --------------------
    HelpInfoShort   {help , TableControl}

    C:\PS> $f.FormatViewDefinition[0].control

    Headers                                                                    Rows
    -------                                                                    ----
    {System.Management.Automation.TableControlColumnHeader, System.Manageme... {System.Management.Automation.TableControlRow}


    C:\PS> $f.FormatViewDefinition[0].control.headers

    Label         Alignment      Width
    -----         ---------      -----
    Name          Left           33
    Category      Left           9
                  Undefined      0


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





    -------------------------- EXEMPLE 4 --------------------------

    C:\PS>$a = get-formatdata

    C:\PS> import-module bitstransfer
    C:\PS> $b = get-formatdata
    C:\PS> compare-object $a $b

    InputObject                                                SideIndicator
    -----------                                                -------------
    Microsoft.BackgroundIntelligentTransfer.Management.BitsJob =>


    C:\PS> get-formatdata *bits* | export-formatdata -filepath c:\test\bits.format.ps1xml

    C:\PS> get-content c:\test\bits.format.ps1xml

    <?xml version="1.0" encoding="utf-8"?><Configuration><ViewDefinitions>
    <View><Name>Microsoft.BackgroundIntelligentTransfer.Management.BitsJob</Name>
    ...


    Description
    -----------
    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. Elle utilise un opérateur de pipeline (|) pour envoyer l'objet type de mise en forme à l'applet de commande Export-FormatData, qui le reconvertit en XML et l'enregistre dans le fichier format.ps1xml spécifié.

    La dernière commande montre un extrait du contenu du fichier format.ps1xml.






LIENS CONNEXES
    Online version: http://go.microsoft.com/fwlink/?LinkID=144303
    Export-FormatData
    Update-FormatData