Сведения о переменных предпочтенийAbout Preference Variables

Краткое описаниеShort description

Переменные, которые настраивают поведение PowerShell.Variables that customize the behavior of PowerShell.

Подробное описаниеLong description

PowerShell включает набор переменных, которые позволяют настроить его поведение.PowerShell includes a set of variables that enable you to customize its behavior. Эти переменные предпочтений работают подобно параметрам в системах на основе графического пользовательского интерфейса.These preference variables work like the options in GUI-based systems.

Переменные предпочтений влияют на операционную среду PowerShell, и все команды выполняются в среде.The preference variables affect the PowerShell operating environment and all commands run in the environment. Во многих случаях командлеты имеют параметры, которые можно использовать для переопределения поведения предпочтений для конкретной команды.In many cases, the cmdlets have parameters that you can use to override the preference behavior for a specific command.

В следующей таблице перечислены переменные предпочтений и их значения по умолчанию.The following table lists the preference variables and their default values.

ПеременнаяVariable Значение по умолчаниюDefault Value
$ConfirmPreference ВысокийHigh
$DebugPreference SilentlyContinueSilentlyContinue
$ErrorActionPreference ContinueContinue
$ErrorView нормалвиевNormalView
$FormatEnumerationLimit 44
$InformationPreference SilentlyContinueSilentlyContinue
$LogCommandHealthEvent False (не записано в журнал)False (not logged)
$LogCommandLifecycleEvent False (не записано в журнал)False (not logged)
$LogEngineHealthEvent True (в журнале)True (logged)
$LogEngineLifecycleEvent True (в журнале)True (logged)
$LogProviderLifecycleEvent True (в журнале)True (logged)
$LogProviderHealthEvent True (в журнале)True (logged)
$MaximumAliasCount 40964096
$MaximumDriveCount 40964096
$MaximumErrorCount 256256
$MaximumFunctionCount 40964096
$MaximumHistoryCount 40964096
$MaximumVariableCount 40964096
$OFS (Символ пробела ( " " ))(Space character (" "))
$OutputEncoding Объект ASCIIEncodingASCIIEncoding object
$ProgressPreference ПродолжитьContinue
$PSDefaultParameterValues (Нет-пустая хэш-таблица)(None - empty hash table)
$PSEmailServer (нет)(None)
$PSModuleAutoLoadingPreference ВсеAll
$PSSessionApplicationName wsmanwsman
$PSSessionConfigurationName http://schemas.microsoft.com/powershell/Microsoft.PowerShell
$PSSessionOption См. $PSSessionOptionSee $PSSessionOption
$Transcript (нет)(none)
$VerbosePreference SilentlyContinueSilentlyContinue
$WarningPreference ContinueContinue
$WhatIfPreference НеверноFalse

PowerShell включает в себя следующие переменные среды, в которых хранятся пользовательские настройки.PowerShell includes the following environment variables that store user preferences. Дополнительные сведения об этих переменных среды см. в разделе about_Environment_Variables.For more information about these environment variables, see about_Environment_Variables.

  • env:PSExecutionPolicyPreference
  • $env:PSModulePath

Примечание

Изменения в привилегированной переменной вступают в силу только в скриптах и функциях, если эти скрипты или функции определены в той же области видимости, в которой использовалась предпочтение.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. Дополнительные сведения см. в разделе about_Scopes.For more information, see about_Scopes.

Работа с переменными предпочтенийWorking with preference variables

В этом документе описываются все переменные предпочтений.This document describes each of the preference variables.

Чтобы отобразить текущее значение конкретной привилегированной переменной, введите имя переменной.To display the current value of a specific preference variable, type the variable's name. Например, следующая команда отображает $ConfirmPreference значение переменной.For example, the following command displays the $ConfirmPreference variable's value.

 $ConfirmPreference
High

Чтобы изменить значение переменной, используйте инструкцию присваивания.To change a variable's value, use an assignment statement. Например, следующая инструкция изменяет $ConfirmPreference значение параметра на Medium.For example, the following statement changes the $ConfirmPreference parameter's value to Medium.

$ConfirmPreference = "Medium"

Заданные значения относятся к текущему сеансу PowerShell.The values that you set are specific to the current PowerShell session. Чтобы сделать переменные эффективными во всех сеансах PowerShell, добавьте их в профиль PowerShell.To make variables effective in all PowerShell sessions, add them to your PowerShell profile. Дополнительные сведения см. в разделе about_Profiles.For more information, see about_Profiles.

Работа в удаленном режимеWorking remotely

При выполнении команд на удаленном компьютере эти удаленные команды распространяются только на настройки, заданные в клиенте PowerShell удаленного компьютера.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. Например, при выполнении удаленной команды значение переменной удаленного компьютера $DebugPreference определяет реакцию PowerShell на отладку сообщений.For example, when you run a remote command, the value of the remote computer's $DebugPreference variable determines how PowerShell responds to debugging messages.

Дополнительные сведения об удаленных командах см. в разделе about_Remote.For more information about remote commands, see about_Remote.

$ConfirmPreference$ConfirmPreference

Определяет, будет ли PowerShell автоматически запрашивать подтверждение перед запуском командлета или функции.Determines whether PowerShell automatically prompts you for confirmation before running a cmdlet or function.

$ConfirmPreferenceДопустимые значения переменной: High , Medium или Low.The $ConfirmPreference variable's valid values are High , Medium , or Low. Командлетам и функциям назначается риск: высокий , средний или низкий.Cmdlets and functions are assigned a risk of High , Medium , or Low. Если значение $ConfirmPreference переменной меньше или равно риску, назначенному командлету или функции, PowerShell автоматически запрашивает подтверждение перед выполнением командлета или функции.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.

Если $ConfirmPreference переменная имеет значение None , PowerShell никогда не выводит запрос автоматически перед выполнением командлета или функции.If the value of the $ConfirmPreference variable is None , PowerShell never automatically prompts you before running a cmdlet or function.

Чтобы изменить поведение подтверждения для всех командлетов и функций в сеансе, измените $ConfirmPreference значение переменной.To change the confirming behavior for all cmdlets and functions in the session, change $ConfirmPreference variable's value.

Чтобы переопределить $ConfirmPreference для одной команды, используйте параметр Confirm командлета или функции.To override the $ConfirmPreference for a single command, use a cmdlet's or function's Confirm parameter. Чтобы запросить подтверждение, используйте -Confirm .To request confirmation, use -Confirm. Чтобы отключить подтверждение, используйте -Confirm:$false .To suppress confirmation, use -Confirm:$false.

Допустимые значения $ConfirmPreference :Valid values of $ConfirmPreference:

  • Нет : PowerShell не выводит запрос автоматически.None : PowerShell doesn't prompt automatically. Чтобы запросить подтверждение определенной команды, используйте параметр Confirm командлета или функции.To request confirmation of a particular command, use the Confirm parameter of the cmdlet or function.
  • Низкий : PowerShell запрашивает подтверждение перед выполнением командлетов или функций с низким, средним или высоким уровнем риска.Low : PowerShell prompts for confirmation before running cmdlets or functions with a low, medium, or high risk.
  • Средний : PowerShell запрашивает подтверждение перед выполнением командлетов или функций со средним или высоким уровнем риска.Medium : PowerShell prompts for confirmation before running cmdlets or functions with a medium, or high risk.
  • Высокий : PowerShell запрашивает подтверждение перед запуском командлетов или функций с высоким риском.High : PowerShell prompts for confirmation before running cmdlets or functions with a high risk.

Подробное описаниеDetailed explanation

