about_Automatic_Variables

Статья
01/19/2024

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

Описывает переменные, которые хранят сведения о состоянии и создаются и поддерживаются PowerShell.

Концептуально большинство этих переменных считаются доступны только для чтения. Несмотря на то, что они могут быть записаны в, для обратной совместимости они не должны быть записаны.

Ниже приведен список автоматических переменных в PowerShell:

$$
$?
$^
$_
$args
$ConsoleFileName
$EnabledExperimentalFeatures
$Error
$Event
$EventArgs
$EventSubscriber
$ExecutionContext
$false
$foreach
$HOME
$Host
$input
$IsCoreCLR
$IsLinux
$IsMacOS
$IsWindows
$LASTEXITCODE
$Matches
$MyInvocation
$NestedPromptLevel
$null
$PID
$PROFILE
$PSBoundParameters
$PSCmdlet
$PSCommandPath
$PSCulture
$PSDebugContext
$PSEdition
$PSHOME
$PSItem
$PSScriptRoot
$PSSenderInfo
$PSUICulture
$PSVersionTable
$PWD
$Sender
$ShellId
$StackTrace
$switch
$this
$true

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

$$

Содержит последний маркер в последней строке, полученной сеансом.

$?

Содержит состояние выполнения последней команды. Он содержит значение True, если последняя команда завершилась успешно и false, если она завершилась ошибкой.

Для командлетов и расширенных функций, выполняемых на нескольких этапах в конвейере, например в обоих блоках, вызов $PSCmdlet.WriteError()this.WriteError() или соответственно в любой точке имеет $?значение False, как и $PSCmdlet.ThrowTerminatingError()this.ThrowTerminatingError() .processend

Командлет Write-Error всегда задает $?значение False сразу после выполнения, но не будет задано $?значение False для вызываемой функции:

function Test-WriteError
{
    Write-Error "Bad"
    "The `$? variable is: $?"
}

Test-WriteError
"Now the `$? variable is: $?"

Test-WriteError:
Line |
   7 |  Test-WriteError
     |  ~~~~~~~~~~~~~~~
     | Bad
The $? variable is: False
Now the $? variable is: True

Для последней цели $PSCmdlet.WriteError() следует использовать вместо этого.

Для собственных команд (исполняемых файлов) $? задано значение True, если $LASTEXITCODE значение равно 0, и при наличии любого другого значения задано значение False$LASTEXITCODE.

Примечание.

До PowerShell 7 оболочка инструкции в скобках (...), синтаксис $(...)вложенных выражений или выражение @(...) массива всегда сбрасывается $? на True. Например, (Write-Error) отображается $? значение True. Это поведение изменилось в PowerShell 7, поэтому $? всегда отражает фактическое успешное выполнение последней команды в этих выражениях.

$^

Содержит первый маркер в последней строке, полученной сеансом.

$_

Эквивалентно $PSItem. Содержит текущий объект в объекте конвейера. Эту переменную можно использовать в командах, выполняющих действие для каждого объекта в конвейере.

Дополнительные сведения см. в about_PSItem.

$args

Содержит массив значений для необъявленных параметров, передаваемых в функцию, скрипт или блок скрипта. При создании функции можно объявить параметры с param помощью ключевое слово или добавить разделенный запятыми список параметров в скобках после имени функции.

В действии $args события переменная содержит объекты, представляющие аргументы события обрабатываемого события. Эта переменная заполняется только в Action блоке команды регистрации событий. Значение этой переменной также можно найти в свойстве SourceArgs объекта PSEventArgs, который Get-Event возвращается.

$ConsoleFileName

Содержит путь к файлу консоли (.psc1), который был недавно использован в сеансе. Эта переменная заполняется при запуске PowerShell с параметром PSConsoleFile или при экспорте имен оснастки в файл консоли с помощью Export-Console командлета.

