Partager via

Get-Help

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

Affiche des informations sur les commandes et les concepts PowerShell.

Syntaxe

Get-Help
   [[-Name] <String>]
   [-Path <String>]
   [-Category <String[]>]
   [-Component <String[]>]
   [-Functionality <String[]>]
   [-Role <String[]>]
   [-Full]
   [<CommonParameters>]
Get-Help
   [[-Name] <String>]
   -Detailed
   [-Path <String>]
   [-Category <String[]>]
   [-Component <String[]>]
   [-Functionality <String[]>]
   [-Role <String[]>]
   [<CommonParameters>]
Get-Help
   [[-Name] <String>]
   -Examples
   [-Path <String>]
   [-Category <String[]>]
   [-Component <String[]>]
   [-Functionality <String[]>]
   [-Role <String[]>]
   [<CommonParameters>]
Get-Help
   [[-Name] <String>]
   -Parameter <String>
   [-Path <String>]
   [-Category <String[]>]
   [-Component <String[]>]
   [-Functionality <String[]>]
   [-Role <String[]>]
   [<CommonParameters>]
Get-Help
   [[-Name] <String>]
   -Online
   [-Path <String>]
   [-Category <String[]>]
   [-Component <String[]>]
   [-Functionality <String[]>]
   [-Role <String[]>]
   [<CommonParameters>]
Get-Help
   [[-Name] <String>]
   -ShowWindow
   [-Path <String>]
   [-Category <String[]>]
   [-Component <String[]>]
   [-Functionality <String[]>]
   [-Role <String[]>]
   [<CommonParameters>]

Description

L’applet de commande Get-Help affiche des informations sur les concepts et les commandes PowerShell, notamment les applets de commande, les fonctions, les commandes CIM (Common Information Model), les flux de travail, les fournisseurs, les alias et les scripts.

Pour obtenir de l’aide pour une applet de commande PowerShell, tapez Get-Help suivi du nom de l’applet de commande, par exemple : Get-Help Get-Process.

Les articles d’aide conceptuelle dans PowerShell commencent par about_, tels que about_Comparison_Operators. Pour afficher tous les articles about_, tapez Get-Help about_*. Pour afficher un article particulier, tapez Get-Help about_<article-name>, par exemple Get-Help about_Comparison_Operators.

Pour obtenir de l’aide pour un fournisseur PowerShell, tapez Get-Help suivi du nom du fournisseur. Par exemple, pour obtenir de l’aide pour le fournisseur de certificats, tapez Get-Help Certificate.

Vous pouvez également taper help ou man, qui affiche un écran de texte à la fois. Ou, <cmdlet-name> -?, qui est identique à Get-Help, mais fonctionne uniquement pour les applets de commande.

Get-Help obtient le contenu d’aide qu’il affiche à partir de fichiers d’aide sur votre ordinateur. Sans les fichiers d’aide, Get-Help affiche uniquement des informations de base sur les applets de commande. Certains modules PowerShell incluent des fichiers d’aide. À compter de PowerShell 3.0, les modules fournis avec le système d’exploitation Windows n’incluent pas de fichiers d’aide. Pour télécharger ou mettre à jour les fichiers d’aide d’un module dans PowerShell 3.0, utilisez l’applet de commande Update-Help.

Vous pouvez également afficher les documents d’aide PowerShell en ligne dans Microsoft Docs. Pour obtenir la version en ligne d’un fichier d’aide, utilisez le paramètre Online, tel que : Get-Help Get-Process -Online. Pour lire toutes les documentations PowerShell, consultez la documentation Microsoft Docs PowerShell.

Si vous tapez Get-Help suivi du nom exact d’un article d’aide ou d’un mot unique pour un article d’aide, Get-Help affiche le contenu de l’article. Si vous entrez un mot ou un modèle de mot qui apparaît dans plusieurs titres d’article d’aide, Get-Help affiche une liste des titres correspondants. Si vous entrez un mot qui n’apparaît dans aucun titre d’article d’aide, Get-Help affiche une liste d’articles qui incluent ce mot dans son contenu.

Get-Help pouvez obtenir des articles d’aide pour toutes les langues et paramètres régionaux pris en charge. Get-Help recherche d’abord des fichiers d’aide dans les paramètres régionaux définis pour Windows, puis dans les paramètres régionaux parents, tels que pt pour pt-BR, puis dans les paramètres régionaux de secours. À compter de PowerShell 3.0, si Get-Help ne trouve pas d’aide dans les paramètres régionaux de secours, il recherche des articles d’aide en anglais, en-US, avant de renvoyer un message d’erreur ou d’afficher l’aide générée automatiquement.

