PowerShell
Paramètres communs
Recherche…
Remarques
Les paramètres communs peuvent être utilisés avec n'importe quelle applet de commande (cela signifie que dès que vous marquez votre fonction comme une applet de commande [voir CmdletBinding() ], vous obtenez tous ces paramètres gratuitement).
Voici la liste de tous les paramètres communs (l'alias est entre parenthèses après le paramètre correspondant):
-Debug (db)
-ErrorAction (ea)
-ErrorVariable (ev)
-InformationAction (ia) # introduced in v5
-InformationVariable (iv) # introduced in v5
-OutVariable (ov)
-OutBuffer (ob)
-PipelineVariable (pv)
-Verbose (vb)
-WarningAction (wa)
-WarningVariable (wv)
-WhatIf (wi)
-Confirm (cf)
Paramètre ErrorAction
Les valeurs possibles sont Continue | Ignore | Inquire | SilentlyContinue | Stop | Suspend
La valeur de ce paramètre déterminera comment l'applet de commande gérera les erreurs non terminantes (celles générées à partir de Write-Error, par exemple; pour en savoir plus sur la gestion des erreurs, voir [ rubrique non encore créée ]).
La valeur par défaut (si ce paramètre est omis) est Continue .
-ErrorAction Continue
Cette option produira un message d'erreur et continuera avec l'exécution.
PS C:\> Write-Error "test" -ErrorAction Continue ; Write-Host "Second command"
-ErrorAction Ignore
Cette option ne produira aucun message d'erreur et continuera avec l'exécution. De plus, aucune erreur ne sera ajoutée à la variable automatique $Error .
Cette option a été introduite dans v3.
PS C:\> Write-Error "test" -ErrorAction Ignore ; Write-Host "Second command"
-ErrorAction Enquête
Cette option produira un message d'erreur et invitera l'utilisateur à choisir une action à entreprendre.
PS C:\> Write-Error "test" -ErrorAction Inquire ; Write-Host "Second command"
-ErrorAction silencieusementContinuer
Cette option ne produira pas de message d'erreur et continuera avec l'exécution. Toutes les erreurs seront ajoutées à la variable automatique $Error .
PS C:\> Write-Error "test" -ErrorAction SilentlyContinue ; Write-Host "Second command"
-ErrorAction Stop
Cette option produira un message d'erreur et ne continuera pas avec l'exécution.
PS C:\> Write-Error "test" -ErrorAction Stop ; Write-Host "Second command"
-ErrorAction Suspend
Disponible uniquement dans les flux de travail Powershell. Lorsqu'il est utilisé, si la commande rencontre une erreur, le workflow est suspendu. Cela permet de rechercher une telle erreur et offre la possibilité de reprendre le workflow. Pour en savoir plus sur le système de workflow, voir [rubrique non encore créée].