Met en forme les objets en tant que large table qui affiche une seule propriété de chaque objet.

Syntaxe

Format-Wide [[-Property] <Object>] [-AutoSize] [-Column <int>] [-DisplayError] [-Expand <string>] [-Force] [-GroupBy <Object>] [-InputObject <psobject>] [-ShowError] [-View <string>] [<CommonParameters>]

Description

L'applet de commande Format-Wide met en forme les objets sous la forme d'un large tableau affichant une seule propriété de chaque objet. Vous pouvez utiliser le paramètre Property pour déterminer quelle propriété est affichée.

Paramètres

-AutoSize

Ajuste la taille de colonne et le nombre de colonnes en fonction de la largeur des données. Par défaut, la taille et le nombre des colonnes sont déterminés par l'affichage. Vous ne pouvez pas utiliser les paramètres AutoSize et Column dans la même commande.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Column <int>

Spécifie le nombre de colonnes dans l'affichage. Vous ne pouvez pas utiliser les paramètres AutoSize et Column dans la même commande.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-DisplayError

Affiche les erreurs à la ligne de commande.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Expand <string>

Met en forme l'objet de collection, ainsi que les objets dans la collection. Ce paramètre est conçu pour mettre en forme des objets qui prennent en charge l'interface ICollection (System.Collections). La valeur par défaut est EnumOnly.

Les valeurs valides sont :

-- EnumOnly : affiche les propriétés des objets dans la collection.

-- CoreOnly : affiche les propriétés de l'objet collection.

-- Both : affiche les propriétés de l'objet collection et les propriétés des objets de la collection.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Force

Remplace des restrictions qui empêchent la commande de réussir, simplement de manière à ce que les modifications ne compromettent pas la sécurité. Par exemple, Force remplace l'attribut de lecture seule ou crée des répertoires pour compléter un chemin d'accès aux fichiers, mais la commande ne tente pas de modifier les autorisations des fichiers.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-GroupBy <Object>

Met en forme la sortie dans les groupes selon une propriété ou une valeur partagée. Entrez une expression ou une propriété de la sortie.

La valeur du paramètre GroupBy peut être une nouvelle propriété calculée. Pour créer une propriété calculée, utilisez une table de hachage. Les clés valides sont :

-- Name (ou Label) <chaîne>

-- Expression <chaîne> ou <bloc de script>

-- FormatString <chaîne>

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-InputObject <psobject>

Spécifie les objets à mettre en forme. Entrez une variable contenant les objets, ou tapez une commande ou une expression permettant d'obtenir ces objets.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

true (ByValue)

Accepter les caractères génériques ?

false

-Property <Object>

Spécifie les propriétés d'objet qui apparaissent dans l'affichage et l'ordre dans lesquels elles apparaissent. Les caractères génériques sont autorisés.

Sans ce paramètre, les propriétés qui apparaissent dans l'affichage dépendent de l'objet qui est affiché. Le nom de paramètre (« Property ») est facultatif. Vous ne pouvez pas utiliser les paramètres Property et View dans la même commande.

La valeur du paramètre Property peut être une nouvelle propriété calculée. Pour créer une propriété calculée, utilisez une table de hachage. Les clés valides sont :

-- Expression <chaîne> ou <bloc de script>

-- FormatString <chaîne>

Obligatoire ?

false

Position ?

1

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-ShowError

Envoie des erreurs le long du pipeline.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-View <string>

Spécifie le nom d'un autre format de table ou « vue ». Vous ne pouvez pas utiliser les paramètres Property et View dans la même commande.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

<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

System.Management.Automation.PSObject

Vous pouvez diriger n'importe quel objet vers Format-Wide.

Sorties

Microsoft.PowerShell.Commands.Internal.Format

Format-Wide retourne les objets de mise en forme qui représentent le tableau.

Remarques

Vous pouvez également faire référence à Format-Wide par son alias intégré, « fw ». Pour plus d'informations, consultez about_Aliases.

Le paramètre GroupBy suppose que les objets sont triés. Avant d'utiliser Format-Custom pour grouper les objets, utilisez Sort-Object pour les trier.

Le paramètre -View permet de spécifier un autre format pour la table. Vous pouvez utiliser les affichages définis dans les fichiers *.format.PS1XML du répertoire Windows PowerShell ou vous pouvez créer vos propres affichages dans de nouveaux fichiers PS1XML et utiliser l'applet de commande Update-FormatData pour les inclure dans Windows PowerShell.

L'autre affichage pour le paramètre View doit utiliser le format tableau ; autrement, la commande échoue. Si l'autre affichage est une liste, utilisez Format-List. Si l'autre affichage n'est ni une liste ni un tableau, utilisez Format-Custom.

Exemple 1

C:\PS>get-childitem | format-wide -column 3

Description
-----------
Cette commande affiche les noms des fichiers du répertoire actif dans trois colonnes à travers l'écran. L'applet de commande Get-ChildItem obtient des objets qui représentent chaque fichier dans le répertoire. L'opérateur de pipeline (|) passe les objets de fichier le long du pipeline à Format-Wide, qui les met en forme pour la sortie. Le paramètre Column spécifie le nombre de colonnes.






Exemple 2

C:\PS>get-childitem HKCU:\software\microsoft | format-wide -property pschildname -autosize

Description
-----------
Cette commande affiche les noms de clés de Registre dans la clé HKEY_CURRENT_USER\Software\Microsoft. L'applet de commande Get-ChildItem obtient les objets qui représentent les clés. Le chemin d'accès est spécifié comme « HKCU: », l'un des lecteurs exposés par le fournisseur Registry de Windows PowerShell, suivi du chemin d'accès de la clé. L'opérateur de pipeline (|) passe les objets clés du Registre le long du pipeline à Format-Wide, qui les met en forme pour la sortie. Le paramètre Property spécifie le nom de la propriété et le paramètre AutoSize ajuste les colonnes pour la lisibilité.









Table des matières