À propos des variables de préférenceAbout Preference Variables

Description courteShort description

Variables qui personnalisent le comportement de PowerShell.Variables that customize the behavior of PowerShell.

Description longueLong description

PowerShell comprend un ensemble de variables qui vous permettent de personnaliser son comportement.PowerShell includes a set of variables that enable you to customize its behavior. Ces variables de préférence fonctionnent comme les options des systèmes basés sur l’interface graphique.These preference variables work like the options in GUI-based systems.

Les variables de préférence affectent l’environnement d’exploitation PowerShell et toutes les commandes exécutées dans l’environnement.The preference variables affect the PowerShell operating environment and all commands run in the environment. Dans de nombreux cas, les applets de commande ont des paramètres que vous pouvez utiliser pour remplacer le comportement de préférence pour une commande spécifique.In many cases, the cmdlets have parameters that you can use to override the preference behavior for a specific command.

Le tableau suivant répertorie les variables de préférence et leurs valeurs par défaut.The following table lists the preference variables and their default values.

VariableVariable Valeur par défautDefault Value
$ConfirmPreference ÉlevéHigh
$DebugPreference SilentlyContinueSilentlyContinue
$ErrorActionPreference ContinueContinue
$ErrorView ConciseViewConciseView
$FormatEnumerationLimit 44
$InformationPreference SilentlyContinueSilentlyContinue
$LogCommandHealthEvent False (non enregistré)False (not logged)
$LogCommandLifecycleEvent False (non enregistré)False (not logged)
$LogEngineHealthEvent True (consigné)True (logged)
$LogEngineLifecycleEvent True (consigné)True (logged)
$LogProviderLifecycleEvent True (consigné)True (logged)
$LogProviderHealthEvent True (consigné)True (logged)
$MaximumHistoryCount 40964096
$OFS (Espace ( " " ))(Space character (" "))
$OutputEncoding UTF8Encoding, objetUTF8Encoding object
$ProgressPreference ContinuerContinue
$PSDefaultParameterValues (Aucune-table de hachage vide)(None - empty hash table)
$PSEmailServer (aucune)(None)
$PSModuleAutoLoadingPreference TousAll
$PSSessionApplicationName wsmanwsman
$PSSessionConfigurationName http://schemas.microsoft.com/powershell/Microsoft.PowerShell
$PSSessionOption Voir $PSSessionOptionSee $PSSessionOption
$Transcript (aucun)(none)
$VerbosePreference SilentlyContinueSilentlyContinue
$WarningPreference ContinueContinue
$WhatIfPreference FalseFalse

PowerShell comprend les variables d’environnement suivantes qui stockent les préférences de l’utilisateur.PowerShell includes the following environment variables that store user preferences. Pour plus d’informations sur ces variables d’environnement, consultez about_Environment_Variables.For more information about these environment variables, see about_Environment_Variables.

  • env:PSExecutionPolicyPreference
  • $env:PSModulePath

Notes

Les modifications apportées à la variable de préférence prennent effet uniquement dans les scripts et les fonctions si ces scripts ou fonctions sont définis dans la même portée que l’étendue dans laquelle la préférence a été utilisée.Changes to preference variable only take effect in scripts and functions if those scripts or functions are defined in the same scope as the scope in which preference was used. Pour plus d’informations, consultez about_Scopes.For more information, see about_Scopes.

Utilisation des variables de préférenceWorking with preference variables

Ce document décrit chacune des variables de préférence.This document describes each of the preference variables.

Pour afficher la valeur actuelle d’une variable de préférence spécifique, tapez le nom de la variable.To display the current value of a specific preference variable, type the variable's name. Par exemple, la commande suivante affiche la $ConfirmPreference valeur de la variable.For example, the following command displays the $ConfirmPreference variable's value.

 $ConfirmPreference
High

Pour modifier la valeur d’une variable, utilisez une instruction d’assignation.To change a variable's value, use an assignment statement. Par exemple, l’instruction suivante modifie la $ConfirmPreference valeur du paramètre en moyenne .For example, the following statement changes the $ConfirmPreference parameter's value to Medium .

$ConfirmPreference = "Medium"

Les valeurs que vous définissez sont spécifiques à la session PowerShell active.The values that you set are specific to the current PowerShell session. Pour rendre les variables effectives dans toutes les sessions PowerShell, ajoutez-les à votre profil PowerShell.To make variables effective in all PowerShell sessions, add them to your PowerShell profile. Pour plus d’informations, consultez about_Profiles.For more information, see about_Profiles.

Travailler à distanceWorking remotely

Lorsque vous exécutez des commandes sur un ordinateur distant, les commandes à distance sont soumises uniquement aux préférences définies dans le client PowerShell de l’ordinateur distant.When you run commands on a remote computer, the remote commands are only subject to the preferences set in the remote computer's PowerShell client. Par exemple, lorsque vous exécutez une commande distante, la valeur de la variable de l’ordinateur distant $DebugPreference détermine la manière dont PowerShell répond aux messages de débogage.For example, when you run a remote command, the value of the remote computer's $DebugPreference variable determines how PowerShell responds to debugging messages.

Pour plus d’informations sur les commandes distantes, consultez about_Remote.For more information about remote commands, see about_Remote.

$ConfirmPreference$ConfirmPreference

Détermine si PowerShell vous invite automatiquement à confirmer l’exécution d’une applet de commande ou d’une fonction.Determines whether PowerShell automatically prompts you for confirmation before running a cmdlet or function.

Les $ConfirmPreference valeurs valides de la variable sont haute , moyenne ou faible .The $ConfirmPreference variable's valid values are High , Medium , or Low . Les applets de commande et les fonctions se voient attribuer un risque de haute , moyenne ou faible .Cmdlets and functions are assigned a risk of High , Medium , or Low . Lorsque la valeur de la $ConfirmPreference variable est inférieure ou égale au risque affecté à une applet de commande ou à une fonction, PowerShell vous invite automatiquement à confirmer l’exécution de l’applet de commande ou de la fonction.When the value of the $ConfirmPreference variable is less than or equal to the risk assigned to a cmdlet or function, PowerShell automatically prompts you for confirmation before running the cmdlet or function.

Si la valeur de la $ConfirmPreference variable est None , PowerShell ne vous invite jamais automatiquement à exécuter une applet de commande ou une fonction.If the value of the $ConfirmPreference variable is None , PowerShell never automatically prompts you before running a cmdlet or function.

Pour modifier le comportement de confirmation pour toutes les applets de commande et fonctions de la session, modifiez la $ConfirmPreference valeur de la variable.To change the confirming behavior for all cmdlets and functions in the session, change $ConfirmPreference variable's value.

Pour remplacer le $ConfirmPreference pour une seule commande, utilisez le paramètre Confirm d’une applet de commande ou d’une fonction.To override the $ConfirmPreference for a single command, use a cmdlet's or function's Confirm parameter. Pour demander une confirmation, utilisez -Confirm .To request confirmation, use -Confirm. Pour supprimer la confirmation, utilisez -Confirm:$false .To suppress confirmation, use -Confirm:$false.

Valeurs valides $ConfirmPreference :Valid values of $ConfirmPreference:

  • None : PowerShell n’affiche pas d’invite automatiquement.None : PowerShell doesn't prompt automatically. Pour demander la confirmation d’une commande particulière, utilisez le paramètre Confirm de l’applet de commande ou de la fonction.To request confirmation of a particular command, use the Confirm parameter of the cmdlet or function.
  • Faible : PowerShell vous invite à confirmer l’exécution des applets de commande ou des fonctions avec un risque faible, moyen ou élevé.Low : PowerShell prompts for confirmation before running cmdlets or functions with a low, medium, or high risk.
  • Moyenne : PowerShell vous invite à confirmer l’exécution des applets de commande ou des fonctions avec un risque moyen ou élevé.Medium : PowerShell prompts for confirmation before running cmdlets or functions with a medium, or high risk.
  • Élevé : PowerShell vous invite à confirmer l’exécution des applets de commande ou des fonctions présentant un risque élevé.High : PowerShell prompts for confirmation before running cmdlets or functions with a high risk.

Explication détailléeDetailed explanation

PowerShell peut vous inviter automatiquement à confirmer l’opération avant d’exécuter une action.PowerShell can automatically prompt you for confirmation before doing an action. Par exemple, quand une applet de commande ou une fonction affecte de manière significative le système pour supprimer des données ou utiliser une quantité importante de ressources système.For example, when cmdlet or function significantly affects the system to delete data or use a significant amount of system resources.

Remove-Item -Path C:\file.txt
Confirm
Are you sure you want to perform this action?
Performing operation "Remove File" on Target "C:\file.txt".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [?] Help (default is "Y"):

L’estimation du risque est un attribut de l’applet de commande ou de la fonction appelée ConfirmImpact .The estimate of the risk is an attribute of the cmdlet or function known as its ConfirmImpact . Les utilisateurs ne peuvent pas le changer.Users can't change it.

Les applets de commande et les fonctions qui peuvent présenter un risque pour le système disposent d’un paramètre Confirm que vous pouvez utiliser pour demander ou supprimer la confirmation pour une seule commande.Cmdlets and functions that might pose a risk to the system have a Confirm parameter that you can use to request or suppress confirmation for a single command.

Étant donné que la plupart des applets de commande et des fonctions utilisent la valeur de risque par défaut, ConfirmImpact , de Medium et que la valeur par défaut de $ConfirmPreference est High , la confirmation automatique se produit rarement.Because most cmdlets and functions use the default risk value, ConfirmImpact , of Medium , and the default value of $ConfirmPreference is High , automatic confirmation rarely occurs. Toutefois, vous pouvez activer la confirmation automatique en remplaçant la valeur de par $ConfirmPreference moyenne ou faible .However, you can activate automatic confirmation by changing the value of $ConfirmPreference to Medium or Low .