Pour plus d’informations sur les symboles qui Get-Help s’affichent dans le diagramme de syntaxe de commande, consultez about_Command_Syntax. Pour plus d’informations sur les attributs de paramètre, tels que Obligatoire et Position, consultez about_Parameters.

Note

Dans PowerShell 3.0 et PowerShell 4.0, Get-Help ne trouve pas À propos des articles dans les modules, sauf si le module est importé dans la session active. Il s’agit d’un problème connu. Pour obtenir À propos de articles d’un module, importez le module, à l’aide de l’applet de commande Import-Module ou en exécutant une applet de commande incluse dans le module.

Exemples

Exemple 1 : Afficher des informations d’aide de base sur une applet de commande

Ces exemples affichent des informations d’aide de base sur l’applet de commande Format-Table.

Get-Help Format-Table
Get-Help -Name Format-Table
Format-Table -?

Get-Help <cmdlet-name> est la syntaxe la plus simple et la plus simple et par défaut de l’applet de commande Get-Help. Vous pouvez omettre le paramètre Name.

La syntaxe <cmdlet-name> -? fonctionne uniquement pour les applets de commande.

Exemple 2 : Afficher des informations de base d’une page à la fois

Ces exemples affichent des informations d’aide de base sur l’applet de commande Format-Table une page à la fois.

help Format-Table
man Format-Table
Get-Help Format-Table | Out-Host -Paging

help est une fonction qui exécute Get-Help applet de commande en interne et affiche le résultat d’une page à la fois.

man est un alias pour la fonction help.

Get-Help Format-Table envoie l’objet vers le bas du pipeline. Out-Host -Paging reçoit la sortie du pipeline et l’affiche une page à la fois. Pour plus d’informations, consultez Out-Host .

Exemple 3 : Afficher plus d’informations pour une applet de commande

Ces exemples affichent des informations d’aide plus détaillées sur l’applet de commande Format-Table.

Get-Help Format-Table -Detailed
Get-Help Format-Table -Full

Le paramètre de détaillé affiche la vue détaillée de l’article d’aide qui inclut des descriptions et des exemples de paramètres.

Le paramètre full affiche l’affichage complet de l’article d’aide qui inclut des descriptions de paramètres, des exemples, des types d’objets d’entrée et de sortie et des notes supplémentaires.

Les paramètres détaillé et complets sont effectifs uniquement pour les commandes sur utilisant des fichiers d’aide installés sur l’ordinateur. Les paramètres ne sont pas efficaces pour les articles d’aide conceptuels (about_).

Exemple 4 : Afficher les parties sélectionnées d’une applet de commande à l’aide de paramètres

Ces exemples affichent les parties sélectionnées de l’aide de l’applet de commande Format-Table.

Get-Help Format-Table -Examples
Get-Help Format-Table -Parameter *
Get-Help Format-Table -Parameter GroupBy

Le paramètre Examples affiche les sections NAME et SYNOPSIS du fichier d’aide, ainsi que tous les exemples. Vous ne pouvez pas spécifier un numéro d’exemple, car le paramètre Exemples est un paramètre switch.

Le paramètre paramètre affiche uniquement les descriptions des paramètres spécifiés. Si vous spécifiez uniquement le caractère générique astérisque (*), il affiche les descriptions de tous les paramètres. Lorsque Paramètre spécifie un nom de paramètre tel que GroupBy, des informations sur ce paramètre sont affichées.

Ces paramètres ne sont pas efficaces pour les articles d’aide conceptuels (about_).

Exemple 5 : Afficher la version en ligne de l’aide

Cet exemple montre comment afficher la version en ligne de l’article d’aide de l’applet de commande Format-Table dans votre navigateur web par défaut.

Get-Help Format-Table -Online

Exemple 6 : Afficher l’aide sur le système d’aide

L’applet de commande Get-Help sans paramètres affiche des informations sur le système d’aide PowerShell.

Get-Help

Exemple 7 : Afficher les articles d’aide disponibles

Cet exemple affiche la liste de tous les articles d’aide disponibles sur votre ordinateur.

Get-Help *

Exemple 8 : Afficher une liste d’articles conceptuels

Cet exemple montre comment afficher la liste des articles conceptuels inclus dans l’aide de PowerShell. Tous ces articles commencent par les caractères about_. Pour afficher un fichier d’aide particulier, tapez Get-Help \<about_article-name\>, par exemple, Get-Help about_Signing.

