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

Join-Path

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

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

Синтаксис

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

Описание

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

Примеры

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

PS C:\> Join-Path -Path "path" -ChildPath "childpath"

path\childpath

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

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

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

PS C:\> 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 выбирает только корневое свойство объектов PSDriveInfo и объединяет его с указанным дочерним путем.

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

Параметры

-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

-UseTransaction

Включает команду в активную транзакцию. Этот параметр действителен только в том случае, если выполняется транзакция. Дополнительные сведения см. в about_Transactions.

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

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

String

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

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

String

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

Примечания

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

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

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