PowerShell может автоматически запрашивать подтверждение перед выполнением действия.PowerShell can automatically prompt you for confirmation before doing an action. Например, если командлет или функция значительно затронет систему, чтобы удалить данные или использовать значительный объем системных ресурсов.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"):

Оценка риска — это атрибут командлета или функции, известный как его ConfirmImpact.The estimate of the risk is an attribute of the cmdlet or function known as its ConfirmImpact. Пользователи не могут изменить этот параметр.Users can't change it.

Командлеты и функции, которые могут представлять риск для системы, имеют параметр Confirm , который можно использовать для запроса или подавления подтверждения отдельной команды.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.

Так как большинство командлетов и функций используют значение риска по умолчанию ( ConfirmImpact ) Medium , а значение по умолчанию $ConfirmPreferenceHigh , возникает нередкое автоматическое подтверждение.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. Однако можно активировать автоматическое подтверждение, изменив значение $ConfirmPreference на средний или низкий.However, you can activate automatic confirmation by changing the value of $ConfirmPreference to Medium or Low.

ПримерыExamples

В этом примере показано воздействие $ConfirmPreference значения переменной по умолчанию High.This example shows the effect of the $ConfirmPreference variable's default value, High. Высокое значение служит только для подтверждения командлетов и функций с высоким риском.The High value only confirms high-risk cmdlets and functions. Поскольку большинство командлетов и функций являются средним риском, они не подтверждают и не Remove-Item удаляют файл.Since most cmdlets and functions are medium risk, they aren't automatically confirmed and Remove-Item deletes the file. -ConfirmПри добавлении команды к команде пользователю предлагается подтверждение.Adding -Confirm to the command prompts the user for confirmation.

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

Используйте -Confirm для запроса подтверждения.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  [S] Suspend
[?] Help (default is "Y"):

В следующем примере показан результат изменения значения $ConfirmPreference на Medium.The following example shows the effect of changing the value of $ConfirmPreference to Medium. Так как большинство командлетов и функций являются средним уровнем риска, они автоматически подтверждаются.Because most cmdlets and function are medium risk, they're automatically confirmed. Чтобы отключить запрос подтверждения для одной команды, используйте параметр Confirm со значением $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  [S] Suspend
[?] Help (default is "Y"):
Remove-Item -Path C:\temp3.txt -Confirm:$false

$DebugPreference$DebugPreference

Определяет реакцию PowerShell на отладку сообщений, созданных скриптом, командлетом или поставщиком, или с помощью Write-Debug команды в командной строке.Determines how PowerShell responds to debugging messages generated by a script, cmdlet or provider, or by a Write-Debug command at the command line.

Некоторые командлеты отображают сообщения об отладке, которые обычно являются техническими сообщениями, предназначенными для программистов и специалистов технической поддержки.Some cmdlets display debugging messages, which are typically technical messages designed for programmers and technical support professionals. По умолчанию сообщения отладки не отображаются, но можно отобразить сообщения отладки, изменив значение $DebugPreference .By default, debugging messages aren't displayed, but you can display debugging messages by changing the value of $DebugPreference.

Для отображения или скрытия сообщений об отладке для определенной команды можно использовать параметр отладки Common командлета.You can use the Debug common parameter of a cmdlet to display or hide the debugging messages for a specific command. См. сведения в разделе about_CommonParameters.For more information, see about_CommonParameters.

Допустимы следующие значения.The valid values are as follows:

  • Остановить : отображает сообщение отладки и прекращает выполнение.Stop : Displays the debug message and stops executing. Записывает ошибку в консоль.Writes an error to the console.
  • Запрос : отображает сообщение об отладке и спрашивает, нужно ли продолжить.Inquire : Displays the debug message and asks you whether you want to continue. Добавление общего параметра Debug к команде, если команда настроена для создания сообщения отладки, изменяет значение $DebugPreference переменной на " запрос ".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.
  • Продолжить : отображает сообщение отладки и продолжает выполнение.Continue : Displays the debug message and continues with execution.
  • SilentlyContinue : (по умолчанию) не оказывает никакого влияния.SilentlyContinue : (Default) No effect. Сообщение отладки не отображается, и выполнение продолжается без прерывания.The debug message isn't displayed and execution continues without interruption.

ПримерыExamples

В следующих примерах показан результат изменения значений $DebugPreference при Write-Debug входе команды в командную строку.The following examples show the effect of changing the values of $DebugPreference when a Write-Debug command is entered at the command line. Это изменение затрагивает все сообщения отладки, включая сообщения, созданные командлетами и скриптами.The change affects all debugging messages, including messages generated by cmdlets and scripts. В примерах показан параметр Debug , который отображает или скрывает сообщения отладки, связанные с одной командой.The examples show the Debug parameter, which displays or hides the debugging messages related to a single command.

В этом примере показано воздействие $DebugPreference значения переменной по умолчанию SilentlyContinue.This example shows the effect of the $DebugPreference variable's default value, SilentlyContinue. По умолчанию Write-Debug сообщение отладки командлета не отображается, и обработка продолжится.By default, the Write-Debug cmdlet's debug message isn't displayed and processing continues. При использовании параметра Debug он переопределяет предпочтение для одной команды.When the Debug parameter is used, it overrides the preference for a single command. Пользователю предлагается подтверждение.The user is prompted for confirmation.

$DebugPreference
SilentlyContinue
Write-Debug -Message "Hello, World"
Write-Debug -Message "Hello, World" -Debug
DEBUG: Hello, World
Confirm
Continue with this operation?
[Y] Yes  [A] Yes to All  [H] Halt Command  [S] Suspend
[?] Help (default is "Y"):

В этом примере показан результат действия $DebugPreference со значением Continue .This example shows the effect of $DebugPreference with the Continue value. Отобразится сообщение отладки, и команда продолжит обработку.The debug message is displayed and the command continues to process.

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

В этом примере используется параметр Debug со значением, $false чтобы подавить сообщение для одной команды.This example uses the Debug parameter with a value of $false to suppress the message for a single command. Сообщение отладки не отображается.The debug message isn't displayed.

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

В этом примере показано, как $DebugPreference задается значение параметра « останавливает ».This example shows the effect of $DebugPreference being set to the Stop value. Появится сообщение об отладке, и команда будет остановлена.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"

В этом примере используется параметр Debug со значением, $false чтобы подавить сообщение для одной команды.This example uses the Debug parameter with a value of $false to suppress the message for a single command. Сообщение отладки не отображается, и обработка не остановлена.The debug message isn't displayed and processing isn't stopped.

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

В этом примере показан результат $DebugPreference задания значения запроса. InquireThis example shows the effect of $DebugPreference being set to the Inquire value. Появится сообщение об отладке, и пользователю будет предложено подтвердить.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  [S] Suspend
[?] Help (default is "Y"):

В этом примере используется параметр Debug со значением, $false чтобы подавить сообщение для одной команды.This example uses the Debug parameter with a value of $false to suppress the message for a single command. Сообщение отладки не отображается, и обработка продолжится.The debug message isn't displayed and processing continues.

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

$ErrorActionPreference$ErrorActionPreference

Определяет, как PowerShell реагирует на устранимую ошибку, которая не останавливает обработку командлетов.Determines how PowerShell responds to a non-terminating error, an error that doesn't stop the cmdlet processing. Например, в командной строке или в скрипте, командлете или поставщике, например в ошибках, создаваемых 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.

Можно использовать общий параметр командлета ErrorAction , чтобы переопределить предпочтения для определенной команды.You can use a cmdlet's ErrorAction common parameter to override the preference for a specific command.