Seuls les articles conceptuels sur utilisant des fichiers d’aide installés sur votre ordinateur sont affichés. Pour plus d’informations sur le téléchargement et l’installation de fichiers d’aide dans PowerShell 3.0, consultez Update-Help .

Get-Help about_*

Exemple 9 : Rechercher un mot dans l’aide de l’applet de commande

Cet exemple montre comment rechercher un mot dans un article d’aide sur l’applet de commande.

Get-Help Add-Member -Full | Out-String -Stream | Select-String -Pattern Clixml

the Export-Clixml cmdlet to save the instance of the object, including the additional members...
can use the Import-Clixml cmdlet to re-create the instance of the object from the information...
Export-Clixml
Import-Clixml

Get-Help utilise le paramètre Full pour obtenir des informations d’aide pour Add-Member. L’objet MamlCommandHelpInfo est envoyé vers le bas du pipeline. utilise le paramètre Stream pour convertir l’objet en chaîne. utilise le paramètre pattern pour rechercher la chaîneClixml .

Exemple 10 : Afficher une liste d’articles incluant un mot

Cet exemple affiche une liste d’articles qui incluent le mot communication à distance.

Lorsque vous entrez un mot qui n’apparaît dans aucun titre d’article, Get-Help affiche une liste d’articles qui incluent ce mot.

Get-Help -Name remoting

Name                              Category  Module                    Synopsis
----                              --------  ------                    --------
Install-PowerShellRemoting.ps1    External                            Install-PowerShellRemoting.ps1
Disable-PSRemoting                Cmdlet    Microsoft.PowerShell.Core Prevents remote users...
Enable-PSRemoting                 Cmdlet    Microsoft.PowerShell.Core Configures the computer...

Exemple 11 : Afficher l’aide spécifique au fournisseur

Cet exemple montre deux façons d’obtenir l’aide spécifique au fournisseur pour Get-Item. Ces commandes obtiennent de l’aide qui explique comment utiliser l’applet de commande Get-Item dans le nœud DataCollection du fournisseur PowerShell SQL Server.

Le premier exemple utilise le paramètre Get-HelpPath pour spécifier le chemin d’accès du fournisseur SQL Server. Étant donné que le chemin d’accès du fournisseur est spécifié, vous pouvez exécuter la commande à partir de n’importe quel emplacement de chemin d’accès.

Le deuxième exemple utilise Set-Location pour accéder au chemin du fournisseur SQL Server. À partir de cet emplacement, le paramètre Path n’est pas nécessaire pour Get-Help pour obtenir l’aide spécifique au fournisseur.

Get-Help Get-Item -Path SQLSERVER:\DataCollection

NAME

    Get-Item

SYNOPSIS

    Gets a collection of Server objects for the local computer and any computers

    to which you have made a SQL Server PowerShell connection.
    ...

Set-Location SQLSERVER:\DataCollection
SQLSERVER:\DataCollection> Get-Help Get-Item

NAME

    Get-Item

SYNOPSIS

    Gets a collection of Server objects for the local computer and any computers

    to which you have made a SQL Server PowerShell connection.
    ...

Exemple 12 : Afficher l’aide d’un script

Cet exemple obtient de l’aide pour la MyScript.ps1 script. Pour plus d’informations sur l’écriture d’aide pour vos fonctions et scripts, consultez about_Comment_Based_Help.

Get-Help -Name C:\PS-Test\MyScript.ps1

Paramètres

-Category

Affiche l’aide uniquement pour les éléments de la catégorie spécifiée et leurs alias. Les articles conceptuels se trouvent dans la catégorie HelpFile .

Les valeurs acceptables pour ce paramètre sont les suivantes :

  • Alias
  • Applet de commande
  • Fournisseur
  • Généralités
  • FAQ
  • Glossaire
  • HelpFile
  • ScriptCommand
  • Fonction
  • Filtre
  • ExternalScript
  • Tout
  • DefaultHelp
  • Flux de travail
  • DscResource
  • Classe
  • Configuration
Type:String[]
Valeurs acceptées:Alias, Cmdlet, Provider, General, FAQ, Glossary, HelpFile, ScriptCommand, Function, Filter, ExternalScript, All, DefaultHelp, Workflow, DscResource, Class, Configuration
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Component

Affiche les commandes avec la valeur de composant spécifiée, par exemple Exchange. Entrez un nom de composant. Les caractères génériques sont autorisés. Ce paramètre n’a aucun effet sur les affichages d’aide conceptuelle (About_).

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:True

-Detailed

Ajoute des descriptions et des exemples de paramètres à l’affichage d’aide de base. Ce paramètre est effectif uniquement lorsque les fichiers d’aide sont installés sur l’ordinateur. Il n’a aucun effet sur les affichages de l’aide conceptuelle (About_).