ExemplesExamples

Cet exemple montre l’effet de la $ConfirmPreference valeur par défaut de la variable High .This example shows the effect of the $ConfirmPreference variable's default value, High . La valeur élevée confirme uniquement les applets de commande et les fonctions à haut risque.The High value only confirms high-risk cmdlets and functions. Étant donné que la plupart des applets de commande et des fonctions sont à risque moyen, elles ne sont pas confirmées automatiquement et Remove-Item suppriment le fichier.Since most cmdlets and functions are medium risk, they aren't automatically confirmed and Remove-Item deletes the file. -ConfirmL’ajout de à la commande invite l’utilisateur à confirmer.Adding -Confirm to the command prompts the user for confirmation.

$ConfirmPreference
High
Remove-Item -Path C:\temp1.txt

Utilisez -Confirm pour demander une confirmation.Use -Confirm to request confirmation.

Remove-Item -Path C:\temp2.txt -Confirm
Confirm
Are you sure you want to perform this action?
Performing operation "Remove File" on Target "C:\temp2.txt".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All
[?] Help (default is "Y"):

L’exemple suivant montre l’effet de la modification de la valeur de $ConfirmPreference en moyenne .The following example shows the effect of changing the value of $ConfirmPreference to Medium . Étant donné que la plupart des applets de commande et des fonctions sont à risque moyen, elles sont confirmées automatiquement.Because most cmdlets and function are medium risk, they're automatically confirmed. Pour supprimer l’invite de confirmation pour une seule commande, utilisez le paramètre Confirm avec la valeur $false .To suppress the confirmation prompt for a single command, use the Confirm parameter with a value of $false.

$ConfirmPreference = "Medium"
Remove-Item -Path C:\temp2.txt
Confirm
Are you sure you want to perform this action?
Performing operation "Remove File" on Target "C:\temp2.txt".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All
[?] Help (default is "Y"):
Remove-Item -Path C:\temp3.txt -Confirm:$false

$Variable DebugPreference$DebugPreference

Détermine la manière dont PowerShell répond aux messages de débogage générés par un script, une applet de commande ou un fournisseur, ou par une Write-Debug commande sur la ligne de commande.Determines how PowerShell responds to debugging messages generated by a script, cmdlet or provider, or by a Write-Debug command at the command line.

Certaines applets de commande affichent des messages de débogage, qui sont généralement des messages techniques destinés aux programmeurs et aux professionnels du support technique.Some cmdlets display debugging messages, which are typically technical messages designed for programmers and technical support professionals. Par défaut, les messages de débogage ne sont pas affichés, mais vous pouvez afficher les messages de débogage en modifiant la valeur de $DebugPreference .By default, debugging messages aren't displayed, but you can display debugging messages by changing the value of $DebugPreference.

Vous pouvez utiliser le paramètre Common de débogage d’une applet de commande pour afficher ou masquer les messages de débogage d’une commande spécifique.You can use the Debug common parameter of a cmdlet to display or hide the debugging messages for a specific command. Pour plus d’informations, consultez about_CommonParameters.For more information, see about_CommonParameters.

Les valeurs valides sont les suivantes :The valid values are as follows:

  • Arrêter : affiche le message de débogage et arrête l’exécution.Stop : Displays the debug message and stops executing. Écrit une erreur dans la console.Writes an error to the console.
  • Rechercher : affiche le message de débogage et vous demande si vous souhaitez continuer.Inquire : Displays the debug message and asks you whether you want to continue. L’ajout du paramètre common Debug à une commande, lorsque la commande est configurée pour générer un message de débogage, remplace la valeur de la $DebugPreference variable par inquire .Adding the Debug common parameter to a command, when the command is configured to generate a debugging message, changes the value of the $DebugPreference variable to Inquire .
  • Continuer : affiche le message de débogage et poursuit l’exécution.Continue : Displays the debug message and continues with execution.
  • SilentlyContinue : (valeur par défaut) aucun effet.SilentlyContinue : (Default) No effect. Le message de débogage n’est pas affiché et l’exécution se poursuit sans interruption.The debug message isn't displayed and execution continues without interruption.

ExemplesExamples

Les exemples suivants illustrent l’effet de la modification des valeurs de $DebugPreference lorsqu’une Write-Debug commande est entrée sur la ligne de commande.The following examples show the effect of changing the values of $DebugPreference when a Write-Debug command is entered at the command line. La modification affecte tous les messages de débogage, y compris les messages générés par les applets de commande et les scripts.The change affects all debugging messages, including messages generated by cmdlets and scripts. Les exemples montrent le paramètre de débogage , qui affiche ou masque les messages de débogage associés à une commande unique.The examples show the Debug parameter, which displays or hides the debugging messages related to a single command.

Cet exemple montre l’effet de la $DebugPreference valeur par défaut de la variable, SilentlyContinue .This example shows the effect of the $DebugPreference variable's default value, SilentlyContinue . Par défaut, le Write-Debug message de débogage de l’applet de commande n’est pas affiché et le traitement continue.By default, the Write-Debug cmdlet's debug message isn't displayed and processing continues. Lorsque le paramètre de débogage est utilisé, il se substitue à la préférence pour une seule commande.When the Debug parameter is used, it overrides the preference for a single command. Le message de débogage s’affiche.The debug message is displayed.

$DebugPreference
SilentlyContinue
Write-Debug -Message "Hello, World"
Write-Debug -Message "Hello, World" -Debug
DEBUG: Hello, World

Cet exemple montre l’effet de $DebugPreference avec la valeur continue .This example shows the effect of $DebugPreference with the Continue value. Le message de débogage s’affiche et la commande continue à traiter.The debug message is displayed and the command continues to process.

$DebugPreference = "Continue"
Write-Debug -Message "Hello, World"
DEBUG: Hello, World

Cet exemple utilise le paramètre Debug avec la valeur $false pour supprimer le message d’une seule commande.This example uses the Debug parameter with a value of $false to suppress the message for a single command. Le message de débogage n’est pas affiché.The debug message isn't displayed.

Write-Debug -Message "Hello, World" -Debug:$false

Cet exemple montre l’effet de la $DebugPreference définition de la valeur d' arrêt .This example shows the effect of $DebugPreference being set to the Stop value. Le message de débogage s’affiche et la commande est arrêtée.The debug message is displayed and the command is stopped.

$DebugPreference = "Stop"
Write-Debug -Message "Hello, World"
DEBUG: Hello, World
Write-Debug : The running command stopped because the preference variable
 "DebugPreference" or common parameter is set to Stop: Hello, World
At line:1 char:1
+ Write-Debug -Message "Hello, World"

Cet exemple utilise le paramètre Debug avec la valeur $false pour supprimer le message d’une seule commande.This example uses the Debug parameter with a value of $false to suppress the message for a single command. Le message de débogage n’est pas affiché et le traitement n’est pas arrêté.The debug message isn't displayed and processing isn't stopped.

Write-Debug -Message "Hello, World" -Debug:$false

Cet exemple montre l’effet de la $DebugPreference définition de la valeur de recherche .This example shows the effect of $DebugPreference being set to the Inquire value. Le message de débogage s’affiche et l’utilisateur est invité à confirmer l’intervention.The debug message is displayed and the user is prompted for confirmation.

$DebugPreference = "Inquire"
Write-Debug -Message "Hello, World"
DEBUG: Hello, World

Confirm
Continue with this operation?
[Y] Yes  [A] Yes to All  [H] Halt Command  [?] Help (default is "Y"):

Cet exemple utilise le paramètre Debug avec la valeur $false pour supprimer le message d’une seule commande.This example uses the Debug parameter with a value of $false to suppress the message for a single command. Le message de débogage n’est pas affiché et le traitement continue.The debug message isn't displayed and processing continues.

Write-Debug -Message "Hello, World" -Debug:$false

$ErrorActionPreference$ErrorActionPreference

Détermine la manière dont PowerShell répond à une erreur sans fin d’exécution, une erreur qui n’arrête pas le traitement de l’applet de commande.Determines how PowerShell responds to a non-terminating error, an error that doesn't stop the cmdlet processing. Par exemple, sur la ligne de commande ou dans un script, une applet de commande ou un fournisseur, comme les erreurs générées par l’applet de commande Write-Error .For example, at the command line or in a script, cmdlet, or provider, such as the errors generated by the Write-Error cmdlet.

Vous pouvez utiliser le paramètre commun ErrorAction d’une applet de commande pour remplacer la préférence pour une commande spécifique.You can use a cmdlet's ErrorAction common parameter to override the preference for a specific command.

Les valeurs valides sont les suivantes :The valid values are as follows:

  • Arrêter : entrez le débogueur lorsqu’une erreur se produit ou lorsqu’une exception est levée.Break - Enter the debugger when an error occurs or when an exception is raised.
  • Continuer : (valeur par défaut) affiche le message d’erreur et poursuit l’exécution.Continue : (Default) Displays the error message and continues executing.
  • Ignorer : supprime le message d’erreur et poursuit l’exécution de la commande.Ignore : Suppresses the error message and continues to execute the command. La valeur Ignorer est destinée à une utilisation par commande, et non à une utilisation en tant que préférence enregistrée.The Ignore value is intended for per-command use, not for use as saved preference. L’option ignore n’est pas une valeur valide pour la $ErrorActionPreference variable.Ignore isn't a valid value for the $ErrorActionPreference variable.
  • Rechercher : affiche le message d’erreur et vous demande si vous souhaitez continuer.Inquire : Displays the error message and asks you whether you want to continue.
  • SilentlyContinue : aucun effet.SilentlyContinue : No effect. Le message d’erreur ne s’affiche pas et l’exécution se poursuit sans interruption.The error message isn't displayed and execution continues without interruption.
  • Arrêter : affiche le message d’erreur et arrête l’exécution.Stop : Displays the error message and stops executing. En plus de l’erreur générée, la valeur d' arrêt génère un objet ActionPreferenceStopException dans le flux d’erreurs.In addition to the error generated, the Stop value generates an ActionPreferenceStopException object to the error stream. fluxstream
  • Suspend : suspend automatiquement une tâche de workflow pour permettre une investigation plus poussée.Suspend : Automatically suspends a workflow job to allow for further investigation. Après l’examen, le flux de travail peut être repris.After investigation, the workflow can be resumed. La valeur de suspension est destinée à une utilisation par commande, et non à une utilisation en tant que préférence enregistrée.The Suspend value is intended for per-command use, not for use as saved preference. Suspend n’est pas une valeur valide pour la $ErrorActionPreference variable.Suspend isn't a valid value for the $ErrorActionPreference variable.

