Поделиться через

Join-Path

  • Ссылка
Модуль:
Microsoft.PowerShell.Management

Объединяет основной и дочерний путь в единый.

Синтаксис

Join-Path
    [-Path] <String[]>
    [-ChildPath] <String>
    [[-AdditionalChildPath] <String[]>]
    [-Resolve]
    [-Credential <PSCredential>]
    [<CommonParameters>]

Описание

Командлет Join-Path объединяет путь и дочерний путь в один путь. Поставщик предоставляет разделители путей.

Примеры

Пример 1. Объединение пути с дочерним путем

Join-Path -Path "path" -ChildPath "childpath"

path\childpath

Эта команда использует Join-Path для объединения пути с дочерним путем.

Так как команда выполняется из поставщика FileSystem, она использует разделитель \ для объединения путей.

Пример 2. Объединение путей, которые уже содержат разделители каталогов

Join-Path -Path "path\" -ChildPath "\childpath"

path\childpath

Существующие разделители каталогов обрабатываются так, что между \ и Path остается только один разделитель ChildPath.

Пример 3. Отображение файлов и папок путем присоединения пути к дочернему пути

Join-Path "C:\win*" "System*" -Resolve

Эта команда отображает файлы и папки, которые указаны путём объединения пути C:\Win\* с дочерним путём System\*. Он отображает те же файлы и папки, что и Get-ChildItem, но отображает полный путь к каждому элементу. В этой команде опущены Path и ChildPath необязательные имена параметров.

Пример 4. Использование Join-Path с поставщиком реестра PowerShell

PS HKLM:\> Join-Path -Path System -ChildPath *ControlSet* -Resolve

HKLM:\System\ControlSet001
HKLM:\System\CurrentControlSet

Эта команда отображает ключи реестра в подразделе реестра HKLM\System, включающие ControlSet.

Параметр Resolve пытается разрешить присоединенный путь, включая подстановочные знаки из текущего пути поставщика HKLM:\

Пример 5. Объединение нескольких корней путей с дочерним путем

Join-Path -Path C:, D:, E:, F: -ChildPath New

C:\New
D:\New
E:\New
F:\New

Эта команда использует Join-Path для объединения нескольких корней путей с дочерним путем.

Заметка

Указанные диски Path должны существовать, иначе соединение этой записи завершится ошибкой.

Пример 6. Объединение корней диска файловой системы с дочерним путем

Get-PSDrive -PSProvider filesystem | ForEach-Object {$_.Root} | Join-Path -ChildPath "Subdir"

C:\Subdir
D:\Subdir

Эта команда объединяет корневые каталоги каждого диска файловой системы PowerShell в консоли с дочерним путем Subdir.

Команда использует командлет Get-PSDrive для получения дисков PowerShell, поддерживаемых поставщиком FileSystem. Инструкция ForEach-Object выбирает только свойство Root объектов PSDriveInfo и объединяет его с указанным дочерним путем.

В выходных данных показано, что диски PowerShell на компьютере содержали диск, сопоставленный с каталогом C:\Program Files.

Пример 7. Объединение неограниченного количества путей

Join-Path a b c d e f g

a\b\c\d\e\f\g

Параметр AdditionalChildPath позволяет присоединять неограниченное количество путей.

В этом примере имена параметров не используются, поэтому "a" привязывается к Path, "b" к ChildPath и "c-g" к AdditionalChildPath

Параметры

-AdditionalChildPath

Указывает дополнительные элементы, которые следует добавить к значению параметра пути. Параметр ChildPath по-прежнему является обязательным и должен быть указан.

Этот параметр задается с помощью свойства ValueFromRemainingArguments, которое позволяет присоединять неограниченное количество путей.

Этот параметр был добавлен в PowerShell 6.0.

Тип:String[]
Position:2
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ChildPath

Указывает элементы, добавляемые к значению параметра Path. Разрешены подстановочные знаки. Обязательный параметр ChildPath, хотя имя параметра (ChildPath) является необязательным.

Тип:String
Position:1
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:True

-Credential

Заметка

Этот параметр не поддерживается поставщиками, установленными с помощью PowerShell. Чтобы олицетворить другого пользователя или повысить свои учетные данные при выполнении этого командлета, используйте Invoke-Command.

Тип:PSCredential
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Path

Указывает основной путь (или пути), к которому добавляется дочерний путь. Разрешены подстановочные знаки.

Значение Path определяет, какой поставщик объединяет пути и добавляет разделители путей. Обязательный параметр Path, хотя имя параметра (Path) является необязательным.

Тип:String[]
Aliases:PSPath
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:True

-Resolve

Указывает, что этот командлет должен попытаться определить присоединенный путь у текущего провайдера.

  • Если используются подстановочные знаки, командлет возвращает все пути, соответствующие объединённому пути.
  • Если не используются подстановочные знаки, командлет будет ошибкой, если путь не существует.
Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

String

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

Выходные данные

String

Этот командлет возвращает строку, содержащую полученный путь.

Примечания

Командлеты, содержащие существительное Path (командлеты Path), управляют путями и возвращают имена в сжатом формате, который может быть интерпретирован всеми поставщиками PowerShell. Они предназначены для использования в программах и сценариях, где необходимо отобразить все или часть имени пути в определенном формате. Используйте их так, как вы будете использовать Dirname, Normpath, Realpath, Joinили другие манипуляторы пути.

Командлеты пути можно использовать с несколькими поставщиками, включая FileSystem, Registryи Certificate.

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