Fichiers de mise en forme personnalisée

Le format d’affichage des objets retournés par des applets de commande, des fonctions et des scripts est défini à l’aide de fichiers de mise en forme (fichiersformat.ps1xml). Plusieurs de ces fichiers sont fournis par Windows PowerShell pour définir le format d’affichage par défaut pour ces objets retournés par les applets de commande Windows PowerShell. Toutefois, vous pouvez également créer vos propres fichiers de mise en forme personnalisés pour remplacer les formats d’affichage par défaut ou définir l’affichage des objets retournés par vos propres commandes.

Windows PowerShell utilise les données de ces fichiers de mise en forme pour déterminer ce qui est affiché et la façon dont les données sont mises en forme. Les données affichées peuvent inclure les propriétés d’un objet ou la valeur d’un bloc de script. Les blocs de script sont utilisés si vous souhaitez afficher une valeur qui n’est pas disponible directement à partir des propriétés d’un objet. Par exemple, vous pouvez ajouter la valeur de deux propriétés d’un objet et afficher la somme sous la forme d’un élément de données distinct. Lorsque vous écrivez votre propre fichier de mise en forme, vous devez définir vues pour les objets que vous souhaitez afficher. Vous pouvez définir une vue unique pour chaque objet, vous pouvez définir une vue unique pour plusieurs objets, ou définir plusieurs vues pour le même objet. Il n’existe aucune limite au nombre de vues que vous pouvez définir.

Important

Les fichiers de mise en forme ne déterminent pas les éléments d’un objet retournés au pipeline. Lorsqu’un objet est retourné au pipeline, tous les membres de cet objet sont disponibles.

Mettre en forme les vues

Les vues de mise en forme peuvent afficher des objets dans un format de tableau, un format de liste, un format large et un format personnalisé. Pour la plupart, chaque définition de mise en forme est décrite par un ensemble de balises XML qui décrivent une vue. Chaque vue contient le nom de la vue, les objets qui utilisent la vue et les éléments de la vue, tels que les informations de colonne et de ligne d’un affichage de table.

Les vues suivantes sont disponibles.

La vue Table répertorie les propriétés d’un objet ou d’une valeur de bloc de script dans une ou plusieurs colonnes. Chaque colonne représente une propriété de l’objet ou une valeur de bloc de script. Vous pouvez définir une vue de table qui affiche toutes les propriétés d’un objet, un sous-ensemble des propriétés d’un objet ou une combinaison de propriétés et de valeurs de bloc de script. Chaque ligne de la table représente un objet retourné. Pour plus d’informations sur cette vue, consultez vue table.

La vue Liste répertorie les propriétés d’un objet ou d’une valeur de bloc de script dans une seule colonne. Chaque ligne de la liste affiche une étiquette facultative ou le nom de propriété suivi de la valeur du bloc de propriété ou de script. Pour plus d’informations sur cette vue, consultez affichage liste.

L’affichage large répertorie une propriété unique d’un objet ou d’une valeur de bloc de script dans une ou plusieurs colonnes. Il n’y a pas d’étiquette ou d’en-tête pour cette vue. Pour plus d’informations sur cette vue, consultez 'affichage large.

La vue personnalisée affiche une vue personnalisable des propriétés d’objet ou des valeurs de bloc de script qui ne respectent pas la structure rigide des vues de table, des vues de liste ou des vues larges. Vous pouvez définir une vue personnalisée autonome ou définir un affichage personnalisé utilisé par un autre affichage, tel qu’un affichage de table ou une vue de liste. Pour plus d’informations sur cette vue, consultez vue personnalisée.

Afficher les éléments XML

L’exemple suivant montre les balises XML utilisées pour définir une vue de table qui contient deux colonnes. L’élément ViewDefinitions est l’élément conteneur de toutes les vues définies dans le fichier de mise en forme. L’élément View définit la table, la liste, l’étendue ou l’affichage personnalisé spécifiques. Dans chaque vue, l’élément Name spécifie le nom de la vue, l’élément ViewSelectedBy définit les objets qui utilisent la vue et les différents éléments de contrôle (tels que l’élément TableControl) définissent le format de la vue.

ViewDefinitions
  <View>
    <Name>Name of View</Name>
    <ViewSelectedBy>
      <TypeName>Object to display using this view</TypeName>
      <TypeName>Object to display using this view</TypeName>
    </ViewSelectedBy>
    <TableControl>
      <TableHeaders>
        <TableColumnHeader>
          <Width></Width>
        </TableColumnHeader>
        <TableColumnHeader>
          <Width></Width>
        </TableColumnHeader>
      </TableHeaders>
      <TableRowEntries>
        <TableRowEntry>
          <TableColumnItems>
            <TableColumnItem>
              <PropertyName>Header for column 1</PropertyName>
            </TableColumnItem>
            <TableColumnItem>
              <PropertyName>Header for column 2</PropertyName>
            </TableColumnItem>
          </TableColumnItems>
        </TableRowEntry>
      </TableRowEntries>
    </TableControl)
  </View>
</ViewDefinitions>

Voir aussi

vue table

affichage liste

large vue

d’affichage personnalisé

écriture d’une applet de commande Windows PowerShell