При использовании командлета Export-Console без параметров он автоматически обновляет файл консоли, который был недавно использован в сеансе. Эту автоматическую переменную можно использовать для определения файла для обновления.

$EnabledExperimentalFeatures

Содержит список имен экспериментальных функций, которые включены.

Error$

Содержит массив объектов ошибок, представляющих самые последние ошибки. Последняя ошибка — первый объект ошибки в массиве $Error[0].

Чтобы предотвратить добавление ошибки в $Error массив, используйте общий параметр ErrorAction со значением Ignore. Дополнительные сведения см. в разделе about_CommonParameters.

$Event

Содержит объект PSEventArgs , представляющий событие, которое обрабатывается. Эта переменная заполняется только в Action блоке команды регистрации событий, например Register-ObjectEvent. Значение этой переменной является тем же объектом, что и возвращаемый командлетом Get-Event . Вы можете использовать свойства переменной Event , например $Event.TimeGeneratedв блоке Action скрипта.

$EventArgs

Содержит объект, представляющий первый аргумент события, производный от EventArgs события, обрабатываемого события. Эта переменная заполняется только в Action блоке команды регистрации событий. Значение этой переменной также можно найти в свойстве SourceEventArgs объекта PSEventArgs, возвращаемогоGet-Event.

$EventSubscriber

Содержит объект PSEventSubscriber , представляющий подписчик события обрабатываемого события. Эта переменная заполняется только в Action блоке команды регистрации событий. Значение этой переменной является тем же объектом, что и возвращаемый командлетом Get-EventSubscriber .

$ExecutionContext

Содержит объект EngineIntrinsics , представляющий контекст выполнения узла PowerShell. Эту переменную можно использовать для поиска объектов выполнения, доступных командлетам.

$false

Содержит false. Эту переменную можно использовать для представления false в командах и сценариях вместо использования строки "false". Строка может быть интерпретирована как True , если она преобразуется в непустую строку или в целое число, отличное от нуля.

$foreach

Содержит перечислитель (а не полученные значения) цикла ForEach . Переменная $ForEach существует только во время ForEach выполнения цикла; она удаляется после завершения цикла.

Перечислители содержат свойства и методы, которые можно использовать для получения значений цикла и изменения текущей итерации цикла. Дополнительные сведения см. в разделе "Использование перечислителей".

$HOME

Содержит полный путь к домашнему каталогу пользователя. В Windows эта переменная обычно использует значение переменной "$env:USERPROFILE"C:\Users\<UserName>среды Windows. В Unix эта переменная использует значение переменной HOME среды.

Внимание

Windows может перенаправить расположение профиля пользователя. Это означает, что $HOME может не совпадать со значением "$env:HOMEDRIVE$env:HOMEPATH".

$Host

Содержит объект, представляющий текущее хост-приложение для PowerShell. Эту переменную можно использовать для представления текущего узла в командах или отображения или изменения свойств узла, например $Host.version или $Host.CurrentCulture.$Host.UI.RawUI.BackGroundColor = "Red"

Примечание.

Параметры цвета были заменены $Host.PrivateData переменной $PSStyle предпочтения. Дополнительные сведения см. в about_ANSI_Terminals.

$input

Содержит перечислитель, который перечисляет все входные данные, передаваемые в функцию. Переменная $input доступна только функциям, блокам скриптов (которые являются неназванными функциями) и файлам скриптов (которые являются сохраненными блоками скриптов).

В функции без beginprocessблока или end блока $input переменная перечисляет коллекцию всех входных данных функции.
В блоке begin$input переменная не содержит данных.
В блоке process$input переменная содержит текущий объект в конвейере.
В блоке end$input переменная перечисляет коллекцию всех входных данных функции.

Примечание.

Переменную нельзя использовать $input как внутри блока, так process и end блока в одном блоке функции или скрипта.

Так как $input это перечислитель, доступ к любому из его свойств больше $input недоступен. Для повторного использования свойств можно сохранить $input в другой переменной $input .

