Show-Command

Référence

Module:: Microsoft.PowerShell.Utility

Affiche les informations de commande PowerShell dans une fenêtre graphique.

Syntax

Show-Command
    [[-Name] <String>]
    [-Height <Double>]
    [-Width <Double>]
    [-NoCommonParameter]
    [-ErrorPopup]
    [-PassThru]
    [<CommonParameters>]

Description

Cette applet de commande est disponible uniquement sur la plateforme Windows.

L’applet Show-Command de commande vous permet de créer une commande PowerShell dans une fenêtre de commande. Vous pouvez utiliser les fonctionnalités de la fenêtre de commandes pour qu'elle exécute la commande, ou pour qu'elle vous la retourne.

Show-Command est un outil d’enseignement et d’apprentissage très utile. Show-Command fonctionne sur tous les types de commandes, y compris les applets de commande, les fonctions, les workflows et les commandes CIM.

Sans paramètres, Show-Command affiche une fenêtre de commande qui répertorie toutes les commandes disponibles dans tous les modules installés. Pour trouver les commandes d'un module, sélectionnez le module dans la liste déroulante Modules. Pour sélectionner une commande, cliquez sur son nom.

Pour utiliser la fenêtre de commande, sélectionnez une commande, soit en utilisant le Nom, soit en cliquant sur le nom de la commande dans la liste Commandes . Chaque jeu de paramètres s’affiche sous un onglet distinct. Les astérisques indiquent les paramètres obligatoires. Pour entrer des valeurs pour un paramètre, tapez la valeur dans la zone de texte ou sélectionnez la valeur dans la zone de liste déroulante. Pour ajouter un paramètre de commutateur, cliquez et cochez la case du paramètre.

Quand vous êtes prêt, cliquez sur Copy pour copier la commande que vous avez créée dans le Presse-papiers, ou cliquez sur Run pour exécuter la commande. Vous pouvez également utiliser le paramètre PassThru pour renvoyer la commande au programme hôte, comme la console PowerShell. Pour annuler la sélection de la commande et revenir à l’affichage qui affiche toutes les commandes, appuyez sur Ctrl et cliquez sur la commande sélectionnée.

Dans l’environnement ise (Integrated Scripting Environment) PowerShell, une variante de la Show-Command fenêtre est affichée par défaut. Pour plus d’informations sur l’utilisation de cette fenêtre de commande, consultez les rubriques d’aide de PowerShell ISE.

Cette applet de commande a été réintroduite dans PowerShell 7.

Étant donné que cette applet de commande nécessite une interface utilisateur, elle ne fonctionne pas sur Windows Server Core ou Windows Nano Server. Cette applet de commande est disponible uniquement sur les systèmes Windows qui prennent en charge windows Desktop.

Exemples

Exemple 1 : Ouvrir la fenêtre Commandes

Cet exemple montre comment afficher la vue par défaut de la Show-Command fenêtre. La fenêtre Commandes affiche la liste de toutes les commandes de tous les modules installés sur l’ordinateur.

Show-Command

Exemple 2 : Ouvrir une applet de commande dans la fenêtre Commandes

Cet exemple montre comment afficher l’applet de Invoke-Command commande dans la fenêtre Commande . Vous pouvez utiliser cet affichage pour exécuter Invoke-Command des commandes.

Show-Command -Name "Invoke-Command"

Exemple 3 : Ouvrir une applet de commande avec des paramètres spécifiés

Cette commande ouvre une Show-Command fenêtre pour l’applet deConnect-PSSessioncommande.

Show-Command -Name "Connect-PSSession" -Height 700 -Width 1000 -ErrorPopup

Les paramètres Height et Width spécifient la dimension de la fenêtre de commande. Le paramètre ErrorPopup affiche la fenêtre de commande error.

Quand vous cliquez sur Exécuter, la Connect-PSSession commande s’exécute, comme si vous tapiez la Connect-PSSession commande sur la ligne de commande.

Exemple 4 : Spécifier de nouvelles valeurs de paramètre par défaut pour une applet de commande

Cet exemple utilise la $PSDefaultParameterValues variable automatique pour définir de nouvelles valeurs par défaut pour les paramètres Height, Width et ErrorPopup de l’applet Show-Command de commande.

$PSDefaultParameterValues = @{
    "Show-Command:Height" = 700
    "Show-Command:Width" = 1000
    "Show-Command:ErrorPopup" = $True
}

Désormais, lorsque vous exécutez une Show-Command commande, les nouvelles valeurs par défaut sont appliquées automatiquement. Pour utiliser ces valeurs par défaut dans chaque session PowerShell, ajoutez la $PSDefaultParameterValues variable à votre profil PowerShell. Pour plus d’informations, consultez about_Profiles et about_Parameters_Default_Values.

Exemple 5 : Envoyer une sortie à un affichage grille

Cette commande montre comment utiliser les Show-Command applets de commande et Out-GridView ensemble.

Show-Command Get-ChildItem | Out-GridView

La commande utilise l’applet Show-Command de commande pour ouvrir une fenêtre de commande pour l’applet deGet-ChildItemcommande. Lorsque vous cliquez sur le bouton Exécuter , la commande s’exécute Get-ChildItem et génère une sortie. L’opérateur de pipeline ( | ) envoie la sortie de la Get-ChildItem commande à l’applet Out-GridView de commande, qui affiche la Get-ChildItem sortie dans une fenêtre interactive.

Exemple 6 : Afficher une commande que vous créez dans la fenêtre Commandes

Cet exemple montre la commande que vous avez créée dans la Show-Command fenêtre. La commande utilise le paramètre PassThru , qui retourne les Show-Command résultats dans une chaîne.

Show-Command -PassThru

Get-EventLog -LogName "Windows PowerShell" -Newest 5