Допустимы следующие значения.The valid values are as follows:

  • Продолжить : (по умолчанию) отображает сообщение об ошибке и продолжает выполнение.Continue : (Default) Displays the error message and continues executing.
  • Ignore : подавляет вывод сообщения об ошибке и продолжение выполнения команды.Ignore : Suppresses the error message and continues to execute the command. Значение Ignore предназначено для использования в отдельных командах, а не для использования в качестве сохраненного предпочтения.The Ignore value is intended for per-command use, not for use as saved preference. Ignore не является допустимым значением для $ErrorActionPreference переменной.Ignore isn't a valid value for the $ErrorActionPreference variable.
  • Запрос : отображает сообщение об ошибке и запрашивает, нужно ли продолжить.Inquire : Displays the error message and asks you whether you want to continue.
  • SilentlyContinue : не влияет.SilentlyContinue : No effect. Сообщение об ошибке не отображается, и выполнение продолжается без прерывания.The error message isn't displayed and execution continues without interruption.
  • Остановить : отображает сообщение об ошибке и прекращает выполнение.Stop : Displays the error message and stops executing. В дополнение к созданной ошибке, значение « останавливает » создает объект актионпреференцестопексцептион для потока ошибок.In addition to the error generated, the Stop value generates an ActionPreferenceStopException object to the error stream. потокstream
  • Приостановить : автоматически приостанавливает задание рабочего процесса, чтобы обеспечить дальнейшее исследование.Suspend : Automatically suspends a workflow job to allow for further investigation. После изучения рабочий процесс можно возобновить.After investigation, the workflow can be resumed. Значение приостановки предназначено для использования в отдельных командах, а не для использования в качестве сохраненного предпочтения.The Suspend value is intended for per-command use, not for use as saved preference. Приостановка не является допустимым значением для $ErrorActionPreference переменной.Suspend isn't a valid value for the $ErrorActionPreference variable.

$ErrorActionPreference и параметр ErrorAction не влияет на то, как PowerShell реагирует на прерывание ошибок, которые останавливают обработку командлетов.$ErrorActionPreference and the ErrorAction parameter don't affect how PowerShell responds to terminating errors that stop cmdlet processing. Дополнительные сведения об общем параметре ErrorAction см. в разделе about_CommonParameters.For more information about the ErrorAction common parameter, see about_CommonParameters.

ПримерыExamples

В этих примерах показано воздействие различных значений $ErrorActionPreference переменной.These examples show the effect of the different values of the $ErrorActionPreference variable. Параметр ErrorAction используется для переопределения $ErrorActionPreference значения.The ErrorAction parameter is used to override the $ErrorActionPreference value.

В этом примере показано $ErrorActionPreference значение по умолчанию, продолжить.This example shows the $ErrorActionPreference default value, Continue. Создается устранимая ошибка.A non-terminating error is generated. Сообщение отображается и обработка продолжится.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 -Message  'Test Error' ; Write-Host 'Hello World' : Test Error
    + CategoryInfo          : NotSpecified: (:) [Write-Error], WriteErrorException
    + FullyQualifiedErrorId : Microsoft.PowerShell.Commands.WriteErrorException

Hello World

В этом примере показано $ErrorActionPreference значение по умолчанию — запрос.This example shows the $ErrorActionPreference default value, Inquire. Выводится сообщение об ошибке, и отображается запрос на ввод действия.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"):

В этом примере показан $ErrorActionPreference набор для SilentlyContinue.This example shows the $ErrorActionPreference set to SilentlyContinue. Сообщение об ошибке подавляется.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

В этом примере показан $ErrorActionPreference набор для отмены.This example shows the $ErrorActionPreference set to Stop. Он также показывает дополнительный объект, созданный для $Error переменной.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 -Message 'Test Error' ; Write-Host 'Hello World' : Test Error
At line:1 char:1
+ Write-Error -Message 'Test Error' ; Write-Host 'Hello World'
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : NotSpecified: (:) [Write-Error], WriteErrorException
    + FullyQualifiedErrorId : Microsoft.PowerShell.Commands.WriteErrorException

The running command stopped because the preference variable "ErrorActionPreference"
or common parameter is set to Stop: Test Error

Write-Error -Message 'Test Error' ; Write-Host 'Hello World' : Test Error
At line:1 char:1
+ Write-Error -Message 'Test Error' ; Write-Host 'Hello World'
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : NotSpecified: (:) [Write-Error], WriteErrorException
    + FullyQualifiedErrorId : Microsoft.PowerShell.Commands.WriteErrorException

$еррорвиев$ErrorView

Определяет формат вывода сообщений об ошибках в PowerShell.Determines the display format of error messages in PowerShell.

Допустимы следующие значения.The valid values are as follows:

  • Нормалвиев : (по умолчанию) подробное представление, предназначенное для большинства пользователей.NormalView : (Default) A detailed view designed for most users. Состоит из описания ошибки и имени объекта, участвующего в ошибке.Consists of a description of the error and the name of the object involved in the error.

  • Категоривиев : краткое структурированное представление, предназначенное для рабочих сред.CategoryView : A succinct, structured view designed for production environments. Используется следующий формат:The format is as follows:

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

Дополнительные сведения о полях в категоривиев см. в разделе класс ерроркатегоринфо .For more information about the fields in CategoryView , see ErrorCategoryInfo class.

ПримерыExamples

В этом примере показано, как возникает ошибка, если значением $ErrorView по умолчанию является нормалвиев.This example shows how an error appears when the value of $ErrorView is the default, NormalView. Get-ChildItem используется для поиска несуществующего файла.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

В этом примере показано, как эта же ошибка возникает при $ErrorView изменении значения на категоривиев.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

В этом примере показано, что значение $ErrorView влияет только на отображение ошибок.This example demonstrates that the value of $ErrorView only affects the error display. Она не изменяет структуру объекта Error, который хранится в $Error автоматической переменной.It doesn't change the structure of the error object that is stored in the $Error automatic variable. Дополнительные сведения об $Error автоматической переменной см. в разделе about_automatic_variables.For information about the $Error automatic variable, see about_automatic_variables.

Следующая команда принимает объект ерроррекорд , связанный с самой последней ошибкой в массиве ошибок, элемент 0 , и форматирует все свойства объекта Error в списке.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

Определяет, сколько элементов перечисления включается в отображение.Determines how many enumerated items are included in a display. Эта переменная не влияет на базовые объекты, а только на отображение.This variable doesn't affect the underlying objects, only the display. Если значение меньше $FormatEnumerationLimit числа перечисленных элементов, в PowerShell добавляется многоточие ( ... ), показывающее, что элементы не показаны.When the value of $FormatEnumerationLimit is fewer than the number of enumerated items, PowerShell adds an ellipsis (...) to indicate items not shown.

Допустимые значения : целые числа ( Int32 )Valid values : Integers (Int32)

Значение по умолчанию : 4Default value : 4

ПримерыExamples

В этом примере показано, как использовать $FormatEnumerationLimit переменную для улучшения отображения перечисленных элементов.This example shows how to use the $FormatEnumerationLimit variable to improve the display of enumerated items.

В этом примере команда создает таблицу, в которой перечислены все службы, выполняющиеся на компьютере, в двух группах: одна для запуска служб, а другая для остановленных служб.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. Он использует Get-Service команду для получения всех служб, а затем отправляет результаты по конвейеру в Group-Object командлет, который группирует результаты по состоянию службы.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.