Type:SwitchParameter
Position:Named
Valeur par défaut:False
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Examples

Affiche uniquement le nom, le synopsis et les exemples. Pour afficher uniquement les exemples, tapez (Get-Help \<cmdlet-name\>).Examples.

Ce paramètre est effectif uniquement lorsque les fichiers d’aide sont installés sur l’ordinateur. Il n’a aucun effet sur les affichages de l’aide conceptuelle (About_).

Type:SwitchParameter
Position:Named
Valeur par défaut:False
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Full

Affiche l’intégralité de l’article d’aide pour une applet de commande. complète comprend des descriptions de paramètres et des attributs, des exemples, des types d’objets d’entrée et de sortie, ainsi que des notes supplémentaires.

Ce paramètre est effectif uniquement lorsque les fichiers d’aide sont installés sur l’ordinateur. Il n’a aucun effet sur les affichages de l’aide conceptuelle (About_).

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

-Functionality

Affiche de l’aide pour les éléments avec la fonctionnalité spécifiée. Entrez la fonctionnalité. Les caractères génériques sont autorisés. Ce paramètre n’a aucun effet sur les affichages d’aide conceptuelle (About_).

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:True

-Name

Obtient de l’aide sur la commande ou le concept spécifié. Entrez le nom d’une applet de commande, d’une fonction, d’un fournisseur, d’un script ou d’un flux de travail, tel que Get-Member, un nom d’article conceptuel, tel que about_Objects, ou un alias, tel que ls. Les caractères génériques sont autorisés dans les noms d’applet de commande et de fournisseur, mais vous ne pouvez pas utiliser de caractères génériques pour rechercher les noms des articles d’aide sur les fonctions et les scripts d’aide.

Pour obtenir de l’aide pour un script qui n’est pas situé dans un chemin d’accès répertorié dans la variable d’environnement $env:Path, tapez le chemin d’accès et le nom du fichier du script.

Si vous entrez le nom exact d’un article d’aide, Get-Help affiche le contenu de l’article.

Si vous entrez un mot ou un modèle de mot qui apparaît dans plusieurs titres d’article d’aide, Get-Help affiche une liste des titres correspondants.

Si vous entrez un mot qui ne correspond à aucun titre d’article d’aide, Get-Help affiche une liste d’articles qui incluent ce mot dans son contenu.

Les noms des articles conceptuels, tels que about_Objects, doivent être entrés en anglais, même dans les versions non anglaises de PowerShell.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:True

-Online

Affiche la version en ligne d’un article d’aide dans le navigateur par défaut. Ce paramètre est valide uniquement pour les articles d’aide sur l’applet de commande, la fonction, le flux de travail et le script. Vous ne pouvez pas utiliser le paramètre Online avec Get-Help dans une session à distance.

Pour plus d’informations sur la prise en charge de cette fonctionnalité dans les articles d’aide que vous écrivez, consultez about_Comment_Based_Help, et prise en charge desd’aide en ligne et Écriture d’aide pour les applets de commande PowerShell.

Type:SwitchParameter
Position:Named
Valeur par défaut:False
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Parameter

Affiche uniquement les descriptions détaillées des paramètres spécifiés. Les caractères génériques sont autorisés. Ce paramètre n’a aucun effet sur les affichages d’aide conceptuelle (About_).

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:True

-Path

Obtient de l’aide qui explique le fonctionnement de l’applet de commande dans le chemin d’accès du fournisseur spécifié. Entrez un chemin d’accès du fournisseur PowerShell.

Ce paramètre obtient une version personnalisée d’un article d’aide sur l’applet de commande qui explique le fonctionnement de l’applet de commande dans le chemin d’accès du fournisseur PowerShell spécifié. Ce paramètre est efficace uniquement pour obtenir de l’aide sur une applet de commande de fournisseur et uniquement lorsque le fournisseur inclut une version personnalisée de l’article d’aide de l’applet de commande du fournisseur dans son fichier d’aide. Pour utiliser ce paramètre, installez le fichier d’aide du module qui inclut le fournisseur.

Pour afficher l’aide de l’applet de commande personnalisée pour un chemin d’accès du fournisseur, accédez à l’emplacement du chemin du fournisseur et entrez une commande Get-Help ou, à partir de n’importe quel emplacement de chemin d’accès, utilisez le paramètre Path de Get-Help pour spécifier le chemin du fournisseur. Vous pouvez également trouver de l’aide personnalisée sur les applets de commande en ligne dans la section d’aide du fournisseur des articles d’aide.

