Set-Location

Командлет Set-Location задает рабочее расположение указанному расположению. Это расположение может быть каталогом, подкаталогом, расположением реестра или любым путем поставщика.

PowerShell 6.2 добавила поддержку - и + в качестве значений для параметра Path. PowerShell поддерживает журнал последних 20 расположений, к которым можно получить доступ с помощью - и +. Этот список не зависит от стека расположений, доступ к которому осуществляется с помощью параметра StackName.

PS C:\> Set-Location -Path "HKLM:\"
PS HKLM:\>

Эта команда задает текущее расположение корень диска HKLM:.

PS C:\> Set-Location -Path "Env:\" -PassThru

Path
----
Env:\

PS Env:\>

Эта команда задает текущее расположение корень диска Env:. Он использует параметр PassThru для направления PowerShell для возврата объекта PathInfo PathInfo, представляющего расположение Env:\.

PS C:\Windows\> Set-Location HKLM:\
PS HKLM:\> Set-Location C:
PS C:\Windows\>

Первая команда задает расположение корневому каталогу диска HKLM: в поставщике реестра. Вторая команда задает расположение в текущем расположении диска C: в поставщике FileSystem. Если имя диска указано в форме <DriveName>: (без обратной косой черты), командлет задает расположение в текущем расположении в PSDrive. Чтобы получить текущее расположение в PSDrive, используйте команду Get-Location -PSDrive <DriveName>.

PS C:\> Push-Location -Path 'C:\Program Files\PowerShell\' -StackName "Paths"
PS C:\Program Files\PowerShell\> Set-Location -StackName "Paths"
PS C:\Program Files\PowerShell\> Get-Location -Stack

Path
----
C:\

Первая команда добавляет текущее расположение в стек Paths. Вторая команда делает расположение paths стеком текущего стека расположений. Третья команда отображает расположения в текущем стеке расположений.

Командлеты *-Location используют текущий стек расположений, если в команде не указан другой стек расположений. Сведения о стеках расположений см. в заметках.

PS C:\> Set-Location -Path $Env:SystemRoot
PS C:\Windows> Set-Location -Path Cert:\
PS Cert:\> Set-Location -Path HKLM:\
PS HKLM:\>

# Navigate back through the history using "-"
PS HKLM:\> Set-Location -Path -
PS Cert:\> Set-Location -Path -
PS C:\Windows>

# Navigate using the Set-Location alias "cd" and the implicit positional Path parameter
PS C:\Windows> cd -
PS C:\> cd +
PS C:\Windows> cd +
PS Cert:\>

Используя псевдоним, cd - или cd + можно легко перемещаться по журналу расположения в терминале. Дополнительные сведения о навигации с помощью -/+см. в параметре пути.

String

Можно передать строку, содержащую путь, но не литеральный путь к этому командлету.

None

По умолчанию этот командлет не возвращает выходные данные.

PathInfo

При использовании параметра PassThru с path или LiteralPathэтот командлет возвращает объект PathInfo PathInfo, представляющий новое расположение.

PathInfoStack

При использовании параметра PassThru с StackNameэтот командлет возвращает объект PathInfoStack, представляющий новый контекст стека.

PowerShell включает следующие псевдонимы для Set-Location:

• Все платформы:
  • cd
  • chdir
  • sl

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

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

Командлет Set-Location предназначен для работы с данными, предоставляемыми любым поставщиком. Чтобы вывести список поставщиков, доступных в сеансе, введите Get-PSProvider. Дополнительные сведения см. в разделе about_Providers.

Стек — это последний, первый список, в котором можно получить доступ только к последнему добавлению элемента. Вы добавляете элементы в стек в порядке их использования, а затем извлекаете их для использования в обратном порядке. PowerShell позволяет хранить расположения поставщиков в стеках расположений. PowerShell создает неименованный стек расположений по умолчанию. Можно создать несколько именованных стеков расположений. Если имя стека не указано, PowerShell использует текущий стек расположений. По умолчанию неназванное расположение по умолчанию — это текущий стек расположений, но можно использовать командлет Set-Location для изменения текущего стека расположений.

Чтобы управлять стеками расположений, используйте командлеты *-Location следующим образом:

• Чтобы добавить расположение в стек расположений, используйте командлет Push-Location.

• Чтобы получить расположение из стека расположений, используйте командлет Pop-Location.

• Чтобы отобразить расположения в текущем стеке расположений, используйте параметр Stack командлета Get-Location. Чтобы отобразить расположения в именованном стеке расположений, используйте параметр StackNameGet-Location.

• Чтобы создать стек расположений, используйте параметр StackName для Push-Location. Если указать стек, который не существует, Push-Location создает стек.

• Чтобы сделать стек расположения текущим стеком расположений, используйте параметр StackNameSet-Location.

Неименованный стек расположений по умолчанию полностью доступен только в том случае, если он является текущим стеком расположений. Если создать стек именованных расположений в текущем стеке расположений, вы больше не сможете использовать командлеты Push-Location или Pop-Location для добавления или получения элементов из стека по умолчанию или использования командлета Get-Location для отображения расположений в неназванном стеке. Чтобы сделать неименованный стек текущим стеком, используйте параметр StackName командлета Set-Location со значением $null или пустой строкой ("").