Par exemple, si vous utilisez la Show-Command fenêtre pour créer une Get-EventLog commande qui obtient les cinq événements les plus récents dans le journal des événements Windows PowerShell, puis que vous cliquez sur OK, la commande retourne la sortie indiquée ci-dessus. L’affichage de la chaîne de commande vous aide à apprendre PowerShell.

Exemple 7 : Enregistrer une commande dans une variable

Cet exemple montre comment exécuter la chaîne de commande que vous obtenez lorsque vous utilisez le paramètre PassThru de l’applet Show-Command de commande. Cette stratégie vous permet de voir la commande et de l'utiliser.

$C = Show-Command -PassThru
$C
Invoke-Expression $C

Get-EventLog -LogName "PowerShell" -Newest 5

Index Time          EntryType   Source                 InstanceID Message
----- ----          ---------   ------                 ---------- -------
11520 Dec 16 16:37  Information Windows PowerShell            400 Engine state is changed from None to Available...
11519 Dec 16 16:37  Information Windows PowerShell            600 Provider "Variable" is Started. ...
11518 Dec 16 16:37  Information Windows PowerShell            600 Provider "Registry" is Started. ...
11517 Dec 16 16:37  Information Windows PowerShell            600 Provider "Function" is Started. ...
11516 Dec 16 16:37  Information Windows PowerShell            600 Provider "FileSystem" is Started. ...

La première commande utilise le paramètre PassThru de l’applet Show-Command de commande et enregistre les résultats de la commande dans la $C variable . Dans ce cas, nous utilisons la Show-Command fenêtre pour créer une Get-EventLog commande qui obtient les cinq événements les plus récents dans le journal des événements Windows PowerShell. Lorsque vous cliquez sur OK, Show-Command retourne la chaîne de commande, qui est enregistrée dans la $C variable.

Exemple 8 : Enregistrer la sortie d’une commande dans une variable

Cet exemple utilise le paramètre ErrorPopup pour enregistrer la sortie d’une commande dans une variable.

$P = Show-Command Get-Process -ErrorPopup
$P

Handles  NPM(K)    PM(K)      WS(K) VM(M)   CPU(s)     Id ProcessName
-------  ------    -----      ----- -----   ------     -- -----------
    473      33    94096     112532   709     2.06   4492 powershell

Outre l'affichage des erreurs dans une fenêtre, ErrorPopup retourne la sortie de commande dans la commande actuelle, au lieu de créer une commande. Lorsque vous exécutez cette commande, la fenêtre s’ouvre Show-Command . Vous pouvez utiliser les fonctionnalités de la fenêtre pour définir les valeurs de paramètre. Pour exécuter la commande, cliquez sur le bouton Exécuter dans la Show-Command fenêtre.

Paramètres

-ErrorPopup

Indique que l’applet de commande affiche les erreurs dans une fenêtre contextuelle, en plus de les afficher sur la ligne de commande. Par défaut, lorsqu’une commande exécutée dans une fenêtre génère une Show-Command erreur, l’erreur s’affiche uniquement sur la ligne de commande.

En outre, lorsque vous exécutez la commande (à l’aide du bouton Exécuter dans la Show-Command fenêtre), le paramètre ErrorPopup renvoie les résultats de la commande à la commande active, au lieu d’exécuter la commande et de retourner sa sortie à une nouvelle commande. Vous pouvez utiliser cette fonctionnalité pour enregistrer les résultats de la commande dans une variable.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Height

Spécifie la hauteur de la Show-Command fenêtre en pixels. Entrez une valeur comprise entre 300 et le nombre de pixels de la résolution d'écran. Si la valeur est trop grande pour afficher la fenêtre de commande à l’écran, Show-Command génère une erreur. La hauteur par défaut est de 600 pixels. Pour une Show-Command commande qui inclut le paramètre Name , la hauteur par défaut est de 300 pixels.

Type:	Double
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Affiche une fenêtre de commandes pour la commande spécifiée. Entrez le nom d’une commande, par exemple le nom d’une applet de commande, d’une fonction ou d’une commande CIM. Si vous omettez ce paramètre, Show-Command affiche une fenêtre de commandes qui répertorie toutes les commandes PowerShell dans tous les modules installés sur l’ordinateur.

Type:	String
Aliases:	CommandName
Position:	0
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoCommonParameter

Indique que cette applet de commande omet la section Paramètres communs de l’affichage de la commande. Par défaut, les paramètres communs apparaissent dans une section extensible en bas de la fenêtre de commandes.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

Retourne un objet représentant l’élément que vous utilisez. Par défaut, cette applet de commande ne génère aucun résultat. Pour exécuter la chaîne de commande, copiez-collez-la à l’invite de commandes ou enregistrez-la dans une variable et utilisez l’applet Invoke-Expression de commande pour exécuter la chaîne dans la variable.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Width

Spécifie la largeur de la Show-Command fenêtre en pixels. Entrez une valeur comprise entre 300 et le nombre de pixels de la résolution d'écran. Si la valeur est trop grande pour afficher la fenêtre de commande à l’écran, Show-Command génère une erreur. La largeur par défaut est de 300 pixels.

Type:	Double
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Entrées

None

Vous ne pouvez pas diriger l’entrée vers Show-Command.

Sorties

None, System.String, System.Object

Lorsque vous utilisez le paramètre PassThru , Show-Command retourne une chaîne de commande. Lorsque vous utilisez le paramètre ErrorPopup , Show-Command retourne la sortie de la commande (n’importe quel objet). Sinon, Show-Command ne génère aucune sortie.

Notes

Cette applet de commande est disponible uniquement sur les plateformes Windows.

Show-Command ne fonctionne pas dans les sessions à distance.

Partager via