Pour plus d’informations sur les fournisseurs PowerShell, consultez about_Providers.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:True

-Role

Affiche l’aide personnalisée pour le rôle d’utilisateur spécifié. Entrez un rôle. Les caractères génériques sont autorisés.

Entrez le rôle que l’utilisateur joue dans une organisation. Certaines applets de commande affichent du texte différent dans leurs fichiers d’aide en fonction de la valeur de ce paramètre. Ce paramètre n’a aucun effet sur l’aide pour les applets de commande principales.

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:True

-ShowWindow

Affiche la rubrique d’aide dans une fenêtre pour faciliter la lecture. La fenêtre inclut une fonctionnalité de recherche Rechercher et une zone Paramètres qui vous permet de définir des options pour l’affichage, y compris les options permettant d’afficher uniquement les sections sélectionnées d’une rubrique d’aide.

Le paramètre ShowWindow prend en charge les rubriques d’aide pour les commandes (applets de commande, fonctions, commandes CIM, flux de travail, scripts) et les conceptuelles À propos de articles. Il ne prend pas en charge l’aide du fournisseur.

Ce paramètre a été introduit dans PowerShell 3.0.

Type:SwitchParameter
Position:Named
Valeur par défaut:False
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

None

Vous ne pouvez pas envoyer d’objets vers le bas du pipeline pour Get-Help.

Sorties

ExtendedCmdletHelpInfo

Si vous exécutez Get-Help sur une commande qui n’a pas de fichier d’aide, Get-Help retourne un objet ExtendedCmdletHelpInfo qui représente l’aide générée automatiquement.

String

Si vous obtenez un article d’aide conceptuelle, Get-Help le retourne sous forme de chaîne.

MamlCommandHelpInfo

Si vous obtenez une commande contenant un fichier d’aide, Get-Help retourne un objet MamlCommandHelpInfo.

Notes

PowerShell 3.0 n’inclut pas de fichiers d’aide. Pour télécharger et installer les fichiers d’aide que Get-Help lit, utilisez l’applet de commande Update-Help. Vous pouvez utiliser l’applet de commande Update-Help pour télécharger et installer des fichiers d’aide pour les commandes principales fournies avec PowerShell et pour tous les modules que vous installez. Vous pouvez également l’utiliser pour mettre à jour les fichiers d’aide afin que l’aide sur votre ordinateur ne soit jamais obsolète.

Vous pouvez également lire les articles d’aide sur les commandes fournies avec PowerShell en ligne à partir de Prise en main de Windows PowerShell.

Get-Help affiche de l’aide dans les paramètres régionaux définis pour le système d’exploitation Windows ou dans la langue de secours pour ces paramètres régionaux. Si vous n’avez pas de fichiers d’aide pour les paramètres régionaux principaux ou de secours, Get-Help se comporte comme s’il n’existe aucun fichier d’aide sur l’ordinateur. Pour obtenir de l’aide sur différents paramètres régionaux, utilisez région et de langue dans le Panneau de configuration pour modifier les paramètres. Sur Windows 10, Paramètres, heure & langue.

La vue complète de l’aide inclut une table d’informations sur les paramètres. Le tableau comprend les champs suivants :

  • Obligatoire. Indique si le paramètre est obligatoire (true) ou facultatif (false).

  • position. Indique si le paramètre est nommé ou positionnel (numérique). Les paramètres positionnels doivent apparaître à un emplacement spécifié dans la commande.

  • nommé indique que le nom du paramètre est requis, mais que le paramètre peut apparaître n’importe où dans la commande.

  • numérique indique que le nom du paramètre est facultatif, mais lorsque le nom est omis, le paramètre doit être à la place spécifiée par le nombre. Par exemple, 2 indique que lorsque le nom du paramètre est omis, le paramètre doit être le deuxième ou seul paramètre non nommé dans la commande. Lorsque le nom du paramètre est utilisé, le paramètre peut apparaître n’importe où dans la commande.

  • valeur par défaut. Valeur de paramètre ou comportement par défaut que PowerShell utilise si vous n’incluez pas le paramètre dans la commande.

  • Accepte l’entrée de pipeline. Indique si vous pouvez (true) ou ne pouvez pas (false) envoyer des objets au paramètre via un pipeline. By Property Name signifie que l’objet pipeline doit avoir une propriété portant le même nom que le nom du paramètre.

  • accepte les caractères génériques. Indique si la valeur d’un paramètre peut inclure des caractères génériques, tels qu’un astérisque (*) ou un point d’interrogation (?).