Découvrir les paramètres d’utilisation des cmdlets PowerShell
Les paramètres modifient les actions effectuées par une applet de commande. Vous ne pouvez ne spécifier aucun paramètre, en spécifier un ou en spécifier un grand nombre pour une cmdlet.
Format de paramètre
Les noms de paramètres commencent par un tiret (-). Un espace sépare la valeur que vous souhaitez passer du nom du paramètre. Si la valeur que vous transmettez contient des espaces, vous devez placer le texte entre guillemets. Certains paramètres acceptent plusieurs valeurs que vous devez séparer par des virgules, sans espaces.
Différences entre paramètres facultatifs et paramètres obligatoires
Des paramètres peuvent être facultatifs ou obligatoires. Si un paramètre est obligatoire et que vous exécutez la cmdlet sans fournir de valeur pour ce paramètre, Windows PowerShell vous invite à fournir une valeur. Par exemple, si vous exécutez la commande Get-Item, vous recevez le message suivant de Windows PowerShell, qui inclut une invite pour fournir une valeur pour le paramètre -Path :
PS C:\> Get-Item
cmdlet Get-Item at command pipeline position 1
Supply values for the following parameters:
Path[0]:
Si vous entrez le texte C :\ à l’invite, puis appuyez deux fois sur la touche Entrée, la commande s’exécute correctement. Vous devez appuyer deux fois sur la touche Entrée, car ce paramètre peut accepter plusieurs valeurs. Windows PowerShell continuera de vous inviter à entrer une nouvelle valeur jusqu’à ce que vous appuyiez sur la touche Entrée sans l’avoir fournie.
Dans certains cas, la saisie du nom du paramètre est facultative et vous pouvez simplement entrer la valeur du paramètre. Si vous exécutez la commande Get-ChildItem C :\, elle est identique à l’exécution de la commande Get-ChildItem -Path C :\ , car le paramètre -Path est défini comme premier paramètre dans la définition de l’applet de commande. C’est ce qu’on appelle un paramètre positionnel. Vous remarquerez ces invitations tout au long de ce cours. L’omission du nom du paramètre fonctionne uniquement quand une position de paramètre a été définie. Certaines commandes n’ont pas de paramètres positionnels.
Commutateurs
Les commutateurs sont un cas spécial. Ils sont essentiellement des paramètres qui acceptent une valeur booléenne (true ou false). Ils diffèrent des paramètres booléens réels dans le fait que la valeur est définie sur true uniquement si le commutateur est inclus lors de l’exécution de la commande. Par exemple, le paramètre -Recurse ou le commutateur de l’applet de commande Get-ChildItem . La commande Get-ChildItem c :\ -Recurse retourne non seulement les éléments du répertoire C :\, mais également ceux de tous ses sous-répertoires. Sans le commutateur -Recurse , seuls les éléments du répertoire C :\ sont retournés.