Соединяет корневой и вложенный пути в один. Поставщик задает разделители пути.

Синтаксис

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".






См. также




Содержание