Результатом является таблица со списком состояний в столбце имя и процессами в столбце Group .The result is a table that lists the status in the Name column, and the processes in the Group column. Чтобы изменить метки столбцов, используйте хэш-таблицу, описанную в разделе about_Hash_Tables.To change the column labels, use a hash table, see about_Hash_Tables. Дополнительные сведения см. в примерах в разделе Format-Table.For more information, see the examples in Format-Table.

Найти текущее значение $FormatEnumerationLimit .Find the current value of $FormatEnumerationLimit.

$FormatEnumerationLimit
4

Список всех служб, сгруппированных по состоянию.List all services grouped by Status. Существует не более четырех служб, перечисленных в столбце Group для каждого состояния, так как $FormatEnumerationLimit имеет значение 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...}

Чтобы увеличить количество элементов в списке, увеличьте значение $FormatEnumerationLimit до 1000.To increase the number of items listed, increase the value of $FormatEnumerationLimit to 1000. Используйте Get-Service и Group-Object для вывода служб.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...

Используйте Format-Table с параметром Wrap для вывода списка служб.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

$InformationPreferenceПеременная позволяет задать параметры потока информации, которые должны отображаться для пользователей.The $InformationPreference variable lets you set information stream preferences that you want displayed to users. В частности, информационные сообщения, добавленные в команды или скрипты путем добавления командлета Write-Information .Specifically, informational messages that you added to commands or scripts by adding the Write-Information cmdlet. Если используется параметр InformationAction , его значение переопределяет значение $InformationPreference переменной.If the InformationAction parameter is used, its value overrides the value of the $InformationPreference variable. Write-Information впервые появился в PowerShell 5,0.Write-Information was introduced in PowerShell 5.0.

Допустимы следующие значения.The valid values are as follows:

  • Остановить : останавливает выполнение команды или скрипта при возникновении Write-Information команды.Stop : Stops a command or script at an occurrence of the Write-Information command.
  • Запрос : отображает информационное сообщение, указанное в Write-Information команде, а затем спрашивает, хотите ли вы продолжить.Inquire : Displays the informational message that you specify in a Write-Information command, then asks whether you want to continue.
  • Продолжить : отображает информационное сообщение и продолжает выполняться.Continue : Displays the informational message, and continues running.
  • Приостановить : автоматически приостанавливает задание рабочего процесса после выполнения Write-Information команды, чтобы разрешить пользователям видеть эти сообщения перед тем, как продолжить.Suspend : Automatically suspends a workflow job after a Write-Information command is carried out, to allow users to see the messages before continuing. Рабочий процесс можно возобновить по собственному усмотрению пользователя.The workflow can be resumed at the user's discretion.
  • SilentlyContinue : (по умолчанию) не оказывает никакого влияния.SilentlyContinue : (Default) No effect. Информационные сообщения не отображаются, и сценарий продолжается без прерывания.The informational messages aren't displayed, and the script continues without interruption.

$Событие log *$Log*Event

Переменные настройки **события log *** определяют, какие типы событий записываются в журнал событий PowerShell в Просмотр событий.The Log*Event preference variables determine which types of events are written to the PowerShell event log in Event Viewer. По умолчанию регистрируются только события подсистемы и поставщика.By default, only engine and provider events are logged. Но вы можете использовать переменные настройки **событий Log *** для настройки журнала, например ведения журнала событий о командах.But, you can use the Log*Event preference variables to customize your log, such as logging events about commands.

Ниже приведены переменные настройки **события log *** .The Log*Event preference variables are as follows:

  • $LogCommandHealthEvent: Регистрирует ошибки и исключения при инициализации и обработке команды.$LogCommandHealthEvent: Logs errors and exceptions in command initialization and processing. Значение по умолчанию — $false (не заносится в журнал).The default is $false (not logged).
  • $LogCommandLifecycleEvent: Записывает в журнал запуск и остановку команд и командных конвейеров и исключений безопасности при обнаружении команд.$LogCommandLifecycleEvent: Logs the starting and stopping of commands and command pipelines and security exceptions in command discovery. Значение по умолчанию — $false (не заносится в журнал).The default is $false (not logged).
  • $LogEngineHealthEvent: Регистрирует ошибки и сбои сеансов.$LogEngineHealthEvent: Logs errors and failures of sessions. Значение по умолчанию — $true (Протоколируется).The default is $true (logged).
  • $LogEngineLifecycleEvent: Записывает в журнал открытие и закрытие сеансов.$LogEngineLifecycleEvent: Logs the opening and closing of sessions. Значение по умолчанию — $true (Протоколируется).The default is $true (logged).
  • $LogProviderHealthEvent: Регистрирует ошибки поставщика, такие как ошибки чтения и записи, ошибки поиска и ошибки вызова.$LogProviderHealthEvent: Logs provider errors, such as read and write errors, lookup errors, and invocation errors. Значение по умолчанию — $true (Протоколируется).The default is $true (logged).
  • $LogProviderLifecycleEvent: Регистрирует Добавление и удаление поставщиков PowerShell.$LogProviderLifecycleEvent: Logs adding and removing of PowerShell providers. Значение по умолчанию — $true (Протоколируется).The default is $true (logged). Дополнительные сведения о поставщиках PowerShell см. в разделе about_Providers.For information about PowerShell providers, see about_Providers.

Чтобы включить **событие log *** , введите переменную со значением $true , например:To enable a Log*Event , type the variable with a value of $true, for example:

$LogCommandLifeCycleEvent = $true

Чтобы отключить тип события, введите переменную со значением $false , например:To disable an event type, type the variable with a value of $false, for example:

$LogCommandLifeCycleEvent = $false

Включенные события вступают в силу только для текущей консоли PowerShell.The events that you enable are effective only for the current PowerShell console. Чтобы применить конфигурацию ко всем консолям, сохраните параметры переменной в профиле PowerShell.To apply the configuration to all consoles, save the variable settings in your PowerShell profile. Дополнительные сведения см. в разделе about_Profiles.For more information, see about_Profiles.

$максимумалиаскаунт$MaximumAliasCount

Определяет, сколько псевдонимов разрешено в сеансе PowerShell.Determines how many aliases are permitted in a PowerShell session. Значение по умолчанию — 4096 , которое должно быть достаточным для большинства случаев использования.The default value is 4096 and that should be enough for most uses. Можно настроить $MaximumAliasCount в соответствии с вашими потребностями.You can adjust $MaximumAliasCount to meet your needs.

Допустимые значения : 1024-32768 ( Int32 )Valid values : 1024 - 32768 (Int32)

По умолчанию : 4096Default : 4096

Чтобы подсчитать псевдонимы в системе, введите:To count the aliases on your system, type:

(Get-Alias).count

$максимумдривекаунт$MaximumDriveCount

Определяет, сколько дисков PowerShell разрешено в данном сеансе.Determines how many PowerShell drives are permitted in a given session. Например, диски файловой системы и хранилища данных, предоставляемые поставщиками PowerShell и отображаемые в виде дисков, таких как Alias: HKLM: диски и.For example, file system drives and data stores that are exposed by PowerShell providers and appear as drives, such as the Alias: and HKLM: drives.

Допустимые значения : 1024-32768 ( Int32 )Valid values : 1024 - 32768 (Int32)

По умолчанию : 4096Default : 4096

Чтобы подсчитать псевдонимы в системе, введите:To count the aliases on your system, type:

(Get-PSDrive).count

$MaximumErrorCount$MaximumErrorCount

Определяет, сколько ошибок сохранено в журнале ошибок для сеанса.Determines how many errors are saved in the error history for the session.

Допустимые значения : 256-32768 ( Int32 )Valid values : 256 - 32768 (Int32)

По умолчанию : 256Default : 256

