Get-FormatData
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 à partir de 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 de Import-PSSession
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 au format XML et les enregistrer dans des Format.ps1xml
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 les Get-FormatData
applets de commande , 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 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 convertit au format 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}
Paramètres
-PowerShellVersion
Spécifiez la version de PowerShell que cette applet de commande obtient pour la mise en forme des données. 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’objets vers cette applet de commande.