Update-FormatData

Met à jour les données de mise en forme de la session active.

Syntaxe

Update-FormatData [[-AppendPath] <string[]>] [-PrependPath <string[]>] [-Confirmer] [-WhatIf] [<CommonParameters>]

Description

L'applet de commande Update-FormatData recharge les données de mise en forme à partir de fichiers de mise en forme dans la session active. Cette applet de commande vous permet de mettre à jour les données de mise en forme sans redémarrer Windows PowerShell.

Sans paramètres, Update-FormatData recharge les fichiers de mise en forme qu'il a précédemment chargés. Vous pouvez utiliser les paramètres de Update-FormatData pour ajouter de nouveaux fichiers de mise en forme à la session.

Les fichiers de mise en forme sont des fichiers texte au format XML qui portent l'extension de nom de fichier format.ps1xml. Les données de mise en forme contenant dans ces fichiers définissent l'affichage d'objets Microsoft .NET Framework dans la session.

Lorsque Windows PowerShell démarre, il charge dans la session les données de mise en forme à partir des fichiers de mise en forme se trouvant dans le répertoire d'installation de Windows PowerShell ($pshome). Vous pouvez utiliser Update-FormatData pour recharger les données de mise en forme dans la session active sans redémarrer Windows PowerShell. Cela est utile lorsque vous avez ajouté ou modifié un fichier de mise en forme, mais que vous ne voulez pas interrompre la session.

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

Paramètres

-AppendPath <string[]>

Ajoute les fichiers de mise en forme spécifiés à la session. Ces fichiers sont chargés après le chargement, par Windows PowerShell, des fichiers de mise en forme intégrés.

Lors de la mise en forme d'objets .NET, Windows PowerShell utilise la première définition de mise en forme qu'il trouve pour chaque type .NET. Si vous utilisez le paramètre AppendPath, Windows PowerShell recherche les données dans les fichiers intégrés avant de rencontrer les données de mise en forme que vous ajoutez.

Utilisez ce paramètre pour ajouter un fichier qui met en forme un objet .NET qui n'est pas référencé dans les fichiers de mise en forme intégrés.

-PrependPath <string[]>

Ajoute les fichiers de mise en forme spécifiés à la session. Ces fichiers sont chargés avant le chargement, par Windows PowerShell, des fichiers de mise en forme intégrés.

Lors de la mise en forme d'objets .NET, Windows PowerShell utilise la première définition de mise en forme qu'il trouve pour chaque type .NET. Si vous utilisez le paramètre PrependPath, Windows PowerShell recherche les données des fichiers que vous ajoutez avant de rencontrer les données de mise en forme des fichiers intégrés.

Utilisez ce paramètre pour ajouter un fichier qui met en forme un objet .NET qui est également référencé dans les fichiers de mise en forme intégrés.

-Confirmer

Vous invite à confirmer l'exécution de la commande.

-WhatIf

Décrit le résultat que vous obtiendriez en exécutant la commande, sans réellement l'exécuter.

<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.

Remarques

Update-FormatData met également à jour les données de mise en forme pour les commandes de la session qui ont été importées à partir de modules. Si le fichier de mise en forme pour un module change, vous pouvez exécuter une commande Update-FormatData pour mettre à jour les données de mise en forme pour les commandes importées. Vous n'avez pas besoin d'importer à nouveau le module.

Exemple 1

C:\PS>update-formatdata

Description
-----------
Cette commande recharge les fichiers de mise en forme qu'elle a précédemment chargés.

Exemple 2

C:\PS>update-formatdata -appendpath trace.format.ps1xml, log.format.ps1xml

Description
-----------
Cette commande recharge les fichiers de mise en forme dans la session, notamment deux nouveaux fichiers, Trace.format.ps1xml et Log.format.ps1xml. 

Étant donné que cette commande utilise le paramètre AppendPath, les données de mise en forme contenues dans les nouveaux fichiers sont chargées après les données de mise en forme provenant des fichiers intégrés. 

Le paramètre AppendPath est utilisé car les nouveaux fichiers contiennent les données de mise en forme pour les objets qui ne sont pas référencés dans les fichiers intégrés.

Exemple 3

C:\PS>update-formatdata -prependPath c:\test\NewFiles.format.ps1xml

# Edit the NewFiles.format.ps1 file.

C:\PS> update-formatdata

Description
-----------
Cet exemple montre comment recharger un fichier de mise en forme après l'avoir modifié.

La première commande ajoute le fichier NewFiles.format.ps1xml à la session. Elle utilise le paramètre PrependPath car le fichier contient les données de mise en forme pour les objets qui sont référencés dans les fichiers intégrés.

Après avoir ajouté le fichier NewFiles.format.ps1xml et l'avoir testé dans cette session, l'auteur le modifie.

La deuxième commande utilise l'applet de commande Update-FormatData pour recharger les fichiers de mises en forme. Étant donné que le fichier NewFiles.format.ps1xml a été précédemment chargé, Update-FormatData le recharge automatiquement sans utiliser de paramètres.