Присваивает текущему местоположению заданное значение.
Синтаксис
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: поставщика файловой системы.
См. также