Переменная $input также доступна команде, указанной -Command параметром pwsh при вызове из командной строки. Следующий пример выполняется из командной оболочки Windows.

echo Hello | pwsh -Command """$input World!"""

$IsCoreCLR

Содержит, $True если текущий сеанс выполняется в среде выполнения .NET Core (CoreCLR). В противном случае содержится $False.

$IsLinux

Содержит, $True если текущий сеанс выполняется в операционной системе Linux. В противном случае содержится $False.

$IsMacOS

Содержит, $True если текущий сеанс запущен в операционной системе MacOS. В противном случае содержится $False.

$IsWindows

Содержит, $TRUE если текущий сеанс запущен в операционной системе Windows. В противном случае содержится $FALSE.

$LASTEXITCODE

Содержит код выхода последней собственной программы или скрипта PowerShell, запущенного.

Для сценариев PowerShell значение $LASTEXITCODE зависит от того, как был вызван скрипт и использовался ли exit ключевое слово:

Если скрипт использует exit ключевое слово:

$LASTEXITCODEимеет значение, указанное exit ключевое слово. Дополнительные сведения см. в about_Language_Keywords.
При вызове скрипта напрямую, например ./Test.ps1или с оператором вызова (&например& ./Test.ps1:

Значение $LASTEXITCODE не изменяется, если только не указано:
- Скрипт вызывает другой скрипт, использующий exit ключевое слово
- Сценарий вызывает собственную команду
- Сценарий использует exit ключевое слово
При вызове скрипта с pwsh помощью параметра $LASTEXITCODE File задано следующее:
- 1 Значение
- Значение, указанное exit ключевое слово, если используется в скрипте
- 0 Если скрипт выполнен успешно
При вызове скрипта с pwsh помощью параметра $LASTEXITCODE Command задано следующее:
- 1 Значение $? в $false
- 0Значение $?$true

Дополнительные сведения о параметрах файлов и команд см. в about_Pwsh.

$Matches

Переменная $Matches работает с -match операторами и -notmatch операторами. При отправке скалярных входных данных оператору -match или -notmatch оператору или одному из них обнаруживается совпадение, они возвращают логическое значение и заполняют $Matches автоматическую переменную хэш-таблицей любых строковых значений, которые были сопоставлены. Хэш-таблица $Matches также может быть заполнена записью при использовании регулярных выражений с оператором -match .

Дополнительные сведения об операторе -match см. в about_Comparison_Operators. Дополнительные сведения о регулярных выражениях см. в about_Regular_Expressions.

Переменная $Matches также работает в инструкции с параметром switch-Regex . Он заполняется так же, как -match и -notmatch операторы. Дополнительные сведения об инструкции switch см. в about_Switch.

Примечание.

При $Matches заполнении сеанса оно сохраняет соответствующее значение, пока оно не перезаписывается другим совпадением. Если -match используется снова, и совпадение не найдено, он не сбрасывается $Matches$nullв . Ранее соответствующее значение хранится до $Matches тех пор, пока не будет найдено другое совпадение.

$MyInvocation

Содержит сведения о текущей команде, например имя, параметры, значения параметров и сведения о том, как команда была запущена, вызвана или вызвана, например имя скрипта, вызываемого текущей командой.

$MyInvocation заполняется только для скриптов, функций и блоков скриптов. Сведения можно использовать в объекте System.Management.Automation.InvocationInfo , который $MyInvocation возвращается в текущем скрипте, например имя функции ($MyInvocation.MyCommand.Name) для идентификации текущей команды. Это полезно для поиска имени текущего скрипта.

Начиная с PowerShell 3.0, MyInvocation имеет следующие новые свойства.

PSScriptRoot — содержит полный путь к скрипту, который вызвал текущую команду. Значение этого свойства заполняется только в том случае, если вызывающий объект является скриптом.
PSCommandPath — содержит полный путь и имя файла скрипта, вызывающего текущую команду. Значение этого свойства заполняется только в том случае, если вызывающий объект является скриптом.

$PSScriptRoot В отличие от автоматических $PSCommandPath переменных, свойства PSScriptRoot и PSCommandPath автоматической переменной $MyInvocation содержат сведения о вызывающем или вызывающем скрипте, а не текущем скрипте.

$NestedPromptLevel

Содержит текущий уровень запроса. Значение 0 указывает исходный уровень запроса. Значение увеличивается при вводе вложенного уровня и уменьшения при выходе из него.

Например, PowerShell представляет вложенную командную строку при использовании $Host.EnterNestedPrompt метода. PowerShell также представляет вложенную командную строку при достижении точки останова в отладчике PowerShell.

При вводе вложенной строки PowerShell приостанавливает текущую команду, сохраняет контекст выполнения и увеличивает значение переменной $NestedPromptLevel . Чтобы создать дополнительные вложенные командные строки (до 128 уровней) или вернуться в исходную командную строку, выполните команду или введите exit.

Переменная $NestedPromptLevel помогает отслеживать уровень запроса. Можно создать альтернативную командную строку PowerShell, которая включает это значение, чтобы он всегда был видимым.

$null

$null — это автоматическая переменная, содержащая значение NULL или пустое значение. Эту переменную можно использовать для представления отсутствующего или неопределенного значения в командах и сценариях.

PowerShell обрабатывает $null как объект со значением или заполнителем, поэтому можно использовать $null для представления пустого значения в коллекции значений.

Например, если $null он включен в коллекцию, он считается одним из объектов.

$a = "one", $null, "three"
$a.count

Если переменная $nullForEach-Object передана командлету, она создает значение для $nullдругих объектов.

"one", $null, "three" | ForEach-Object { "Hello " + $_}

Hello one
Hello
Hello three

В результате нельзя использовать $nullзначение параметра. Значение параметра переопределяет значение $null параметра по умолчанию.

Однако, поскольку PowerShell обрабатывает $null переменную как заполнитель, его можно использовать в сценариях, таких как следующий, который не будет работать, если $null они были проигнорированы.

$calendar = @($null, $null, "Meeting", $null, $null, "Team Lunch", $null)
$days = "Sunday","Monday","Tuesday","Wednesday","Thursday",
        "Friday","Saturday"
$currentDay = 0
foreach($day in $calendar)
{
    if($day -ne $null)
    {
        "Appointment on $($days[$currentDay]): $day"
    }

    $currentDay++
}

Appointment on Tuesday: Meeting
Appointment on Friday: Team lunch

$PID

Содержит идентификатор процесса (PID) процесса, в котором размещается текущий сеанс PowerShell.

$PROFILE

Содержит полный путь к профилю PowerShell для текущего пользователя и текущего ведущего приложения. Эту переменную можно использовать для представления профиля в командах. Например, его можно использовать в команде, чтобы определить, был ли создан профиль:

Test-Path $PROFILE

Вы также можете использовать его в команде для создания профиля:

New-Item -ItemType file -Path $PROFILE -Force

Его можно использовать в команде, чтобы открыть профиль в notepad.exe:

notepad.exe $PROFILE

$PSBoundParameters

Содержит словарь параметров, передаваемых скрипту или функции, и их текущим значениям. Эта переменная имеет значение только в область, где объявляются параметры, например скрипт или функция. Его можно использовать для отображения или изменения текущих значений параметров или передачи значений параметров другому скрипту или функции.

В этом примере функция Test2 передает $PSBoundParameters функцию Test1 . Они $PSBoundParameters отображаются в формате "Ключ " и "Значение".

function Test1 {
   param($a, $b)

   # Display the parameters in dictionary format.
   $PSBoundParameters
}

function Test2 {
   param($a, $b)

   # Run the Test1 function with $a and $b.
   Test1 @PSBoundParameters
}

Test2 -a Power -b Shell

Key   Value
---   -----
a     Power
b     Shell

$PSCmdlet

Содержит объект, представляющий командлет или расширенную функцию, выполняемую.

Свойства и методы объекта в коде командлета или функции можно использовать для реагирования на условия использования. Например, свойство ParameterSetName содержит имя используемого набора параметров, а метод ShouldProcess добавляет параметры WhatIf и Confirm в командлет динамически.

Дополнительные сведения об автоматической переменной $PSCmdlet см. в about_Functions_CmdletBindingAttribute и about_Functions_Advanced.

$PSCommandPath

Содержит полный путь и имя файла выполняемого скрипта. Эта переменная допустима во всех сценариях.

$PSCulture

Начиная с PowerShell 7, $PSCulture отражает язык и региональные параметры текущего пространства выполнения PowerShell (сеанс). Если язык и региональные параметры изменяются в пространстве выполнения PowerShell, $PSCulture значение для этого пространства выполнения обновляется.

Язык и региональные параметры определяют формат отображения таких элементов, как числа, валюта и даты, и хранится в объекте System.Globalization.CultureInfo . Используется Get-Culture для отображения языка и региональных параметров компьютера. $PSCulture содержит значение свойства Name .

$PSDebugContext

При отладке эта переменная содержит сведения о среде отладки. В противном случае он содержит значение NULL . В результате его можно использовать для определения того, имеет ли отладчик элемент управления. При заполнении он содержит объект PsDebugContext с точками останова и свойствами InvocationInfo. Свойство InvocationInfo имеет несколько полезных свойств, включая свойство Location . Свойство Location указывает путь к скрипту, который выполняется отладка.

$PSEdition

Содержит то же значение в $PSVersionTable.PSEdition. Эта переменная доступна для использования в файлах $PSVersionTable манифеста модуля, в то время как это не так.

$PSHOME

Содержит полный путь к каталогу установки Для PowerShell, как правило, $env:windir\System32\PowerShell\v1.0 в системах Windows. Эту переменную можно использовать в путях файлов PowerShell. Например, следующая команда выполняет поиск в концептуальных разделах справки для переменной слова:

Select-String -Pattern Variable -Path $pshome\*.txt

$PSItem

Эквивалентно $_. Содержит текущий объект в объекте конвейера. Эту переменную можно использовать в командах, выполняющих действие для каждого объекта в конвейере.

Дополнительные сведения см. в about_PSItem.

$PSScriptRoot

Содержит полный путь родительского каталога скрипта.

В PowerShell 2.0 эта переменная действительна только в модулях скриптов (.psm1). Начиная с PowerShell 3.0, он действителен во всех сценариях.

$PSSenderInfo

Содержит сведения о пользователе, который запустил PSSession, включая удостоверение пользователя и часовой пояс исходного компьютера. Эта переменная доступна только в PSSessions.

Переменная $PSSenderInfo включает настраиваемое пользователем свойство ApplicationArguments, которое по умолчанию содержит только $PSVersionTable исходную сессию. Чтобы добавить данные в свойство ApplicationArguments, используйте параметр ApplicationArguments командлетаNew-PSSessionOption.

$PSUICulture

Содержит имя языка и региональных параметров пользовательского интерфейса, настроенных в операционной системе. Язык и региональные параметры пользовательского интерфейса определяют, какие строки текста используются для элементов пользовательского интерфейса, например меню и сообщений. Это значение System.Globalization.CultureInfo.Current UICulture.Name свойство системы. Чтобы получить объект System.Globalization.CultureInfo для системы, используйте Get-UICulture командлет.

$PSVersionTable

Содержит хэш-таблицу только для чтения, которая отображает сведения о версии PowerShell, работающей в текущем сеансе. Таблица содержит следующие элементы:

PSVersion — номер версии PowerShell
PSEdition Это свойство имеет значение Desktop для PowerShell 4 и ниже, а также PowerShell 5.1 в полнофункционированных выпусках Windows. Это свойство имеет значение Core для PowerShell 6 и более поздних версий, а также Windows PowerShell 5.1 для выпусков с ограниченным объемом памяти, таких как Windows Nano Server или Windows IoT.
GitCommitId — идентификатор фиксации исходных файлов в GitHub.
ОС — описание операционной системы, в которую работает PowerShell.
Платформа — платформа , на которую работает операционная система. Значение в Linux и macOS — Unix. Ознакомьтесь с разделами $IsMacOs и $IsLinux.
PSCompatibleVersions — версии PowerShell, совместимые с текущей версией
PSRemotingProtocolVersion — версия протокола удаленного управления PowerShell.
SerializationVersion — версия метода сериализации
WSManStackVersion — номер версии стека WS-Management

$PWD

Содержит объект пути, представляющий полный путь к текущему расположению каталога для текущего пространства выполнения PowerShell.

Примечание.

PowerShell поддерживает несколько пространств выполнения для каждого процесса. Каждое пространство выполнения имеет собственный текущий каталог. Это не то же самое, что и текущий каталог процесса: [System.Environment]::CurrentDirectory

$Sender

Содержит объект, создающий это событие. Эта переменная заполняется только в блоке действий команды регистрации событий. Значение этой переменной также можно найти в свойстве Sender объекта PSEventArgs , возвращающего Get-Event .

$ShellId

Содержит идентификатор текущей оболочки.

$StackTrace

Содержит трассировку стека для последней ошибки.

$switch

Содержит перечислитель, а не полученные значения инструкции Switch . Переменная $switch существует только во время Switch выполнения инструкции; она удаляется после switch завершения выполнения инструкции. Дополнительные сведения см. в about_Switch.

$this

Переменная $this используется в блоках скриптов, расширяющих классы для ссылки на экземпляр самого класса.

Расширяемая система типов PowerShell (ETS) позволяет добавлять свойства в классы с помощью блоков скриптов. В блоке скрипта, определяющем свойство скрипта или метод скрипта, $this переменная ссылается на экземпляр объекта класса, который расширяется. Например, PowerShell использует ETS для добавления свойства BaseName в класс FileInfo .

PS> Get-ChildItem .\README.md | Get-Member BaseName | Format-List

TypeName   : System.IO.FileInfo
Name       : BaseName
MemberType : ScriptProperty
Definition : System.Object BaseName {get=if ($this.Extension.Length -gt 0)
             {$this.Name.Remove($this.Name.Length - $this.Extension.Length
             )}else{$this.Name};}

Дополнительные сведения см. в разделе about_Types.ps1xml.

В классе $this PowerShell переменная ссылается на объект экземпляра самого класса, разрешая доступ к свойствам и методам, определенным в классе. Дополнительные сведения см. в статье About Classes and Desired State Configuration (О классах и настройке требуемого состояния).

Переменная $this также используется классами событий .NET, которые принимают блоки скриптов в качестве делегатов обработчика событий. В этом сценарии $this представляет объект, отправляющий событие, известный как отправитель событий.

$true

Содержит значение True. Эту переменную можно использовать для представления True в командах и сценариях.

Использование перечислителей

$foreachПеременные $inputи $switch переменные — это все перечислители, используемые для итерации значений, обработанных их содержащим блоком кода.

Перечислитель содержит свойства и методы, которые можно использовать для продвижения или сброса итерации или извлечения значений итерации. Непосредственное управление перечислителями не считается рекомендуется.

В циклах элемент управления потоками ключевое слово разрыва и продолжения следует предпочтительнее.
В функциях, которые принимают входные данные конвейера, рекомендуется использовать параметры с атрибутами ValueFromPipeline или ValueFromPipelineByPropertyName.

Дополнительные сведения см. в about_Functions_Advanced_Parameters.

MoveNext

Метод MoveNext перемещает перечислитель к следующему элементу коллекции. MoveNext возвращает, True если перечислитель был успешно расширен, False если перечислитель прошел конец коллекции.

Примечание.

Логическое значение, возвращаемоеMoveNext , отправляется в выходной поток. Вы можете отключить выходные данные, введя его [void] или переведя его в out-NULL.

$input.MoveNext() | Out-Null

[void]$input.MoveNext()

Reset

Метод Reset задает перечислителю начальную позицию, которая находится перед первым элементом в коллекции.

Current

Свойство Current получает элемент в коллекции или конвейере в текущей позиции перечислителя.

Свойство Current продолжает возвращать то же свойство до вызова MoveNext .

Примеры

Пример 1. Использование переменной $input

В следующем примере доступ к $input переменной очищает переменную до следующего выполнения блока обработки. Reset Использование метода сбрасывает $input переменную в текущее значение конвейера.

function Test
{
    begin
    {
        $i = 0
    }

    process
    {
        "Iteration: $i"
        $i++
        "`tInput: $input"
        "`tAccess Again: $input"
        $input.Reset()
        "`tAfter Reset: $input"
    }
}

"one","two" | Test

Iteration: 0
    Input: one
    Access Again:
    After Reset: one
Iteration: 1
    Input: two
    Access Again:
    After Reset: two

Блок процесса автоматически перемещает переменную, даже если доступ к ней $input не выполняется.

$skip = $true
function Skip
{
    begin
    {
        $i = 0
    }

    process
    {
        "Iteration: $i"
        $i++
        if ($skip)
        {
            "`tSkipping"
            $skip = $false
        }
        else
        {
            "`tInput: $input"
        }
    }
}

"one","two" | Skip

Iteration: 0
    Skipping
Iteration: 1
    Input: two

Пример 2. Использование $input за пределами блока процесса

Вне блока $input процесса переменная представляет все значения, которые передаются в функцию.

Доступ к переменной $input очищает все значения.
Метод Reset сбрасывает всю коллекцию.
Свойство Current никогда не заполняется.
Метод MoveNext возвращает значение false, так как коллекция не может быть расширена.
- Вызов MoveNext очищает $input переменную.

Function All
{
    "All Values: $input"
    "Access Again: $input"
    $input.Reset()
    "After Reset: $input"
    $input.MoveNext() | Out-Null
    "After MoveNext: $input"
}

"one","two","three" | All

All Values: one two three
Access Again:
After Reset: one two three
After MoveNext:

Пример 3. Использование $input.Current Свойство

При использовании свойства текущее Current значение конвейера можно получить несколько раз, не используя Reset метод. Блок процесса не вызывает метод MoveNext автоматически.

Свойство Current никогда не заполняется, если вы явно не вызываете MoveNext. Свойство Current можно получить несколько раз в блоке процесса, не очищая его значение.

function Current
{
    begin
    {
        $i = 0
    }

    process
    {
        "Iteration: $i"
        $i++
        "`tBefore MoveNext: $($input.Current)"
        $input.MoveNext() | Out-Null
        "`tAfter MoveNext: $($input.Current)"
        "`tAccess Again: $($input.Current)"
    }
}

"one","two" | Current

Iteration: 0
    Before MoveNext:
    After MoveNext: one
    Access Again: one
Iteration: 1
    Before MoveNext:
    After MoveNext: two
    Access Again: two

Пример 4. Использование переменной $foreach

В отличие от переменной $input , $foreach переменная всегда представляет все элементы в коллекции при непосредственном доступе. Current Используйте свойство для доступа к текущему элементу коллекции и Resetметодам MoveNext, чтобы изменить его значение.

Примечание.

Каждая итерация foreach цикла автоматически вызывает метод MoveNext .

Следующий цикл выполняется только дважды. Во второй итерации коллекция перемещается в третий элемент до завершения итерации. После второй итерации теперь нет больше значений для итерации, и цикл завершается.

Свойство MoveNext не влияет на переменную, выбранную для итерации через коллекцию ($Num).

$i = 0
foreach ($num in ("one","two","three"))
{
    "Iteration: $i"
    $i++
    "`tNum: $num"
    "`tCurrent: $($foreach.Current)"

    if ($foreach.Current -eq "two")
    {
        "Before MoveNext (Current): $($foreach.Current)"
        $foreach.MoveNext() | Out-Null
        "After MoveNext (Current): $($foreach.Current)"
        "Num hasn't changed: $num"
    }
}

Iteration: 0
        Num: one
        Current: one
Iteration: 1
        Num: two
        Current: two
Before MoveNext (Current): two
After MoveNext (Current): three
Num hasn't changed: two

Reset Использование метода сбрасывает текущий элемент в коллекции. В следующем примере выполняется цикл между двумя первыми двумя элементами , так как Reset метод вызывается. После первых двух циклов if оператор завершается ошибкой, и цикл выполняет итерацию всех трех элементов обычно.

Внимание

Это может привести к бесконечному циклу.

$stopLoop = 0
foreach ($num in ("one","two", "three"))
{
    ("`t" * $stopLoop) + "Current: $($foreach.Current)"

    if ($num -eq "two" -and $stopLoop -lt 2)
    {
        $foreach.Reset()
        ("`t" * $stopLoop) + "Reset Loop: $stopLoop"
        $stopLoop++
    }
}

Current: one
Current: two
Reset Loop: 0
        Current: one
        Current: two
        Reset Loop: 1
                Current: one
                Current: two
                Current: three

Пример 5. Использование переменной $switch

Переменная $switch имеет те же правила, что $foreach и переменная. В следующем примере показаны все понятия перечислителя.

Примечание.

Обратите внимание, что регистр NotEvaluated никогда не выполняется, даже если break после метода MoveNext нет инструкции.

$values = "Start", "MoveNext", "NotEvaluated", "Reset", "End"
$stopInfinite = $false
switch ($values)
{
    "MoveNext" {
        "`tMoveNext"
        $switch.MoveNext() | Out-Null
        "`tAfter MoveNext: $($switch.Current)"
    }
    # This case is never evaluated.
    "NotEvaluated" {
        "`tAfterMoveNext: $($switch.Current)"
    }

    "Reset" {
        if (!$stopInfinite)
        {
            "`tReset"
            $switch.Reset()
            $stopInfinite = $true
        }
    }

    default {
        "Default (Current): $($switch.Current)"
    }
}

Default (Current): Start
    MoveNext
    After MoveNext: NotEvaluated
    Reset
Default (Current): Start
    MoveNext
    After MoveNext: NotEvaluated
Default (Current): End

about_Automatic_Variables

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

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

$$

$?

$^

$_

$args

$ConsoleFileName

$EnabledExperimentalFeatures

Error$

$Event

$EventArgs

$EventSubscriber

$ExecutionContext

$false

$foreach

$HOME

$Host

$input

$IsCoreCLR

$IsLinux

$IsMacOS

$IsWindows

$LASTEXITCODE

$Matches

$MyInvocation

$NestedPromptLevel

$null

$PID

$PROFILE

$PSBoundParameters

$PSCmdlet

$PSCommandPath

$PSCulture

$PSDebugContext

$PSEdition

$PSHOME

$PSItem

$PSScriptRoot

$PSSenderInfo

$PSUICulture

$PSVersionTable

$PWD

$Sender

$ShellId

$StackTrace

$switch

$this

$true

Использование перечислителей

MoveNext

Reset

Current

Примеры

Пример 1. Использование переменной $input

Пример 2. Использование $input за пределами блока процесса

Пример 3. Использование $input.Current Свойство

Пример 4. Использование переменной $foreach

Пример 5. Использование переменной $switch

См. также

Обратная связь

Дополнительные ресурсы