Соединяет корневой и вложенный пути в один. Поставщик задает разделители пути.
Синтаксис
Join-Path [-Path] <string[]> [-ChildPath] <string> [-Credential <PSCredential>] [-Resolve] [-UseTransaction] [<CommonParameters>]
Описание
Командлет Join-Path соединяет корневой и вложенный пути в один. Поставщик задает разделители пути.
Параметры
-ChildPath <string>
Задает элементы, присоединяемые к значению параметра Path. Подстановочные знаки разрешены. Параметр ChildPath обязателен, но его имя ("ChildPath") можно не указывать.
|
Обязательно? |
true |
|
Позиция? |
2 |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
true (ByPropertyName) |
|
Принимать подстановочные знаки? |
false |
-Credential <PSCredential>
Задает учетную запись пользователя, который располагает разрешением для выполнения этого действия. По умолчанию используется значение "Текущий пользователь".
Введите имя пользователя, например "User01" или "Domain01\User01". Или укажите объект PSCredential, например один из объектов, созданных командлетом Get-Credential. При вводе имени пользователя система запросит пароль.
Этот параметр не поддерживается ни одним из установленных с Windows PowerShell поставщиком.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
true (ByPropertyName) |
|
Принимать подстановочные знаки? |
false |
-Path <string[]>
Задает главный путь (или пути), к которому присоединяется дочерний путь. Подстановочные знаки разрешены.
Значение параметра Path определяет, какой из поставщиков соединяет пути и добавляет разделители. Параметр Path обязателен, но его имя ("Path") можно не указывать.
|
Обязательно? |
true |
|
Позиция? |
1 |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
true (ByValue, ByPropertyName) |
|
Принимать подстановочные знаки? |
false |
-Resolve
Отображает элементы, на которые указывает объединенный путь.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-UseTransaction
Включает команду в активную транзакцию. Этот параметр допустим, только если транзакция выполняется. Дополнительные сведения см. в разделе about_Transactions.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
<CommonParameters>
Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.
Ввод и вывод
Входным типом является тип объектов, которые можно передавать командлету по конвейеру. Возвращаемым типом является тип объектов, возвращаемых командлетом.
|
Входные данные |
System.String Строку, содержащую путь, можно передать командлету Join-Path по конвейеру. |
|
Выходные данные |
System.String Командлет Join-Path возвращает строку с конечным путем. |
Примечания
Командлеты, в именах которых содержится существительное Path (командлеты Path), оперируют именами путей и возвращают эти имена в сокращенном формате, который поддерживается всеми поставщиками Windows PowerShell. Они предназначены для использования в программах и скриптах, в которых требуется отображать имя пути или его часть в конкретном формате. Используйте их аналогично другим командам для работы с путями, таким как Dirname, Normpath, Realpath и Join.
Командлеты для работы с путями можно использовать с несколькими поставщиками, включая FileSystem, Registry и Certificate.
Командлет Join-Path предназначен для работы с данными, предоставляемыми любым поставщиком. Чтобы получить список поставщиков, доступных в текущем сеансе, введите команду "Get-PSProvider". Дополнительные сведения см. в разделе About_Providers.
Пример 1
C:\PS>join-path -path c:\win* -childpath System* Описание ----------- В данной команде для соединения путей "c:\Win*" и "System*" используется командлет Join-Path. При работе с поставщиком файловой системы Windows PowerShell командлет FileSystem производит соединение путей и добавляет разделитель "\".
Пример 2
C:\PS>join-path c:\win* System* -resolve Описание ----------- Эта команда выводит список файлов и папок, находящихся в местоположении, задаваемом с помощью пути, полученного объединением "c:\Win*" и "System*". Список отображаемых элементов совпадает со списком, возвращаемым командлетом Get-ChildItem, но отличается от него тем, что элементы задаются полными путями. В данной команде имена необязательных параметров Path и ChildPath опущены.
Пример 3
C:\PS>PS HKLM:\> join-path System *ControlSet* -resolve Описание ----------- Эта команда отображает список разделов реестра в разделе HKLM\System, включающих в себя параметр "ControlSet". В данном примере показано, как использовать командлет Join-Path с поставщиком реестра Windows PowerShell.
Пример 4
C:\PS>join-path -path C:, D:, E:, F: -childpath New Описание ----------- Эта команда с помощью командлета Join-Path объединяет несколько корневых путей с дочерним путем.
Пример 5
C:\PS>get-psdrive -psprovider filesystem | foreach {$_.root} | join-path -childpath Subdir
Описание
-----------
Эта команда объединяет корневые пути каждого диска файловой системы Windows PowerShell в консоли с дочерним путем Subdir.
С помощью командлета Get-PSDrive команда получает диски Windows PowerShell, поддерживаемые поставщиком FileSystem. Инструкция ForEach позволяет выбрать только свойство Root объектов PSDriveInfo и объединить его с указанным дочерним путем.
Выходные данные показывают, что диски Windows PowerShell на компьютере включают диск, подключенный к каталогу "C:\Program Files".
См. также