Set-Location
Присваивает текущему местоположению заданное значение.
Синтаксис
Set-Location [-LiteralPath] <string> [-PassThru] [-UseTransaction] [<CommonParameters>]
Set-Location [[-Path] <string>] [-PassThru] [-UseTransaction] [<CommonParameters>]
Set-Location [-StackName <string>] [-PassThru] [-UseTransaction] [<CommonParameters>]
Описание
Командлет Set-Location присваивает рабочему местоположению заданное значение. Местоположение может быть каталогом, вложенным каталогом, местоположением в реестре или другим стеком каталогов.
Параметры
-LiteralPath <string>
Задает путь к местоположению. Значение параметра LiteralPath используется точно в том виде, в котором оно введено. Никакие символы не интерпретируются как подстановочные знаки. Если путь включает escape-символы, его нужно заключить в одиночные кавычки. Одиночные кавычки указывают оболочке Windows PowerShell, что никакие символы не следует интерпретировать как escape-символы.
Обязательно? |
true |
Позиция? |
1 |
Значение по умолчанию |
|
Принимать входные данные из конвейера? |
true (ByPropertyName) |
Принимать подстановочные знаки? |
false |
-PassThru
Передает по конвейеру объект, представляющий местоположение. По умолчанию этот командлет не формирует никаких выходных данных.
Обязательно? |
false |
Позиция? |
named |
Значение по умолчанию |
|
Принимать входные данные из конвейера? |
false |
Принимать подстановочные знаки? |
false |
-Path <string>
Этот параметр используется для задания пути к новому рабочему местоположению.
Обязательно? |
false |
Позиция? |
1 |
Значение по умолчанию |
|
Принимать входные данные из конвейера? |
true (ByValue, ByPropertyName) |
Принимать подстановочные знаки? |
false |
-StackName <string>
Имя стека, которое задается местоположению.
Обязательно? |
false |
Позиция? |
named |
Значение по умолчанию |
|
Принимать входные данные из конвейера? |
true (ByPropertyName) |
Принимать подстановочные знаки? |
false |
-UseTransaction
Включает команду в активную транзакцию. Этот параметр допустим, только если транзакция выполняется. Дополнительные сведения см. в разделе about_Transactions.
Обязательно? |
false |
Позиция? |
named |
Значение по умолчанию |
|
Принимать входные данные из конвейера? |
false |
Принимать подстановочные знаки? |
false |
<CommonParameters>
Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.
Ввод и вывод
Входным типом является тип объектов, которые можно передавать командлету по конвейеру. Возвращаемым типом является тип объектов, возвращаемых командлетом.
Входные данные |
System.String Строку, содержащую путь (но не литеральный путь), можно передать командлету Set-Location по конвейеру. |
Выходные данные |
Нет или System.Management.Automation.PathInfo Если задан параметр PassThru, командлет Set-Location создает объект System.Management.Automation.PathInfo, представляющий местоположение. В противном случае этот командлет не формирует никаких выходных данных. |
Примечания
Командлет Set-Location предназначен для работы с данными, предоставляемыми любым поставщиком. Чтобы получить список поставщиков, доступных в текущем сеансе, введите команду "Get-PSProvider". Дополнительные сведения см. в разделе About_Providers.
Пример 1
C:\PS>set-location HKLM:
Описание
-----------
Эта команда присваивает текущему местоположению заданное значение. В данном случае им является поставщик HKLM.
Пример 2
C:\PS>set-location env: -passthru
Path
----
Env:\
Описание
-----------
Эта команда присваивает текущему местоположению заданное значение. В данном случае им является поставщик переменных среды.
Пример 3
C:\PS>set-location C:
Описание
-----------
Эта команда присваивает текущему местоположению заданное значение. В данном случае им является диск C: поставщика файловой системы.