Объекты, представляющие каждую сохраненную ошибку, хранятся в $Error автоматической переменной.Objects that represent each retained error are stored in the $Error automatic variable. $Error содержит массив объектов записей об ошибках.$Error contains an array of error record objects. Самая последняя ошибка — первый объект в массиве, $Error[0] .The most recent error is the first object in the array, $Error[0].

Чтобы подсчитать количество ошибок в системе, используйте $Error свойство Count массива.To count the errors on your system, use the $Error array's Count property.

$Error.count

Чтобы отобразить конкретную ошибку, используйте [0] нотацию массива для просмотра самой последней ошибки.To display a specific error, use the [0] array notation to see the most recent error.

$Error[0]

Чтобы отобразить самую старую ошибочную ошибку, введите:To display the oldest retained error, type:

$Error[($Error.Count -1]

Параметр Force переопределяет особое форматирование объектов ерроррекорд и возвращается к обычному формату.The Force parameter overrides the special formatting of ErrorRecord objects and reverts to the conventional format. Чтобы отобразить свойства объекта ерроррекорд , введите следующую команду:To display the properties of the ErrorRecord object, type the following command:

$Error[0] | Format-List -Property * -Force

В этом примере $Error.Count выводится количество ошибок.In this example, $Error.Count displays the number of errors. Чтобы удалить все ошибки из журнала ошибок, используйте Clear метод массива ошибок.To delete all errors from the error history, use the Clear method of the error array.

$Error.Count
17
$Error.Clear()
$Error.Count
0

Чтобы найти все свойства и методы массива ошибок, используйте Get-Member командлет со своим параметром InputObject .To find all properties and methods of an error array, use the Get-Member cmdlet with its InputObject parameter. При использовании параметра InputObject Get-Member отображает свойства и методы коллекции.When you use the InputObject parameter, Get-Member displays the properties and methods of the collection.

Get-Member -InputObject $Error

При передаче коллекции объектов в Get-Member Get-Member отображается список свойств и методов объектов в коллекции.When you pipe a collection of objects to Get-Member, Get-Member displays the properties and methods of the objects in the collection.

$Error | Get-Member

$максимумфунктионкаунт$MaximumFunctionCount

Определяет, сколько функций разрешено в данном сеансе.Determines how many functions are permitted in a given session.

Допустимые значения : 1024-32768 ( Int32 )Valid values : 1024 - 32768 (Int32)

По умолчанию : 4096Default : 4096

Чтобы просмотреть функции в сеансе, используйте Function: диск PowerShell, предоставляемый Function поставщиком PowerShell.To see the functions in your session, use the PowerShell Function: drive that is exposed by the PowerShell Function provider. Дополнительные сведения о Function поставщике about_Function_Provider.For more information about the Function provider, about_Function_Provider.

Чтобы вывести список функций в текущем сеансе, введите:To list the functions in the current session, type:

Get-ChildItem Function:

Чтобы подсчитать количество функций в текущем сеансе, введите:To count the functions in the current session, type:

(Get-ChildItem Function:).Count

$максимумхисторикаунт$MaximumHistoryCount

Определяет, сколько команд сохраняется в журнале команд для текущего сеанса.Determines how many commands are saved in the command history for the current session.

Допустимые значения : 1-32768 ( Int32 )Valid values : 1 - 32768 (Int32)

По умолчанию : 4096Default : 4096

Чтобы определить количество команд, сохраненных в журнале команд, введите:To determine the number of commands current saved in the command history, type:

(Get-History).Count

Чтобы просмотреть команды, сохраненные в журнале сеанса, используйте Get-History командлет.To see the commands saved in your session history, use the Get-History cmdlet. Дополнительные сведения см. в разделе about_History.For more information, see about_History.

$максимумвариаблекаунт$MaximumVariableCount

Определяет, сколько переменных разрешено в данном сеансе, включая автоматические переменные, привилегированные переменные и переменные, создаваемые в командах и скриптах.Determines how many variables are permitted in a given session, including automatic variables, preference variables, and the variables that you create in commands and scripts.

Допустимые значения : 1024-32768 ( Int32 )Valid values : 1024 - 32768 (Int32)

По умолчанию : 4096Default : 4096

Чтобы просмотреть переменные в сеансе, используйте Get-Variable командлет и функции Variable: диска PowerShell и Variable поставщика PowerShell.To see the variables in your session, use the Get-Variable cmdlet and the features of the PowerShell Variable: drive and the PowerShell Variable provider. Дополнительные сведения см. в разделе about_Variable_Provider.For information, see about_Variable_Provider.

Чтобы найти текущее число переменных в системе, введите:To find the current number of variables on the system, type:

(Get-Variable).Count

$OFS$OFS

Разделитель полей вывода (OFS) определяет символ, разделяющий элементы массива, которые преобразуются в строку.The Output Field Separator (OFS) specifies the character that separates the elements of an array that is converted to a string.

Допустимые значения : любая строка.Valid values : Any string.

По умолчанию : пробелDefault : Space

По умолчанию $OFS переменная не существует, а разделитель выходного файла является пробелом, но можно добавить эту переменную и задать ее в любой строке.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. Вы можете изменить значение $OFS в своем сеансе, введя $OFS="<value>" .You can change the value of $OFS in your session, by typing $OFS="<value>".

Примечание

Если вы ожидаете значение по умолчанию пробела ( " " ) в скрипте, модуле или выходных данных конфигурации, будьте внимательны в том, что $OFS значение по умолчанию не было изменено в других местах кода.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.

ПримерыExamples

В этом примере показано, что пространство используется для разделения значений при преобразовании массива в строку.This example shows that a space is used to separate the values when an array is converted to a string. В этом случае массив целых чисел хранится в переменной, а переменная преобразуется в строку.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

Чтобы изменить разделитель, добавьте $OFS переменную, назначив ей значение.To change the separator, add the $OFS variable by assigning a value to it. Переменная должна иметь имя $OFS .The variable must be named $OFS.

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

Чтобы восстановить поведение по умолчанию, можно назначить пробел ( " " ) значению $OFS или удалить переменную.To restore the default behavior, you can assign a space (" ") to the value of $OFS or delete the variable. Следующие команды удаляют переменную и проверяют, что разделитель является пробелом.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

Определяет метод кодировки символов, используемый PowerShell при отправке текста в другие приложения.Determines the character encoding method that PowerShell uses when it sends text to other applications.

Например, если приложение возвращает строки в Юникоде в PowerShell, может потребоваться изменить значение на UnicodeEncoding , чтобы правильно отправить символы.For example, if an application returns Unicode strings to PowerShell, you might need to change the value to UnicodeEncoding to send the characters correctly.

Допустимы следующие значения: объекты, производные от класса кодирования, такие как ASCIIEncoding , сбкскодепажеенкодинг , UTF7Encoding , UTF8Encoding , UTF32Encoding и UnicodeEncoding.The valid values are as follows: Objects derived from an Encoding class, such as ASCIIEncoding , SBCSCodePageEncoding , UTF7Encoding , UTF8Encoding , UTF32Encoding , and UnicodeEncoding.

По умолчанию : объект ASCIIEncoding (System. Text. ASCIIEncoding)Default : ASCIIEncoding object (System.Text.ASCIIEncoding)

ПримерыExamples

В этом примере показано, как заставить команду Windows findstr.exe работать в PowerShell на компьютере, локализованном для языка, который использует символы Юникода, например китайский.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.

Первая команда находит значение $OutputEncoding .The first command finds the value of $OutputEncoding. Поскольку значение является объектом кодировки, отобразится только свойство EncodingName .Because the value is an encoding object, display only its EncodingName property.

$OutputEncoding.EncodingName

В этом примере используется команда findstr.exe для поиска двух китайских символов, которые содержатся в Test.txt файле.In this example, a findstr.exe command is used to search for two Chinese characters that are present in the Test.txt file. При выполнении этой findstr.exe команды в командной строке Windows ( cmd.exe ) findstr.exe находит символы в текстовом файле.When this findstr.exe command is run in the Windows Command Prompt ( cmd.exe ), findstr.exe finds the characters in the text file. Однако при выполнении той findstr.exe же команды в PowerShell символы не найдены, так как PowerShell отправляет их в findstr.exe в тексте ASCII, а не в тексте в Юникоде.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>

Чтобы команда работала в PowerShell, присвойте $OutputEncoding свойству OutputEncoding консоли значение, основанное на языковом стандарте, выбранном для 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. Поскольку OutputEncoding является статическим свойством консоли, в команде следует использовать двойные двоеточия ( :: ).Because OutputEncoding is a static property of the console, use double-colons (::) in the command.

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

После изменения кодировки команда findstr.exe находит символы Юникода.After the encoding change, the findstr.exe command finds the Unicode characters.

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

$прогресспреференце$ProgressPreference

Определяет, как PowerShell реагирует на обновления хода выполнения, создаваемые сценарием, командлетом или поставщиком, например индикаторами выполнения, созданными командлетом записи .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. Write-ProgressКомандлет создает индикаторы выполнения, отображающие состояние команды.The Write-Progress cmdlet creates progress bars that show a command's status.

Допустимы следующие значения.The valid values are as follows:

  • Завершение : не отображает индикатор выполнения.Stop : Doesn't display the progress bar. Вместо этого отображается сообщение об ошибке и прекращается выполнение.Instead, it displays an error message and stops executing.
  • Запрос : не отображает индикатор выполнения.Inquire : Doesn't display the progress bar. Запрашивает разрешение на продолжение.Prompts for permission to continue. При ответе с помощью Y или A отображается индикатор выполнения.If you reply with Y or A, it displays the progress bar.
  • Продолжить : (по умолчанию) отображает индикатор выполнения и продолжает выполнение.Continue : (Default) Displays the progress bar and continues with execution.
  • SilentlyContinue : выполняет команду, но не отображает индикатор выполнения.SilentlyContinue : Executes the command, but doesn't display the progress bar.

$Привилегированной PSEmailServer$PSEmailServer

Указывает сервер электронной почты по умолчанию, используемый для отправки сообщений электронной почты.Specifies the default e-mail server that is used to send email messages. Эта переменная предпочтений используется командлетами, которые отправляют электронную почту, например командлет Send-MailMessage .This preference variable is used by cmdlets that send email, such as the Send-MailMessage cmdlet.

$псдефаултпараметервалуес$PSDefaultParameterValues

Задает значения по умолчанию для параметров командлетов и дополнительных функций.Specifies default values for the parameters of cmdlets and advanced functions. Значение $PSDefaultParameterValues является хэш-таблицей, в которой ключ состоит из имени командлета и имени параметра, разделенных двоеточием ( : ).The value of $PSDefaultParameterValues is a hash table where the key consists of the cmdlet name and parameter name separated by a colon (:). Значение — это пользовательское значение по умолчанию, которое вы указали.The value is a custom default value that you specify.

$PSDefaultParameterValues впервые появился в PowerShell 3,0.$PSDefaultParameterValues was introduced in PowerShell 3.0.

Дополнительные сведения об этой переменной предпочтений см. в разделе about_Parameters_Default_Values.For more information about this preference variable, see about_Parameters_Default_Values.

$PSModuleAutoloadingPreference$PSModuleAutoloadingPreference

Включает и отключает автоматический импорт модулей в сеансе.Enables and disables automatic importing of modules in the session. По умолчанию используется значение ALL .All is the default. Независимо от значения переменной можно импортировать модуль с помощью Import-Module .Regardless of the variable's value, you can use Import-Module to import a module.

Допустимые значения:Valid values are:

  • Все : модули импортируются автоматически при первом использовании.All : Modules are imported automatically on first-use. Чтобы импортировать модуль, необходимо получить или использовать любую команду в модуле.To import a module, get or use any command in the module. Например, воспользуйтесь Get-Command.For example, use Get-Command.
  • Модулекуалифиед : модули импортируются автоматически только в том случае, если пользователь использует полное имя модуля команды в модуле.ModuleQualified : Modules are imported automatically only when a user uses the module-qualified name of a command in the module. Например, если пользователь вводит MyModule\MyCommand , PowerShell импортирует модуль MyModule .For example, if the user types MyModule\MyCommand, PowerShell imports the MyModule module.
  • Нет : автоматический импорт модулей отключен в сеансе.None : Automatic importing of modules is disabled in the session. Чтобы импортировать модуль, используйте Import-Module командлет.To import a module, use the Import-Module cmdlet.

Дополнительные сведения об автоматическом импорте модулей см. в разделе about_Modules.For more information about automatic importing of modules, see about_Modules.

$PSSessionApplicationName$PSSessionApplicationName

Указывает имя приложения по умолчанию для удаленной команды, которая использует веб-службы для технологии управления (WS-Management).Specifies the default application name for a remote command that uses Web Services for Management (WS-Management) technology. Дополнительные сведения см. в разделе About служба удаленного управления Windows.For more information, see About Windows Remote Management.

Имя системного приложения по умолчанию — WSMAN , но вы можете использовать эту переменную настройки, чтобы изменить значение по умолчанию.The system default application name is WSMAN, but you can use this preference variable to change the default.

Имя приложения — это последний узел в универсальном коде ресурса (URI) соединения.The application name is the last node in a connection URI. Например, имя приложения в следующем примере URI — WSMAN .For example, the application name in the following sample URI is WSMAN.

http://Server01:8080/WSMAN

Имя приложения по умолчанию используется, если в удаленной команде не указан универсальный код ресурса (URI) соединения или имя приложения.The default application name is used when the remote command doesn't specify a connection URI or an application name.

Служба WinRM использует имя приложения для выбора прослушивателя, который будет обслуживать запрос на подключение.The WinRM service uses the application name to select a listener to service the connection request. Значение параметра должно соответствовать значению свойства URLPrefix прослушивателя на удаленном компьютере.The parameter's value should match the value of the URLPrefix property of a listener on the remote computer.

Чтобы переопределить системные значения по умолчанию и значение этой переменной и выбрать другое имя приложения для конкретного сеанса, используйте параметры ConnectionURI или applicationName командлетов New-PSSession, Enter-PSSessionили 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.

$PSSessionApplicationNameПеременная предпочтений задается на локальном компьютере, но указывает на прослушиватель на удаленном компьютере.The $PSSessionApplicationName preference variable is set on the local computer, but it specifies a listener on the remote computer. Если указанное имя приложения не существует на удаленном компьютере, команда для установки сеанса завершается с ошибкой.If the application name that you specify doesn't exist on the remote computer, the command to establish the session fails.

$PSSessionConfigurationName$PSSessionConfigurationName

Задает конфигурацию сеанса по умолчанию, используемую для PSSession , созданной в текущем сеансе.Specifies the default session configuration that is used for PSSessions created in the current session.

Эта переменная предпочтений задается на локальном компьютере, но она указывает конфигурацию сеанса, расположенную на удаленном компьютере.This preference variable is set on the local computer, but it specifies a session configuration that's located on the remote computer.

Значение $PSSessionConfigurationName переменной является полным URI ресурса.The value of the $PSSessionConfigurationName variable is a fully qualified resource URI.

Значение по умолчанию http://schemas.microsoft.com/PowerShell/microsoft.PowerShell указывает на конфигурацию сеанса Microsoft. PowerShell на удаленном компьютере.The default value http://schemas.microsoft.com/PowerShell/microsoft.PowerShell indicates the Microsoft.PowerShell session configuration on the remote computer.

Если указано только имя конфигурации, в начале добавляется следующий URI схемы:If you specify only a configuration name, the following schema URI is prepended:

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

Можно переопределить значение по умолчанию и выбрать другую конфигурацию сеанса для конкретного сеанса с помощью параметра configurationName New-PSSession Enter-PSSession 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.

Значение этой переменной можно изменить в любое время.You can change the value of this variable at any time. В этом случае следует помнить, что выбранная конфигурация сеанса должна существовать на удаленном компьютере.When you do, remember that the session configuration that you select must exist on the remote computer. В противном случае команда для создания сеанса, использующего конфигурацию сеанса, завершится ошибкой.If it doesn't, the command to create a session that uses the session configuration fails.

Эта переменная предпочтений не определяет, какие конфигурации локального сеанса используются, когда удаленные пользователи создают сеанс, который подключается к этому компьютеру.This preference variable doesn't determine which local session configurations are used when remote users create a session that connects to this computer. Однако можно использовать разрешения для конфигураций локального сеанса, чтобы определить, какие пользователи могут их использовать.However, you can use the permissions for the local session configurations to determine which users may use them.

$PSSessionOption$PSSessionOption

Устанавливает значения по умолчанию для дополнительных параметров пользователя в удаленном сеансе.Establishes the default values for advanced user options in a remote session. Эти настройки параметров переопределяют системные значения по умолчанию для параметров сеанса.These option preferences override the system default values for session options.

$PSSessionOptionПеременная содержит объект PSSessionOption .The $PSSessionOption variable contains a PSSessionOption object. Дополнительные сведения см. в разделе System. Management. Automation. Remoting. PSSessionOption.For more information, see System.Management.Automation.Remoting.PSSessionOption. Каждое свойство объекта представляет параметр сеанса.Each property of the object represents a session option. Например, свойство « уплотнение » включает сжатие данных во время сеанса.For example, the NoCompression property turns of data compression during the session.

По умолчанию $PSSessionOption переменная содержит объект PSSessionOption со значениями по умолчанию для всех параметров, как показано ниже.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

Описание этих параметров и дополнительные сведения см. в разделе New-PSSessionOption.For descriptions of these options and more information, see New-PSSessionOption. Дополнительные сведения об удаленных командах и сеансах см. в разделе about_Remote и about_PSSessions.For more information about remote commands and sessions, see about_Remote and about_PSSessions.

Чтобы изменить значение $PSSessionOption привилегированной переменной, используйте New-PSSessionOption командлет, чтобы создать объект PSSessionOption с предпочтительными значениями параметров.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. Сохраните выходные данные в переменную с именем $PSSessionOption .Save the output in a variable called $PSSessionOption.

$PSSessionOption = New-PSSessionOption -NoCompression

Чтобы использовать $PSSessionOption переменную предпочтений в каждом сеансе PowerShell, добавьте New-PSSessionOption команду, которая создает $PSSessionOption переменную в профиле 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. Дополнительные сведения см. в разделе about_Profiles.For more information, see about_Profiles.

Можно задать пользовательские параметры для определенного удаленного сеанса.You can set custom options for a particular remote session. Заданные параметры имеют приоритет над системными значениями по умолчанию и значением $PSSessionOption привилегированной переменной.The options that you set take precedence over the system defaults and the value of the $PSSessionOption preference variable.

Чтобы задать настраиваемые параметры сеанса, используйте New-PSSessionOption командлет для создания объекта PSSessionOption .To set custom session options, use the New-PSSessionOption cmdlet to create a PSSessionOption object. Затем используйте объект PSSessionOption в качестве значения параметра SessionOption в командлетах, которые создают сеанс, например New-PSSession , Enter-PSSession и 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

Используется Start-Transcript для указания имени и расположения файла транскрипции.Used by Start-Transcript to specify the name and location of the transcript file. Если значение параметра path не указано, Start-Transcript использует путь в значении $Transcript глобальной переменной.If you do not specify a value for the Path parameter, Start-Transcript uses the path in the value of the $Transcript global variable. Если эта переменная не создана, сохраняет записи Start-Transcript в $Home\My Documents каталоге в виде \PowerShell_transcript.<time-stamp>.txt файлов.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

Определяет, как PowerShell реагирует на подробные сообщения, создаваемые сценарием, командлетом или поставщиком, например сообщения, созданные командлетом 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. Подробные сообщения описывают действия, выполняемые для выполнения команды.Verbose messages describe the actions performed to execute a command.

По умолчанию подробные сообщения не отображаются, но это поведение можно изменить, изменив значение $VerbosePreference .By default, verbose messages aren't displayed, but you can change this behavior by changing the value of $VerbosePreference.

Для отображения или скрытия подробных сообщений для определенной команды можно использовать параметр verbose Common.You can use the Verbose common parameter of a cmdlet to display or hide the verbose messages for a specific command. См. сведения в разделе about_CommonParameters.For more information, see about_CommonParameters.

Допустимы следующие значения.The valid values are as follows:

  • Остановить. Отображает подробное сообщение и сообщение об ошибке, а затем прекращает выполнение.Stop : Displays the verbose message and an error message and then stops executing.
  • Запрос : Отображает подробное сообщение, а затем выводит приглашение, указывающее, нужно ли продолжить.Inquire : Displays the verbose message and then displays a prompt that asks you whether you want to continue.
  • Продолжить : Отображает подробное сообщение, а затем продолжает выполнение.Continue : Displays the verbose message and then continues with execution.
  • SilentlyContinue : (по умолчанию) не отображает подробное сообщение.SilentlyContinue : (Default) Doesn't display the verbose message. Продолжение исполнения.Continues executing.

ПримерыExamples

В этих примерах показан результат различных значений $VerbosePreference параметров и параметр verbose для переопределения значения предпочтения.These examples show the effect of the different values of $VerbosePreference and the Verbose parameter to override the preference value.

В этом примере показано действие значения SilentlyContinue , которое является значением по умолчанию.This example shows the effect of the SilentlyContinue value, that is the default. Команда использует параметр Message , но не записывает сообщение в консоль PowerShell.The command uses the Message parameter, but doesn't write a message to the PowerShell console.

Write-Verbose -Message "Verbose message test."

При использовании параметра verbose сообщение записывается.When the Verbose parameter is used, the message is written.

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

В этом примере показан результат выполнения значения Continue .This example shows the effect of the Continue value. $VerbosePreferenceПеременная установлена для продолжения и отображается сообщение.The $VerbosePreference variable is set to Continue and the message is displayed.

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

В этом примере используется параметр verbose со значением $false , переопределяющим значение Continue .This example uses the Verbose parameter with a value of $false that overrides the Continue value. Сообщение не отображается.The message isn't displayed.

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

В этом примере показано воздействие значения " Отключить ".This example shows the effect of the Stop value. $VerbosePreferenceДля переменной задано значение " останавливаться ", и отображается сообщение.The $VerbosePreference variable is set to Stop and the message is displayed. Команда остановлена.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."

В этом примере используется параметр verbose со значением $false , переопределяющим значение параметра останавливает .This example uses the Verbose parameter with a value of $false that overrides the Stop value. Сообщение не отображается.The message isn't displayed.

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

В этом примере показано воздействие значения запроса .This example shows the effect of the Inquire value. $VerbosePreferenceДля переменной задано значение " запрос ".The $VerbosePreference variable is set to Inquire. Отображается сообщение, и пользователю предлагается подтверждение.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  [S] Suspend
[?] Help (default is "Y"):

В этом примере используется параметр verbose со значением $false , переопределяющим значение запроса Inquire .This example uses the Verbose parameter with a value of $false that overrides the Inquire value. Пользователю не выводится запрос, и сообщение не отображается.The user isn't prompted and the message isn't displayed.

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

$WarningPreference$WarningPreference

Определяет, как PowerShell реагирует на предупреждающие сообщения, созданные сценарием, командлетом или поставщиком, например сообщения, созданные командлетом 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.

По умолчанию отображаются предупреждающие сообщения, и выполнение продолжится, но это поведение можно изменить, изменив значение $WarningPreference .By default, warning messages are displayed and execution continues, but you can change this behavior by changing the value of $WarningPreference.

Вы можете использовать общий параметр WarningAction командлета, чтобы определить реакцию PowerShell на предупреждения от определенной команды.You can use the WarningAction common parameter of a cmdlet to determine how PowerShell responds to warnings from a particular command. См. сведения в разделе about_CommonParameters.For more information, see about_CommonParameters.

Допустимы следующие значения.The valid values are as follows:

  • Остановить : отображает предупреждающее сообщение и сообщение об ошибке, а затем прекращает выполнение.Stop : Displays the warning message and an error message and then stops executing.
  • Запрос : отображает предупреждающее сообщение, а затем запрашивает разрешение на продолжение.Inquire : Displays the warning message and then prompts for permission to continue.
  • Продолжить : (по умолчанию) отображает предупреждающее сообщение, а затем продолжает выполнение.Continue : (Default) Displays the warning message and then continues executing.
  • SilentlyContinue : не отображает предупреждающее сообщение.SilentlyContinue : Doesn't display the warning message. Продолжение исполнения.Continues executing.

ПримерыExamples

В этих примерах показано воздействие различных значений $WarningPreference .These examples show the effect of the different values of $WarningPreference. Параметр WarningAction переопределяет значение предпочтения.The WarningAction parameter overrides the preference value.

В этом примере показано воздействие значения по умолчанию на 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.

В этом примере для подавления предупреждения используется параметр WarningAction со значением SilentlyContinue .This example uses the WarningAction parameter with the value SilentlyContinue to suppress the warning. Сообщение не отображается.The message isn't displayed.

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

В этом примере $WarningPreference переменная изменяется на значение SilentlyContinue .This example changes the $WarningPreference variable to the SilentlyContinue value. Сообщение не отображается.The message isn't displayed.

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

В этом примере параметр WarningAction используется для отмены при создании предупреждения.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

В этом примере $WarningPreference переменная изменяется на значение Inquire запроса.This example changes the $WarningPreference variable to the Inquire value. Пользователю предлагается подтверждение.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  [S] Suspend
[?] Help (default is "Y"):

В этом примере используется параметр WarningAction со значением SilentlyContinue.This example uses the WarningAction parameter with the value SilentlyContinue. Команда продолжит выполняться, и сообщение не будет выводиться.The command continues to execute and no message is displayed.

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

В этом примере $WarningPreference значение изменяется на « останавливается ».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

В этом примере используется WarningAction со значением запроса .This example uses the WarningAction with the Inquire value. Пользователь получает запрос при возникновении предупреждения.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  [S] Suspend
[?] Help (default is "Y"):

$вхатифпреференце$WhatIfPreference

Определяет, включается ли параметр WhatIf автоматически для каждой команды, поддерживающей эту возможность.Determines whether WhatIf is automatically enabled for every command that supports it. Если параметр WhatIf включен, командлет сообщает о ожидаемом результате команды, но не выполняет команду.When WhatIf is enabled, the cmdlet reports the expected effect of the command, but doesn't execute the command.

Допустимы следующие значения.The valid values are as follows:

  • False ( 0 , не включено): (по умолчанию) WhatIf не включен автоматически.False ( 0 , not enabled): (Default) WhatIf isn't automatically enabled. Чтобы включить его вручную, используйте параметр WhatIf командлета.To enable it manually, use the cmdlet's WhatIf parameter.
  • True ( 1 , включено): WhatIf автоматически включается для любой команды, которая его поддерживает.True ( 1 , enabled): WhatIf is automatically enabled on any command that supports it. Пользователи могут использовать параметр WhatIf со значением false , чтобы отключить его вручную, например -WhatIf:$false .Users can use the WhatIf parameter with a value of False to disable it manually, such as -WhatIf:$false.

ПримерыExamples

В этих примерах показано воздействие различных значений $WhatIfPreference .These examples show the effect of the different values of $WhatIfPreference. Они показывают, как использовать параметр WhatIf для переопределения значения предпочтений для определенной команды.They show how to use the WhatIf parameter to override the preference value for a specific command.

В этом примере показан результат использования $WhatIfPreference переменной значения по умолчанию, равной false.This example shows the effect of the $WhatIfPreference variable set to the default value, False. Используйте Get-ChildItem , чтобы убедиться, что файл существует.Use Get-ChildItem to verify that the file exists. Remove-Item Удаляет файл.Remove-Item deletes the file. После удаления файла можно проверить его удаление с помощью 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

В этом примере показан результат использования параметра WhatIf , если значение $WhatIfPreference равно false.This example shows the effect of using the WhatIf parameter when the value of $WhatIfPreference is False.

Убедитесь, что файл существует.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

Используйте параметр WhatIf для определения результата попытки удаления файла.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".

Убедитесь, что файл не был удален.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

В этом примере показан результат выполнения $WhatIfPreference переменной значения true.This example shows the effect of the $WhatIfPreference variable set to the value, True. При использовании Remove-Item для удаления файла отображается путь к файлу, но файл не удаляется.When you use Remove-Item to delete a file, the file's path is displayed, but the file isn't deleted.

Попытка удаления файла.Attempt to delete a file. Появится сообщение о том, что произойдет при Remove-Item запуске, но файл не будет удален.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".

Используйте Get-ChildItem для проверки того, что файл не был удален.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

В этом примере показано, как удалить файл, если значение $WhatIfPreference равно true.This example shows how to delete a file when the value of $WhatIfPreference is True. В нем используется параметр WhatIf со значением $false .It uses the WhatIf parameter with a value of $false. Используйте Get-ChildItem для проверки удаления файла.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

Ниже приведены примеры Get-Process командлета, который не поддерживает WhatIf и Stop-Process поддерживает WhatIf.The following are examples of the Get-Process cmdlet that doesn't support WhatIf and Stop-Process that does support WhatIf. $WhatIfPreferenceЗначение переменной равно true.The $WhatIfPreference variable's value is True.

Get-Process не поддерживает WhatIf.Get-Process doesn't support WhatIf. При выполнении команды отображается процесс 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 поддерживает WhatIf.Stop-Process does support WhatIf. Процесс Winword не остановлен.The Winword process isn't stopped.

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

Поведение WhatIf можно переопределить с Stop-Process WhatIf помощью параметра WhatIf со значением $false .You can override the Stop-Process WhatIf behavior by using the WhatIf parameter with a value of $false. Процесс Winword остановлен.The Winword process is stopped.

Stop-Process -Name Winword -WhatIf:$false

Чтобы убедиться, что процесс Winword был остановлен, используйте 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

См. также статьюSee 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