$ErrorActionPreference et le paramètre ErrorAction n’affectent pas la manière dont PowerShell répond aux erreurs de fin qui arrêtent le traitement des applets de commande.$ErrorActionPreference and the ErrorAction parameter don't affect how PowerShell responds to terminating errors that stop cmdlet processing. Pour plus d’informations sur le paramètre commun ErrorAction , consultez about_CommonParameters.For more information about the ErrorAction common parameter, see about_CommonParameters.

ExemplesExamples

Ces exemples illustrent l’effet des différentes valeurs de la $ErrorActionPreference variable.These examples show the effect of the different values of the $ErrorActionPreference variable. Le paramètre ErrorAction est utilisé pour remplacer la $ErrorActionPreference valeur.The ErrorAction parameter is used to override the $ErrorActionPreference value.

Cet exemple montre la $ErrorActionPreference valeur par défaut, continue .This example shows the $ErrorActionPreference default value, Continue . Une erreur sans fin d’achèvement est générée.A non-terminating error is generated. Le message s’affiche et le traitement continue.The message is displayed and processing continues.

# Change the ErrorActionPreference to 'Continue'
$ErrorActionPreference = 'Continue'
# Generate a non-terminating error and continue processing the script.
Write-Error -Message  'Test Error' ; Write-Host 'Hello World'
Write-Error: Test Error
Hello World

Cet exemple montre la $ErrorActionPreference valeur par défaut, inquire .This example shows the $ErrorActionPreference default value, Inquire . Une erreur est générée et une invite d’action s’affiche.An error is generated and a prompt for action is shown.

# Change the ErrorActionPreference to 'Inquire'
$ErrorActionPreference = 'Inquire'
Write-Error -Message 'Test Error' ; Write-Host 'Hello World'
Confirm
Test Error
[Y] Yes  [A] Yes to All  [H] Halt Command  [S] Suspend  [?] Help (default is "Y"):

Cet exemple montre l' $ErrorActionPreference ensemble de SilentlyContinue .This example shows the $ErrorActionPreference set to SilentlyContinue . Le message d’erreur est supprimé.The error message is suppressed.

# Change the ErrorActionPreference to 'SilentlyContinue'
$ErrorActionPreference = 'SilentlyContinue'
# Generate an error message
Write-Error -Message 'Test Error' ; Write-Host 'Hello World'
# Error message is suppressed and script continues processing
Hello World

Cet exemple montre le $ErrorActionPreference jeu à arrêter .This example shows the $ErrorActionPreference set to Stop . Il montre également l’objet supplémentaire généré pour la $Error variable.It also shows the extra object generated to the $Error variable.

# Change the ErrorActionPreference to 'Stop'
$ErrorActionPreference = 'Stop'
# Error message is is generated and script stops processing
Write-Error -Message 'Test Error' ; Write-Host 'Hello World'

# Show the ActionPreferenceStopException and the error generated
$Error[0]
$Error[1]
Write-Error: Test Error

