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, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.
Entrées et sorties
Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.
|
Entrées |
Aucun Vous ne pouvez pas diriger d'entrée vers cette applet de commande. |
|
Sorties |
System.Management.Automation.ExtendedTypeDefinition |
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.
Voir aussi