Partager via

Show-Command

  • Référence
Module:
Microsoft.PowerShell.Utility

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

Syntaxe

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

Description

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, notamment les applets de commande, les fonctions, les flux de travail 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, à l’aide du nom ou 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.

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

Dans l’environnement de script intégré PowerShell (ISE), une variante de la Show-Command fenêtre s’affiche 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é introduite dans PowerShell 3.0.

É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 le Bureau Windows.

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 une 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 Invoke-Command de 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’appletConnect-PSSessionde commande.

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 d’erreur.

Lorsque vous cliquez sur Exécuter, la Connect-PSSession commande s’exécute, comme si vous avez tapé 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
}

À présent, 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 la sortie à une vue de grille

Cette commande montre comment utiliser les applets de commande et Out-GridView les Show-Command applets de commande 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 Get-ChildItem commande s’exécute et génère la 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 cliquez sur OK, la commande retourne la sortie indiquée ci-dessus. L’affichage de la chaîne de commande vous permet d’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

En plus d’afficher des erreurs dans une fenêtre, ErrorPopup retourne la sortie de commande à la commande active, au lieu de créer une commande. Lorsque vous exécutez cette commande, la Show-Command fenêtre s’ouvre. 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 des 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 Show-Command fenêtre génère une 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 retourne les résultats de la commande en cours, au lieu d’exécuter la commande et de renvoyer 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
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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 commande qui répertorie toutes les commandes PowerShell dans tous les modules installés sur l’ordinateur.

Type:String
Alias:CommandName
Position:0
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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 et 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
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

None

Vous ne pouvez pas diriger les objets vers cette applet de commande.

Sorties

None

Par défaut, cette applet de commande ne retourne aucune sortie.

String

Lorsque vous utilisez le paramètre PassThru , cette applet de commande retourne une chaîne de commande.

Object

Lorsque vous utilisez le paramètre ErrorPopup , cette applet de commande retourne la sortie de commande (n’importe quel objet).

Notes

Windows PowerShell inclut les alias suivants pour Show-Command:

  • shcm

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