Get-FormatData
Obtient les données de mise en forme dans la session active.
Syntaxe
Default (Par défaut)
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 Bits.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.
Propriétés du paramètre
| Type: | Version |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | True |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 0 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
Entrées
None
Vous ne pouvez pas diriger les objets vers cette applet de commande.