ErrorRecord                 : Test Error
WasThrownFromThrowStatement : False
TargetSite                  : System.Collections.ObjectModel.Collection`1[System.Management.Automation.PSObject]
                              Invoke(System.Collections.IEnumerable)
StackTrace                  :    at System.Management.Automation.Runspaces.PipelineBase.Invoke(IEnumerable input)
                                 at Microsoft.PowerShell.Executor.ExecuteCommandHelper(Pipeline tempPipeline,
                              Exception& exceptionThrown, ExecutionOptions options)
Message                     : The running command stopped because the preference variable "ErrorActionPreference" or
                              common parameter is set to Stop: Test Error
Data                        : {System.Management.Automation.Interpreter.InterpretedFrameInfo}
InnerException              :
HelpLink                    :
Source                      : System.Management.Automation
HResult                     : -2146233087

Write-Error: Test Error

$ErrorView$ErrorView

Détermine le format d’affichage des messages d’erreur dans PowerShell.Determines the display format of error messages in PowerShell.

Les valeurs valides sont les suivantes :The valid values are as follows:

  • ConciseView : (par défaut) fournit un message d’erreur concis et une vue refactorle pour les générateurs de modules avancés.ConciseView : (Default) Provides a concise error message and a refactored view for advanced module builders. Si l’erreur provient de la ligne de commande, il s’agit d’un message d’erreur de ligne unique.If the error is from command line it's a single line error message. Dans le cas contraire, vous recevez un message d’erreur multiligne contenant l’erreur et un pointeur vers l’erreur indiquant où elle se produit sur cette ligne.Otherwise, you receive a multiline error message that contains the error and a pointer to the error showing where it occurs in that line. Si le terminal prend en charge le terminal virtuel, les codes de couleur ANSI sont utilisés pour fournir un accent sur les couleurs.If the terminal supports Virtual Terminal, then ANSI color codes are used to provide color accent. La couleur d’accentuation peut être modifiée à $Host.PrivateData.ErrorAccentColor .The Accent color can be changed at $Host.PrivateData.ErrorAccentColor. Utilisez Get-Error l’applet de commande pour obtenir une vue détaillée détaillée de l’erreur complète, y compris les exceptions internes.Use Get-Error cmdlet for a comprehensive detailed view of the fully qualified error, including inner exceptions.

    ConciseView a été ajouté dans PowerShell 7.ConciseView was added in PowerShell 7.

  • NormalView : vue détaillée conçue pour la plupart des utilisateurs.NormalView : A detailed view designed for most users. Se compose d’une description de l’erreur et du nom de l’objet impliqué dans l’erreur.Consists of a description of the error and the name of the object involved in the error.

  • CategoryView : vue succincte structurée conçue pour les environnements de production.CategoryView : A succinct, structured view designed for production environments. au format suivant :The format is as follows:

    {Category} : ({NomCible} : {TargetType}) : [{Activity}], {Reason}{Category}: ({TargetName}:{TargetType}):[{Activity}], {Reason}

Pour plus d’informations sur les champs dans CategoryView , consultez classe ErrorCategoryInfo .For more information about the fields in CategoryView , see ErrorCategoryInfo class.

ExemplesExamples

Cet exemple montre comment une erreur s’affiche lorsque la valeur de $ErrorView est la valeur par défaut, ConciseView .This example shows how an error appears when the value of $ErrorView is the default, ConciseView . Get-ChildItem est utilisé pour rechercher un répertoire inexistant.Get-ChildItem is used to find a non-existent directory.

Get-ChildItem -path 'C:\NoRealDirectory'
Get-ChildItem: Cannot find path 'C:\NoRealDirectory' because it does not exist.

Cet exemple montre comment une erreur s’affiche lorsque la valeur de $ErrorView est la valeur par défaut, ConciseView .This example shows how an error appears when the value of $ErrorView is the default, ConciseView . Script.ps1 est exécutée et génère une erreur à partir de l' Get-Item instruction.Script.ps1 is run and throws an error from Get-Item statement.

./Script.ps1
Get-Item: C:\Script.ps1
Line |
  11 | Get-Item -Path .\stuff
     | ^ Cannot find path 'C:\demo\stuff' because it does not exist.

Cet exemple montre comment une erreur s’affiche lorsque la valeur de $ErrorView est remplacée par NormalView .This example shows how an error appears when the value of $ErrorView is changed to NormalView . Get-ChildItem est utilisé pour rechercher un fichier inexistant.Get-ChildItem is used to find a non-existent file.

Get-ChildItem -Path C:\nofile.txt
Get-ChildItem : Cannot find path 'C:\nofile.txt' because it does not exist.
At line:1 char:1
+ Get-ChildItem -Path C:\nofile.txt

Cet exemple montre comment la même erreur s’affiche lorsque la valeur de $ErrorView est remplacée par CategoryView .This example shows how the same error appears when the value of $ErrorView is changed to CategoryView .

$ErrorView = "CategoryView"
Get-ChildItem -Path C:\nofile.txt
ObjectNotFound: (C:\nofile.txt:String) [Get-ChildItem], ItemNotFoundException

Cet exemple montre que la valeur de $ErrorView affecte uniquement l’affichage des erreurs.This example demonstrates that the value of $ErrorView only affects the error display. Elle ne modifie pas la structure de l’objet d’erreur stocké dans la $Error variable automatique.It doesn't change the structure of the error object that is stored in the $Error automatic variable. Pour plus d’informations sur la $Error variable automatique, consultez about_Automatic_Variables.For information about the $Error automatic variable, see about_automatic_variables.

La commande suivante prend l’objet ErrorRecord associé à l’erreur la plus récente dans le tableau d’erreurs, élément 0 , et met en forme toutes les propriétés de l’objet d’erreur dans une liste.The following command takes the ErrorRecord object associated with the most recent error in the error array, element 0 , and formats all the error object's properties in a list.

$Error[0] | Format-List -Property * -Force
PSMessageDetails      :
Exception             : System.Management.Automation.ItemNotFoundException:
                          Cannot find path 'C:\nofile.txt' because it does
                          not exist.
                        at System.Management.Automation.SessionStateInternal.
                          GetChildItems(String path, Boolean recurse, UInt32
                          depth, CmdletProviderContext context)
                        at System.Management.Automation.ChildItemCmdlet
                          ProviderIntrinsics.Get(String path, Boolean
                          recurse, UInt32 depth, CmdletProviderContext context)
                        at Microsoft.PowerShell.Commands.GetChildItemCommand.
                          ProcessRecord()
TargetObject          : C:\nofile.txt
CategoryInfo          : ObjectNotFound: (C:\nofile.txt:String) [Get-ChildItem],
                          ItemNotFoundException
FullyQualifiedErrorId : PathNotFound,
                          Microsoft.PowerShell.Commands.GetChildItemCommand
ErrorDetails          :
InvocationInfo        : System.Management.Automation.InvocationInfo
ScriptStackTrace      : at <ScriptBlock>, <No file>: line 1
PipelineIterationInfo : {0, 1}

$FormatEnumerationLimit$FormatEnumerationLimit

Détermine le nombre d’éléments énumérés inclus dans un affichage.Determines how many enumerated items are included in a display. Cette variable n’affecte pas les objets sous-jacents, mais uniquement l’affichage.This variable doesn't affect the underlying objects, only the display. Lorsque la valeur de $FormatEnumerationLimit est inférieure au nombre d’éléments énumérés, PowerShell ajoute des points de suspension ( ... ) pour indiquer les éléments qui ne sont pas affichés.When the value of $FormatEnumerationLimit is fewer than the number of enumerated items, PowerShell adds an ellipsis (...) to indicate items not shown.

Valeurs valides : entiers ( Int32 )Valid values : Integers (Int32)

Valeur par défaut : 4Default value : 4

ExemplesExamples

Cet exemple montre comment utiliser la $FormatEnumerationLimit variable pour améliorer l’affichage des éléments énumérés.This example shows how to use the $FormatEnumerationLimit variable to improve the display of enumerated items.

Dans cet exemple, la commande génère une table qui répertorie tous les services en cours d’exécution sur l’ordinateur en deux groupes : un pour les services en cours d’exécution et un pour les services arrêtés .The command in this example generates a table that lists all the services running on the computer in two groups: one for running services and one for stopped services. Elle utilise une Get-Service commande pour obtenir tous les services, puis envoie les résultats via le pipeline à l' Group-Object applet de commande, qui regroupe les résultats selon l’état du service.It uses a Get-Service command to get all the services, and then sends the results through the pipeline to the Group-Object cmdlet, which groups the results by the service status.

Le résultat est une table qui répertorie l’État dans la colonne nom et les processus dans la colonne groupe .The result is a table that lists the status in the Name column, and the processes in the Group column. Pour modifier les étiquettes de colonne, utilisez une table de hachage, consultez about_Hash_Tables.To change the column labels, use a hash table, see about_Hash_Tables. Pour plus d’informations, consultez les exemples dans format-table.For more information, see the examples in Format-Table.

Recherchez la valeur actuelle de $FormatEnumerationLimit .Find the current value of $FormatEnumerationLimit.

$FormatEnumerationLimit
4

Répertorie tous les services regroupés par État .List all services grouped by Status . Il existe un maximum de quatre services répertoriés dans la colonne groupe pour chaque État, car $FormatEnumerationLimit a la valeur 4 .There are a maximum of four services listed in the Group column for each status because $FormatEnumerationLimit has a value of 4 .

Get-Service | Group-Object -Property Status
Count  Name       Group
-----  ----       -----
60     Running    {AdtAgent, ALG, Ati HotKey Poller, AudioSrv...}
41     Stopped    {Alerter, AppMgmt, aspnet_state, ATI Smart...}

Pour augmenter le nombre d’éléments figurant dans la liste, augmentez la valeur de $FormatEnumerationLimit à 1000 .To increase the number of items listed, increase the value of $FormatEnumerationLimit to 1000 . Utilisez Get-Service et Group-Object pour afficher les services.Use Get-Service and Group-Object to display the services.

$FormatEnumerationLimit = 1000
Get-Service | Group-Object -Property Status
Count  Name       Group
-----  ----       -----
60     Running    {AdtAgent, ALG, Ati HotKey Poller, AudioSrv, BITS, CcmExec...
41     Stopped    {Alerter, AppMgmt, aspnet_state, ATI Smart, Browser, CiSvc...

Utilisez Format-Table avec le paramètre Wrap pour afficher la liste des services.Use Format-Table with the Wrap parameter to display the list of services.

Get-Service | Group-Object -Property Status | Format-Table -Wrap
Count  Name       Group
-----  ----       -----
60     Running    {AdtAgent, ALG, Ati HotKey Poller, AudioSrv, BITS, CcmExec,
                  Client for NFS, CryptSvc, DcomLaunch, Dhcp, dmserver,
                  Dnscache, ERSvc, Eventlog, EventSystem, FwcAgent, helpsvc,
                  HidServ, IISADMIN, InoRPC, InoRT, InoTask, lanmanserver,
                  lanmanworkstation, LmHosts, MDM, Netlogon, Netman, Nla,
                  NtLmSsp, PlugPlay, PolicyAgent, ProtectedStorage, RasMan,
                  RemoteRegistry, RpcSs, SamSs, Schedule, seclogon, SENS,
                  SharedAccess, ShellHWDetection, SMT PSVC, Spooler,
                  srservice, SSDPSRV, stisvc, TapiSrv, TermService, Themes,
                  TrkWks, UMWdf, W32Time, W3SVC, WebClient, winmgmt, wscsvc,
                  wuauserv, WZCSVC, zzInterix}

41     Stopped    {Alerter, AppMgmt, aspnet_state, ATI Smart, Browser, CiSvc,
                  ClipSrv, clr_optimization_v2.0.50727_32, COMSysApp,
                  CronService, dmadmin, FastUserSwitchingCompatibility,
                  HTTPFilter, ImapiService, Mapsvc, Messenger, mnmsrvc,
                  MSDTC, MSIServer, msvsmon80, NetDDE, NetDDEdsdm, NtmsSvc,
                  NVSvc, ose, RasAuto, RDSessMgr, RemoteAccess, RpcLocator,
                  SCardSvr, SwPrv, SysmonLog, TlntSvr, upnphost, UPS, VSS,
                  WmdmPmSN, Wmi, WmiApSrv, xmlprov}

$InformationPreference$InformationPreference

La $InformationPreference variable vous permet de définir les préférences de flux d’informations que vous souhaitez afficher aux utilisateurs.The $InformationPreference variable lets you set information stream preferences that you want displayed to users. Plus précisément, les messages d’information que vous avez ajoutés aux commandes ou aux scripts en ajoutant l’applet de commande Write-information .Specifically, informational messages that you added to commands or scripts by adding the Write-Information cmdlet. Si le paramètre InformationAction est utilisé, sa valeur remplace la valeur de la $InformationPreference variable.If the InformationAction parameter is used, its value overrides the value of the $InformationPreference variable. Write-Information a été introduit dans PowerShell 5,0.Write-Information was introduced in PowerShell 5.0.

Les valeurs valides sont les suivantes :The valid values are as follows:

  • Arrêter : arrête une commande ou un script à une occurrence de la Write-Information commande.Stop : Stops a command or script at an occurrence of the Write-Information command.
  • Rechercher : affiche le message d’information que vous spécifiez dans une Write-Information commande, puis vous demande si vous souhaitez continuer.Inquire : Displays the informational message that you specify in a Write-Information command, then asks whether you want to continue.
  • Continuer : affiche le message d’information et poursuit son exécution.Continue : Displays the informational message, and continues running.
  • L' interruption n’est disponible que pour les flux de travail qui ne sont pas pris en charge dans PowerShell 6 et les versions ultérieures.Suspend is only available for workflows which aren't supported in PowerShell 6 and beyond.
  • SilentlyContinue : (valeur par défaut) aucun effet.SilentlyContinue : (Default) No effect. Les messages d’information ne sont pas affichés et le script se poursuit sans interruption.The informational messages aren't displayed, and the script continues without interruption.

$Log * (événement)$Log*Event

Les variables de préférence d' **événement log *** déterminent les types d’événements qui sont écrits dans le journal des événements PowerShell dans observateur d’événements.The Log*Event preference variables determine which types of events are written to the PowerShell event log in Event Viewer. Par défaut, seuls les événements du moteur et du fournisseur sont journalisés.By default, only engine and provider events are logged. Toutefois, vous pouvez utiliser les variables de préférence d' **événement log *** pour personnaliser votre journal, comme la journalisation des événements sur les commandes.But, you can use the Log*Event preference variables to customize your log, such as logging events about commands.

Les variables de préférence d' **événement log *** sont les suivantes :The Log*Event preference variables are as follows:

  • $LogCommandHealthEvent: Journalise les erreurs et les exceptions dans l’initialisation et le traitement des commandes.$LogCommandHealthEvent: Logs errors and exceptions in command initialization and processing. La valeur par défaut est $false (non enregistré).The default is $false (not logged).
  • $LogCommandLifecycleEvent: Journalise le démarrage et l’arrêt des commandes et des pipelines de commande et des exceptions de sécurité dans la découverte des commandes.$LogCommandLifecycleEvent: Logs the starting and stopping of commands and command pipelines and security exceptions in command discovery. La valeur par défaut est $false (non enregistré).The default is $false (not logged).
  • $LogEngineHealthEvent: Journalise les erreurs et les échecs des sessions.$LogEngineHealthEvent: Logs errors and failures of sessions. La valeur par défaut est $true (journalisée).The default is $true (logged).
  • $LogEngineLifecycleEvent: Journalise l’ouverture et la fermeture des sessions.$LogEngineLifecycleEvent: Logs the opening and closing of sessions. La valeur par défaut est $true (journalisée).The default is $true (logged).
  • $LogProviderHealthEvent: Journalise des erreurs de fournisseur, telles que des erreurs de lecture et d’écriture, des erreurs de recherche et des erreurs d’appel.$LogProviderHealthEvent: Logs provider errors, such as read and write errors, lookup errors, and invocation errors. La valeur par défaut est $true (journalisée).The default is $true (logged).
  • $LogProviderLifecycleEvent: Enregistre l’ajout et la suppression des fournisseurs PowerShell.$LogProviderLifecycleEvent: Logs adding and removing of PowerShell providers. La valeur par défaut est $true (journalisée).The default is $true (logged). Pour plus d’informations sur les fournisseurs PowerShell, consultez about_Providers.For information about PowerShell providers, see about_Providers.

Pour activer un **événement log *** , tapez la variable avec la valeur $true , par exemple :To enable a Log*Event , type the variable with a value of $true, for example:

$LogCommandLifeCycleEvent = $true

Pour désactiver un type d’événement, tapez la variable avec la valeur $false , par exemple :To disable an event type, type the variable with a value of $false, for example:

$LogCommandLifeCycleEvent = $false

Les événements que vous activez sont effectifs uniquement pour la console PowerShell actuelle.The events that you enable are effective only for the current PowerShell console. Pour appliquer la configuration à toutes les consoles, enregistrez les paramètres de la variable dans votre profil PowerShell.To apply the configuration to all consoles, save the variable settings in your PowerShell profile. Pour plus d’informations, consultez about_Profiles.For more information, see about_Profiles.

$MaximumHistoryCount$MaximumHistoryCount

Détermine le nombre de commandes enregistrées dans l’historique des commandes pour la session active.Determines how many commands are saved in the command history for the current session.

Valeurs valides : 1-32768 ( Int32 )Valid values : 1 - 32768 (Int32)

Valeur par défaut : 4096Default : 4096

Pour déterminer le nombre de commandes actuellement enregistrées dans l’historique de commande, tapez :To determine the number of commands current saved in the command history, type:

(Get-History).Count

Pour afficher les commandes enregistrées dans votre historique de session, utilisez l’applet de commande Get-History .To see the commands saved in your session history, use the Get-History cmdlet. Pour plus d’informations, consultez about_History.For more information, see about_History.

$OFS$OFS

Le séparateur de champ de sortie (OFS) spécifie le caractère qui sépare les éléments d’un tableau qui est converti en chaîne.The Output Field Separator (OFS) specifies the character that separates the elements of an array that is converted to a string.

Valeurs valides : n’importe quelle chaîne.Valid values : Any string.

Valeur par défaut : espaceDefault : Space

Par défaut, la $OFS variable n’existe pas et le séparateur de fichier de sortie est un espace, mais vous pouvez ajouter cette variable et la définir sur n’importe quelle chaîne.By default, the $OFS variable doesn't exist and the output file separator is a space, but you can add this variable and set it to any string. Vous pouvez modifier la valeur de $OFS dans votre session, en tapant $OFS="<value>" .You can change the value of $OFS in your session, by typing $OFS="<value>".

Notes

Si vous prévoyez la valeur par défaut d’un espace ( " " ) dans votre script, module ou sortie de configuration, veillez à ce que la $OFS valeur par défaut n’ait pas été modifiée ailleurs dans votre code.If you're expecting the default value of a space (" ") in your script, module, or configuration output, be careful that the $OFS default value hasn't been changed elsewhere in your code.

ExemplesExamples

Cet exemple montre qu’un espace est utilisé pour séparer les valeurs lorsqu’un tableau est converti en chaîne.This example shows that a space is used to separate the values when an array is converted to a string. Dans ce cas, un tableau d’entiers est stocké dans une variable, puis la variable est convertie en chaîne.In this case, an array of integers is stored in a variable and then the variable is cast as a string.

$array = 1,2,3,4
[string]$array
1 2 3 4

Pour modifier le séparateur, ajoutez la $OFS variable en lui assignant une valeur.To change the separator, add the $OFS variable by assigning a value to it. La variable doit être nommée $OFS .The variable must be named $OFS.

$OFS = "+"
[string]$array
1+2+3+4

Pour restaurer le comportement par défaut, vous pouvez assigner un espace ( " " ) à la valeur de $OFS ou supprimer la variable.To restore the default behavior, you can assign a space (" ") to the value of $OFS or delete the variable. Les commandes suivantes suppriment la variable, puis vérifient que le séparateur est un espace.The following commands delete the variable and then verify that the separator is a space.

Remove-Variable OFS
[string]$array
1 2 3 4

$OutputEncoding$OutputEncoding

Détermine la méthode d’encodage de caractères que PowerShell utilise lorsqu’il envoie du texte à d’autres applications.Determines the character encoding method that PowerShell uses when it sends text to other applications.

Par exemple, si une application retourne des chaînes Unicode à PowerShell, vous devrez peut-être modifier la valeur en UnicodeEncoding pour envoyer correctement les caractères.For example, if an application returns Unicode strings to PowerShell, you might need to change the value to UnicodeEncoding to send the characters correctly.

Les valeurs valides sont les suivantes : objets dérivés d’une classe d’encodage, tels que ASCIIEncoding , SBCSCodePageEncoding , UTF7Encoding , UTF8Encoding , UTF32Encoding et UnicodeEncoding .The valid values are as follows: Objects derived from an Encoding class, such as ASCIIEncoding , SBCSCodePageEncoding , UTF7Encoding , UTF8Encoding , UTF32Encoding , and UnicodeEncoding .

Default : objet UTF8Encoding (System. Text. UTF8Encoding)Default : UTF8Encoding object (System.Text.UTF8Encoding)

ExemplesExamples

Cet exemple montre comment rendre la commande Windows findstr.exe fonctionner dans PowerShell sur un ordinateur localisé pour une langue qui utilise des caractères Unicode, tels que le chinois.This example shows how to make the Windows findstr.exe command work in PowerShell on a computer that is localized for a language that uses Unicode characters, such as Chinese.

La première commande recherche la valeur de $OutputEncoding .The first command finds the value of $OutputEncoding. Étant donné que la valeur est un objet d’encodage, Affichez uniquement sa propriété EncodingName .Because the value is an encoding object, display only its EncodingName property.

$OutputEncoding.EncodingName

Dans cet exemple, une commande findstr.exe est utilisée pour rechercher deux caractères chinois présents dans le Test.txt fichier.In this example, a findstr.exe command is used to search for two Chinese characters that are present in the Test.txt file. Quand cette commande findstr.exe est exécutée dans l’invite de commandes Windows ( cmd.exe ), findstr.exe recherche les caractères dans le fichier texte.When this findstr.exe command is run in the Windows Command Prompt ( cmd.exe ), findstr.exe finds the characters in the text file. Toutefois, lorsque vous exécutez la même commande findstr.exe dans PowerShell, les caractères ne sont pas trouvés, car PowerShell les envoie à findstr.exe en texte ASCII, et non en texte Unicode.However, when you run the same findstr.exe command in PowerShell, the characters aren't found because the PowerShell sends them to findstr.exe in ASCII text, instead of in Unicode text.

findstr <Unicode-characters>

Pour que la commande fonctionne dans PowerShell, définissez la valeur de la $OutputEncoding propriété OutputEncoding de la console, en fonction des paramètres régionaux sélectionnés pour Windows.To make the command work in PowerShell, set the value of $OutputEncoding to the value of the OutputEncoding property of the console, that is based on the locale selected for Windows. Étant donné que OutputEncoding est une propriété statique de la console, utilisez le double signe deux-points ( :: ) dans la commande.Because OutputEncoding is a static property of the console, use double-colons (::) in the command.

$OutputEncoding = [console]::OutputEncoding
$OutputEncoding.EncodingName
OEM United States

Après la modification de l’encodage, la commande findstr.exe recherche les caractères Unicode.After the encoding change, the findstr.exe command finds the Unicode characters.

findstr <Unicode-characters>
test.txt:         <Unicode-characters>

$ProgressPreference$ProgressPreference

Détermine la manière dont PowerShell répond aux mises à jour de progression générées par un script, une applet de commande ou un fournisseur, comme les barres de progression générées par l’applet de commande Write-Progress .Determines how PowerShell responds to progress updates generated by a script, cmdlet, or provider, such as the progress bars generated by the Write-Progress cmdlet. L' Write-Progress applet de commande crée des barres de progression qui indiquent l’état d’une commande.The Write-Progress cmdlet creates progress bars that show a command's status.

Les valeurs valides sont les suivantes :The valid values are as follows:

  • Stop : n’affiche pas la barre de progression.Stop : Doesn't display the progress bar. Au lieu de cela, il affiche un message d’erreur et arrête l’exécution.Instead, it displays an error message and stops executing.
  • Rechercher : n’affiche pas la barre de progression.Inquire : Doesn't display the progress bar. Demande l’autorisation de continuer.Prompts for permission to continue. Si vous répondez avec Y ou A , la barre de progression s’affiche.If you reply with Y or A, it displays the progress bar.
  • Continuer : (valeur par défaut) affiche la barre de progression et poursuit l’exécution.Continue : (Default) Displays the progress bar and continues with execution.
  • SilentlyContinue : exécute la commande, mais n’affiche pas la barre de progression.SilentlyContinue : Executes the command, but doesn't display the progress bar.

$PSEmailServer$PSEmailServer

Spécifie le serveur de messagerie par défaut qui est utilisé pour envoyer des messages électroniques.Specifies the default e-mail server that is used to send email messages. Cette variable de préférence est utilisée par les cmdlets qui envoient des messages électroniques, tels que l’applet de commande Send-MailMessage .This preference variable is used by cmdlets that send email, such as the Send-MailMessage cmdlet.

$PSDefaultParameterValues$PSDefaultParameterValues

Spécifie les valeurs par défaut des paramètres des applets de commande et des fonctions avancées.Specifies default values for the parameters of cmdlets and advanced functions. La valeur de $PSDefaultParameterValues est une table de hachage où la clé se compose du nom de l’applet de commande et du nom du paramètre séparés par un signe deux-points ( : ).The value of $PSDefaultParameterValues is a hash table where the key consists of the cmdlet name and parameter name separated by a colon (:). La valeur est une valeur par défaut personnalisée que vous spécifiez.The value is a custom default value that you specify.

$PSDefaultParameterValues a été introduit dans PowerShell 3,0.$PSDefaultParameterValues was introduced in PowerShell 3.0.

Pour plus d’informations sur cette variable de préférence, consultez about_Parameters_Default_Values.For more information about this preference variable, see about_Parameters_Default_Values.

$PSModuleAutoloadingPreference$PSModuleAutoloadingPreference

Active et désactive l’importation automatique de modules dans la session.Enables and disables automatic importing of modules in the session. All est la valeur par défaut.All is the default. Quelle que soit la valeur de la variable, vous pouvez utiliser import-module pour importer un module.Regardless of the variable's value, you can use Import-Module to import a module.

Les valeurs autorisées sont :Valid values are:

  • Tous : les modules sont importés automatiquement à la première utilisation.All : Modules are imported automatically on first-use. Pour importer un module, récupérez ou utilisez une commande quelconque dans le module.To import a module, get or use any command in the module. Par exemple, utilisez Get-Command.For example, use Get-Command.
  • ModuleQualified : les modules sont importés automatiquement uniquement lorsqu’un utilisateur utilise le nom qualifié du module d’une commande dans le module.ModuleQualified : Modules are imported automatically only when a user uses the module-qualified name of a command in the module. Par exemple, si l’utilisateur tape MyModule\MyCommand , PowerShell importe le module MyModule .For example, if the user types MyModule\MyCommand, PowerShell imports the MyModule module.
  • Aucun : l’importation automatique des modules est désactivée dans la session.None : Automatic importing of modules is disabled in the session. Pour importer un module, utilisez l' Import-Module applet de commande.To import a module, use the Import-Module cmdlet.

Pour plus d’informations sur l’importation automatique de modules, consultez about_Modules.For more information about automatic importing of modules, see about_Modules.

$PSSessionApplicationName$PSSessionApplicationName

Spécifie le nom d’application par défaut pour une commande à distance qui utilise la technologie Web Services for Management (WS-Management).Specifies the default application name for a remote command that uses Web Services for Management (WS-Management) technology. Pour plus d’informations, consultez à propos de Windows Remote Management.For more information, see About Windows Remote Management.

Le nom d’application par défaut du système est WSMAN , mais vous pouvez utiliser cette variable de préférence pour modifier la valeur par défaut.The system default application name is WSMAN, but you can use this preference variable to change the default.

Le nom de l’application est le dernier nœud d’un URI de connexion.The application name is the last node in a connection URI. Par exemple, le nom de l’application dans l’exemple d’URI suivant est WSMAN .For example, the application name in the following sample URI is WSMAN.

http://Server01:8080/WSMAN

Le nom de l’application par défaut est utilisé lorsque la commande distante ne spécifie pas un URI de connexion ou un nom d’application.The default application name is used when the remote command doesn't specify a connection URI or an application name.

Le service WinRM utilise le nom de l’application pour sélectionner un écouteur afin de traiter la demande de connexion.The WinRM service uses the application name to select a listener to service the connection request. La valeur du paramètre doit correspondre à la valeur de la propriété URLPrefix d’un écouteur sur l’ordinateur distant.The parameter's value should match the value of the URLPrefix property of a listener on the remote computer.

Pour remplacer la valeur système par défaut et la valeur de cette variable, et sélectionner un autre nom d’application pour une session particulière, utilisez les paramètres ConnectionUri ou applicationName des applets de commande New-PSSession, Enter-PSSessionou Invoke-Command .To override the system default and the value of this variable, and select a different application name for a particular session, use the ConnectionURI or ApplicationName parameters of the New-PSSession, Enter-PSSession, or Invoke-Command cmdlets.

La $PSSessionApplicationName variable de préférence est définie sur l’ordinateur local, mais elle spécifie un écouteur sur l’ordinateur distant.The $PSSessionApplicationName preference variable is set on the local computer, but it specifies a listener on the remote computer. Si le nom d’application que vous spécifiez n’existe pas sur l’ordinateur distant, la commande d’établissement de la session échoue.If the application name that you specify doesn't exist on the remote computer, the command to establish the session fails.

$PSSessionConfigurationName$PSSessionConfigurationName

Spécifie la configuration de session par défaut utilisée pour les sessions PSSession créés dans la session active.Specifies the default session configuration that is used for PSSessions created in the current session.

Cette variable de préférence est définie sur l’ordinateur local, mais elle spécifie une configuration de session qui se trouve sur l’ordinateur distant.This preference variable is set on the local computer, but it specifies a session configuration that's located on the remote computer.

La valeur de la $PSSessionConfigurationName variable est un URI de ressource complet.The value of the $PSSessionConfigurationName variable is a fully qualified resource URI.

La valeur par défaut http://schemas.microsoft.com/PowerShell/microsoft.PowerShell indique la configuration de session Microsoft. PowerShell sur l’ordinateur distant.The default value http://schemas.microsoft.com/PowerShell/microsoft.PowerShell indicates the Microsoft.PowerShell session configuration on the remote computer.

Si vous spécifiez uniquement un nom de configuration, l’URI de schéma suivant est ajouté :If you specify only a configuration name, the following schema URI is prepended:

http://schemas.microsoft.com/PowerShell/

Vous pouvez remplacer la valeur par défaut et sélectionner une autre configuration de session pour une session particulière à l’aide du paramètre ConfigurationName des New-PSSession applets de commande, Enter-PSSession ou Invoke-Command .You can override the default and select a different session configuration for a particular session by using the ConfigurationName parameter of the New-PSSession, Enter-PSSession, or Invoke-Command cmdlets.

Vous pouvez modifier la valeur de cette variable à tout moment.You can change the value of this variable at any time. Dans ce cas, n’oubliez pas que la configuration de session que vous sélectionnez doit exister sur l’ordinateur distant.When you do, remember that the session configuration that you select must exist on the remote computer. Si ce n’est pas le cas, la commande permettant de créer une session qui utilise la configuration de session échoue.If it doesn't, the command to create a session that uses the session configuration fails.

Cette variable de préférence ne détermine pas les configurations de sessions locales utilisées lorsque les utilisateurs distants créent une session qui se connecte à cet ordinateur.This preference variable doesn't determine which local session configurations are used when remote users create a session that connects to this computer. Toutefois, vous pouvez utiliser les autorisations pour les configurations de session locale pour déterminer les utilisateurs qui peuvent les utiliser.However, you can use the permissions for the local session configurations to determine which users may use them.

$PSSessionOption$PSSessionOption

Établit les valeurs par défaut pour les options utilisateur avancées dans une session à distance.Establishes the default values for advanced user options in a remote session. Ces préférences de l’option remplacent les valeurs par défaut du système pour les options de session.These option preferences override the system default values for session options.

La $PSSessionOption variable contient un objet PSSessionOption .The $PSSessionOption variable contains a PSSessionOption object. Pour plus d’informations, consultez System. Management. Automation. Remoting. PSSessionOption.For more information, see System.Management.Automation.Remoting.PSSessionOption. Chaque propriété de l’objet représente une option de session.Each property of the object represents a session option. Par exemple, la propriété NoCompression active la compression des données pendant la session.For example, the NoCompression property turns of data compression during the session.

Par défaut, la $PSSessionOption variable contient un objet PSSessionOption avec les valeurs par défaut pour toutes les options, comme indiqué ci-dessous.By default, the $PSSessionOption variable contains a PSSessionOption object with the default values for all options, as shown below.

MaximumConnectionRedirectionCount : 5
NoCompression                     : False
NoMachineProfile                  : False
ProxyAccessType                   : None
ProxyAuthentication               : Negotiate
ProxyCredential                   :
SkipCACheck                       : False
SkipCNCheck                       : False
SkipRevocationCheck               : False
OperationTimeout                  : 00:03:00
NoEncryption                      : False
UseUTF16                          : False
IncludePortInSPN                  : False
OutputBufferingMode               : None
Culture                           :
UICulture                         :
MaximumReceivedDataSizePerCommand :
MaximumReceivedObjectSize         : 209715200
ApplicationArguments              :
OpenTimeout                       : 00:03:00
CancelTimeout                     : 00:01:00
IdleTimeout                       : -00:00:00.0010000

Pour obtenir une description de ces options et des informations supplémentaires, consultez New-PSSessionOption.For descriptions of these options and more information, see New-PSSessionOption. Pour plus d’informations sur les commandes et les sessions à distance, consultez about_Remote et about_PSSessions.For more information about remote commands and sessions, see about_Remote and about_PSSessions.

Pour modifier la valeur de la $PSSessionOption variable de préférence, utilisez l' New-PSSessionOption applet de commande pour créer un objet PSSessionOption avec les valeurs d’option que vous préférez.To change the value of the $PSSessionOption preference variable, use the New-PSSessionOption cmdlet to create a PSSessionOption object with the option values you prefer. Enregistrez la sortie dans une variable appelée $PSSessionOption .Save the output in a variable called $PSSessionOption.

$PSSessionOption = New-PSSessionOption -NoCompression

Pour utiliser la $PSSessionOption variable de préférence dans chaque session PowerShell, ajoutez une New-PSSessionOption commande qui crée la $PSSessionOption variable à votre profil PowerShell.To use the $PSSessionOption preference variable in every PowerShell session, add a New-PSSessionOption command that creates the $PSSessionOption variable to your PowerShell profile. Pour plus d’informations, consultez about_Profiles.For more information, see about_Profiles.

Vous pouvez définir des options personnalisées pour une session à distance particulière.You can set custom options for a particular remote session. Les options que vous définissez prévalent sur les valeurs par défaut du système et sur la valeur de la $PSSessionOption variable de préférence.The options that you set take precedence over the system defaults and the value of the $PSSessionOption preference variable.

Pour définir des options de session personnalisées, utilisez l' New-PSSessionOption applet de commande pour créer un objet PSSessionOption .To set custom session options, use the New-PSSessionOption cmdlet to create a PSSessionOption object. Ensuite, utilisez l’objet PSSessionOption comme valeur du paramètre SessionOption dans les applets de commande qui créent une session, telles que New-PSSession , Enter-PSSession et Invoke-Command .Then, use the PSSessionOption object as the value of the SessionOption parameter in cmdlets that create a session, such as New-PSSession, Enter-PSSession, and Invoke-Command.

$Transcript$Transcript

Utilisé par Start-Transcript pour spécifier le nom et l’emplacement du fichier de transcription.Used by Start-Transcript to specify the name and location of the transcript file. Si vous ne spécifiez pas de valeur pour le paramètre path , Start-Transcript utilise le chemin d’accès dans la valeur de la $Transcript variable globale.If you do not specify a value for the Path parameter, Start-Transcript uses the path in the value of the $Transcript global variable. Si vous n’avez pas créé cette variable, Start-Transcript stocke les transcriptions dans le $Home\My Documents répertoire sous forme de \PowerShell_transcript.<time-stamp>.txt fichiers.If you have not created this variable, Start-Transcript stores the transcripts in the $Home\My Documents directory as \PowerShell_transcript.<time-stamp>.txt files.

$VerbosePreference$VerbosePreference

Détermine la manière dont PowerShell répond aux messages détaillés générés par un script, une applet de commande ou un fournisseur, tels que les messages générés par l’applet de commande Write-Verbose .Determines how PowerShell responds to verbose messages generated by a script, cmdlet, or provider, such as the messages generated by the Write-Verbose cmdlet. Les messages détaillés décrivent les actions effectuées pour exécuter une commande.Verbose messages describe the actions performed to execute a command.

Par défaut, les messages détaillés ne sont pas affichés, mais vous pouvez modifier ce comportement en modifiant la valeur de $VerbosePreference .By default, verbose messages aren't displayed, but you can change this behavior by changing the value of $VerbosePreference.

Vous pouvez utiliser le paramètre commun Verbose d’une applet de commande pour afficher ou masquer les messages détaillés pour une commande spécifique.You can use the Verbose common parameter of a cmdlet to display or hide the verbose messages for a specific command. Pour plus d’informations, consultez about_CommonParameters.For more information, see about_CommonParameters.

Les valeurs valides sont les suivantes :The valid values are as follows:

  • Arrêter : affiche le message détaillé et un message d’erreur, puis arrête l’exécution.Stop : Displays the verbose message and an error message and then stops executing.
  • Rechercher : affiche le message détaillé, puis affiche une invite vous demandant si vous souhaitez continuer.Inquire : Displays the verbose message and then displays a prompt that asks you whether you want to continue.
  • Continuer : affiche le message détaillé, puis poursuit l’exécution.Continue : Displays the verbose message and then continues with execution.
  • SilentlyContinue : (par défaut) n’affiche pas le message détaillé.SilentlyContinue : (Default) Doesn't display the verbose message. Continue l’exécution.Continues executing.

ExemplesExamples

Ces exemples illustrent l’effet des différentes valeurs de $VerbosePreference et le paramètre Verbose pour remplacer la valeur de préférence.These examples show the effect of the different values of $VerbosePreference and the Verbose parameter to override the preference value.

Cet exemple montre l’effet de la valeur SilentlyContinue , qui est la valeur par défaut.This example shows the effect of the SilentlyContinue value, that is the default. La commande utilise le paramètre message , mais n’écrit pas de message dans la console PowerShell.The command uses the Message parameter, but doesn't write a message to the PowerShell console.

Write-Verbose -Message "Verbose message test."

Lorsque le paramètre Verbose est utilisé, le message est écrit.When the Verbose parameter is used, the message is written.

Write-Verbose -Message "Verbose message test." -Verbose
VERBOSE: Verbose message test.

Cet exemple montre l’effet de la valeur continue .This example shows the effect of the Continue value. La $VerbosePreference variable est définie pour Continuer et le message s’affiche.The $VerbosePreference variable is set to Continue and the message is displayed.

$VerbosePreference = "Continue"
Write-Verbose -Message "Verbose message test."
VERBOSE: Verbose message test.

Cet exemple utilise le paramètre Verbose avec une valeur de $false qui remplace la valeur continue .This example uses the Verbose parameter with a value of $false that overrides the Continue value. Le message n’est pas affiché.The message isn't displayed.

Write-Verbose -Message "Verbose message test." -Verbose:$false

Cet exemple montre l’effet de la valeur d' arrêt .This example shows the effect of the Stop value. La $VerbosePreference variable est définie sur Stop et le message s’affiche.The $VerbosePreference variable is set to Stop and the message is displayed. La commande est arrêtée.The command is stopped.

$VerbosePreference = "Stop"
Write-Verbose -Message "Verbose message test."
VERBOSE: Verbose message test.
Write-Verbose : The running command stopped because the preference variable
  "VerbosePreference" or common parameter is set to Stop: Verbose message test.
At line:1 char:1
+ Write-Verbose -Message "Verbose message test."

Cet exemple utilise le paramètre Verbose avec une valeur de $false qui remplace la valeur d' arrêt .This example uses the Verbose parameter with a value of $false that overrides the Stop value. Le message n’est pas affiché.The message isn't displayed.

Write-Verbose -Message "Verbose message test." -Verbose:$false

Cet exemple montre l’effet de la valeur de recherche .This example shows the effect of the Inquire value. La $VerbosePreference variable est définie sur inquire .The $VerbosePreference variable is set to Inquire . Le message s’affiche et l’utilisateur est invité à confirmer l’intervention.The message is displayed and the user is prompted for confirmation.

$VerbosePreference = "Inquire"
Write-Verbose -Message "Verbose message test."
VERBOSE: Verbose message test.

Confirm
Continue with this operation?
[Y] Yes  [A] Yes to All  [H] Halt Command  [?] Help (default is "Y"):

Cet exemple utilise le paramètre Verbose avec une valeur de $false qui remplace la valeur de recherche .This example uses the Verbose parameter with a value of $false that overrides the Inquire value. L’utilisateur n’est pas invité et le message n’est pas affiché.The user isn't prompted and the message isn't displayed.

Write-Verbose -Message "Verbose message test." -Verbose:$false

$WarningPreference$WarningPreference

Détermine la manière dont PowerShell répond aux messages d’avertissement générés par un script, une applet de commande ou un fournisseur, tels que les messages générés par l’applet de commande Write-Warning .Determines how PowerShell responds to warning messages generated by a script, cmdlet, or provider, such as the messages generated by the Write-Warning cmdlet.

Par défaut, les messages d’avertissement s’affichent et l’exécution se poursuit, mais vous pouvez modifier ce comportement en modifiant la valeur de $WarningPreference .By default, warning messages are displayed and execution continues, but you can change this behavior by changing the value of $WarningPreference.

Vous pouvez utiliser le paramètre commun WarningAction d’une applet de commande pour déterminer comment PowerShell répond aux avertissements d’une commande particulière.You can use the WarningAction common parameter of a cmdlet to determine how PowerShell responds to warnings from a particular command. Pour plus d’informations, consultez about_CommonParameters.For more information, see about_CommonParameters.

Les valeurs valides sont les suivantes :The valid values are as follows:

  • Arrêter : affiche le message d’avertissement et un message d’erreur, puis arrête l’exécution.Stop : Displays the warning message and an error message and then stops executing.
  • Rechercher : affiche le message d’avertissement, puis demande l’autorisation de continuer.Inquire : Displays the warning message and then prompts for permission to continue.
  • Continuer : (valeur par défaut) affiche le message d’avertissement, puis continue l’exécution.Continue : (Default) Displays the warning message and then continues executing.
  • SilentlyContinue : n’affiche pas le message d’avertissement.SilentlyContinue : Doesn't display the warning message. Continue l’exécution.Continues executing.

ExemplesExamples

Ces exemples illustrent l’effet des différentes valeurs de $WarningPreference .These examples show the effect of the different values of $WarningPreference. Le paramètre WarningAction remplace la valeur de préférence.The WarningAction parameter overrides the preference value.

Cet exemple montre l’effet de la valeur par défaut, continue .This example shows the effect of the default value, Continue .

$m = "This action can delete data."
Write-Warning -Message $m
WARNING: This action can delete data.

Cet exemple utilise le paramètre WarningAction avec la valeur SilentlyContinue pour supprimer l’avertissement.This example uses the WarningAction parameter with the value SilentlyContinue to suppress the warning. Le message n’est pas affiché.The message isn't displayed.

$m = "This action can delete data."
Write-Warning -Message $m -WarningAction SilentlyContinue

Cet exemple remplace la $WarningPreference variable par la valeur SilentlyContinue .This example changes the $WarningPreference variable to the SilentlyContinue value. Le message n’est pas affiché.The message isn't displayed.

$WarningPreference = "SilentlyContinue"
$m = "This action can delete data."
Write-Warning -Message $m

Cet exemple utilise le paramètre WarningAction pour s’arrêter lorsqu’un avertissement est généré.This example uses the WarningAction parameter to stop when a warning is generated.

$m = "This action can delete data."
Write-Warning -Message $m -WarningAction Stop
WARNING: This action can delete data.
Write-Warning : The running command stopped because the preference variable
  "WarningPreference" or common parameter is set to Stop:
    This action can delete data.
At line:1 char:1
+ Write-Warning -Message $m -WarningAction Stop

Cet exemple remplace la $WarningPreference variable par la valeur de recherche .This example changes the $WarningPreference variable to the Inquire value. L’utilisateur est invité à confirmer l’intervention.The user is prompted for confirmation.

$WarningPreference = "Inquire"
$m = "This action can delete data."
Write-Warning -Message $m
WARNING: This action can delete data.

Confirm
Continue with this operation?
[Y] Yes  [A] Yes to All  [H] Halt Command  [?] Help (default is "Y"):

Cet exemple utilise le paramètre WarningAction avec la valeur SilentlyContinue .This example uses the WarningAction parameter with the value SilentlyContinue . La commande continue de s’exécuter et aucun message n’est affiché.The command continues to execute and no message is displayed.

$m = "This action can delete data."
Write-Warning -Message $m -WarningAction SilentlyContinue

Cet exemple modifie la $WarningPreference valeur en Stop .This example changes the $WarningPreference value to Stop .

$WarningPreference = "Stop"
$m = "This action can delete data."
Write-Warning -Message $m
WARNING: This action can delete data.
Write-Warning : The running command stopped because the preference variable
  "WarningPreference" or common parameter is set to Stop:
    This action can delete data.
At line:1 char:1
+ Write-Warning -Message $m

Cet exemple utilise WarningAction avec la valeur Inquiry .This example uses the WarningAction with the Inquire value. Lorsqu’un avertissement se produit, l’utilisateur est invité à entrer un message.The user is prompted when a warning occurs.

$m = "This action can delete data."
Write-Warning -Message $m -WarningAction Inquire
WARNING: This action can delete data.

Confirm
Continue with this operation?
[Y] Yes  [A] Yes to All  [H] Halt Command  [?] Help (default is "Y"):

$WhatIfPreference quand vous$WhatIfPreference

Détermine si WhatIf est activé automatiquement pour chaque commande qui le prend en charge.Determines whether WhatIf is automatically enabled for every command that supports it. Lorsque WhatIf est activé, l’applet de commande signale l’effet attendu de la commande, mais n’exécute pas la commande.When WhatIf is enabled, the cmdlet reports the expected effect of the command, but doesn't execute the command.

Les valeurs valides sont les suivantes :The valid values are as follows:

  • False ( 0 , non activé) : (valeur par défaut) WhatIf n’est pas activé automatiquement.False ( 0 , not enabled): (Default) WhatIf isn't automatically enabled. Pour l’activer manuellement, utilisez le paramètre WhatIf de l’applet de commande.To enable it manually, use the cmdlet's WhatIf parameter.
  • True ( 1 , activé) : WhatIf est activé automatiquement sur toute commande qui le prend en charge.True ( 1 , enabled): WhatIf is automatically enabled on any command that supports it. Les utilisateurs peuvent utiliser le paramètre WhatIf avec la valeur false pour le désactiver manuellement, par exemple -WhatIf:$false .Users can use the WhatIf parameter with a value of False to disable it manually, such as -WhatIf:$false.

ExemplesExamples

Ces exemples illustrent l’effet des différentes valeurs de $WhatIfPreference .These examples show the effect of the different values of $WhatIfPreference. Ils montrent comment utiliser le paramètre WhatIf pour remplacer la valeur de préférence pour une commande spécifique.They show how to use the WhatIf parameter to override the preference value for a specific command.

Cet exemple montre l’effet de la $WhatIfPreference variable définie sur la valeur par défaut, false .This example shows the effect of the $WhatIfPreference variable set to the default value, False . Utilisez Get-ChildItem pour vérifier que le fichier existe.Use Get-ChildItem to verify that the file exists. Remove-Item supprime le fichier.Remove-Item deletes the file. Une fois le fichier supprimé, vous pouvez vérifier la suppression avec Get-ChildItem .After the file is deleted, you can verify the deletion with Get-ChildItem.

Get-ChildItem -Path .\test.txt
Remove-Item -Path ./test.txt
    Directory: C:\Test

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
-a---           9/13/2019    10:53             10 test.txt
Get-ChildItem -Path .\test.txt
Get-ChildItem : Cannot find path 'C:\Test\test.txt' because it does not exist.
At line:1 char:1
+ Get-ChildItem -File test.txt

Cet exemple montre l’effet de l’utilisation du paramètre WhatIf lorsque la valeur de $WhatIfPreference est false .This example shows the effect of using the WhatIf parameter when the value of $WhatIfPreference is False .

Vérifiez que le fichier existe.Verify that the file exists.

Get-ChildItem -Path .\test2.txt
    Directory: C:\Test

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
-a---           2/28/2019    17:06             12 test2.txt

Utilisez le paramètre WhatIf pour déterminer le résultat de la tentative de suppression du fichier.Use the WhatIf parameter to determine the result of attempting to delete the file.

Remove-Item -Path .\test2.txt -WhatIf
What if: Performing the operation "Remove File" on target "C:\Test\test2.txt".

Vérifiez que le fichier n’a pas été supprimé.Verify that the file wasn't deleted.

Get-ChildItem -Path .\test2.txt
    Directory: C:\Test

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
-a---           2/28/2019    17:06             12 test2.txt

Cet exemple montre l’effet de la $WhatIfPreference variable définie sur la valeur true .This example shows the effect of the $WhatIfPreference variable set to the value, True . Lorsque vous utilisez Remove-Item pour supprimer un fichier, le chemin d’accès du fichier est affiché, mais le fichier n’est pas supprimé.When you use Remove-Item to delete a file, the file's path is displayed, but the file isn't deleted.

Tentative de suppression d’un fichier.Attempt to delete a file. Un message s’affiche à propos de ce qui se passe si Remove-Item a été exécuté, mais le fichier n’est pas supprimé.A message is displayed about what would happen if Remove-Item was run, but the file isn't deleted.

$WhatIfPreference = "True"
Remove-Item -Path .\test2.txt
What if: Performing the operation "Remove File" on target "C:\Test\test2.txt".

Utilisez Get-ChildItem pour vérifier que le fichier n’a pas été supprimé.Use Get-ChildItem to verify that the file wasn't deleted.

Get-ChildItem -Path .\test2.txt
    Directory: C:\Test

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
-a---           2/28/2019    17:06             12 test2.txt

Cet exemple montre comment supprimer un fichier lorsque la valeur de $WhatIfPreference est true .This example shows how to delete a file when the value of $WhatIfPreference is True . Elle utilise le paramètre WhatIf avec la valeur $false .It uses the WhatIf parameter with a value of $false. Utilisez Get-ChildItem pour vérifier que le fichier a été supprimé.Use Get-ChildItem to verify the file was deleted.

Remove-Item -Path .\test2.txt -WhatIf:$false
Get-ChildItem -Path .\test2.txt
Get-ChildItem : Cannot find path 'C:\Test\test2.txt' because it does not exist.
At line:1 char:1
+ Get-ChildItem -Path .\test2.txt

Voici quelques exemples de l’applet de commande Get-Process qui ne prend pas en charge WhatIf et Stop-Process qui prend en charge WhatIf .The following are examples of the Get-Process cmdlet that doesn't support WhatIf and Stop-Process that does support WhatIf . La $WhatIfPreference valeur de la variable est true .The $WhatIfPreference variable's value is True .

Get-Process ne prend pas en charge WhatIf .Get-Process doesn't support WhatIf . Lorsque la commande est exécutée, elle affiche le processus WINWORD .When the command is executed, it displays the Winword process.

Get-Process -Name Winword
 NPM(K)    PM(M)      WS(M)     CPU(s)      Id  SI ProcessName
 ------    -----      -----     ------      --  -- -----------
    130   119.84     173.38       8.39   15024   4 WINWORD

Stop-Process prend en charge WhatIf .Stop-Process does support WhatIf . Le processus WINWORD n’est pas arrêté.The Winword process isn't stopped.

Stop-Process -Name Winword
What if: Performing the operation "Stop-Process" on target "WINWORD (15024)".

Vous pouvez remplacer le comportement Stop-Process WhatIf en utilisant le paramètre WhatIf avec la valeur $false .You can override the Stop-Process WhatIf behavior by using the WhatIf parameter with a value of $false. Le processus WINWORD est arrêté.The Winword process is stopped.

Stop-Process -Name Winword -WhatIf:$false

Pour vérifier que le processus WINWORD a été arrêté, utilisez Get-Process .To verify that the Winword process was stopped, use Get-Process.

Get-Process -Name Winword
Get-Process : Cannot find a process with the name "Winword".
  Verify the process name and call the cmdlet again.
At line:1 char:1
+ Get-Process -Name Winword

Voir aussiSee also

about_Automatic_Variablesabout_Automatic_Variables

about_CommonParametersabout_CommonParameters

about_Environment_Variablesabout_Environment_Variables

about_Profilesabout_Profiles

about_Remoteabout_Remote

about_Scopesabout_Scopes

about_Variablesabout_Variables