Join-Path
Объединяет путь и его дочерний путь в один путь.
Синтаксис
Join-Path
[-Path] <String[]>
[-ChildPath] <String>
[[-AdditionalChildPath] <String[]>]
[-Resolve]
[-Credential <PSCredential>]
[<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
выбирает только свойство 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
Указывает дополнительные элементы, добавляемые к значению параметра Path . Параметр ChildPath
по-прежнему является обязательным и должен быть указан.
Этот параметр задается с ValueFromRemainingArguments
помощью свойства , которое позволяет объединить неопределенное количество путей.
Этот параметр был добавлен в PowerShell 6.0.
Type: | String[] |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ChildPath
Указывает элементы, добавляемые к значению Path
параметра . Разрешено использовать подстановочные знаки. Параметр ChildPath
является обязательным, хотя имя параметра ("ChildPath") является необязательным.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Credential
Примечание
Этот параметр не поддерживается поставщиками, установленными с помощью PowerShell. Чтобы олицетворить другого пользователя или повысить уровень учетных данных при выполнении этого командлета, используйте Invoke-Command.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Path
Указывает основной путь (или пути), к которому добавляется дочерний путь. Разрешено использовать подстановочные знаки.
Значение Path
определяет, какой поставщик присоединяет пути, и добавляет разделители пути.
Параметр Path
является обязательным, хотя имя параметра ("Путь") является необязательным.
Type: | String[] |
Aliases: | PSPath |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Resolve
Указывает, что этот командлет должен попытаться разрешить присоединенный путь от текущего поставщика.
- Если используются подстановочные знаки, командлет возвращает все пути, соответствующие объединяемого пути.
- Если подстановочные знаки не используются, командлет завершит ошибку, если путь не существует.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Входные данные
В этот командлет можно передать по конвейеру строку, содержащую путь.
Выходные данные
Этот командлет возвращает строку, содержащую результирующий путь.
Примечания
Командлеты, содержащие существительное Path (командлеты Path), управляют именами путей и возвращают имена в кратком формате, который могут интерпретировать все поставщики PowerShell. Они предназначены для использования в программах и скриптах, где имя пути или его часть должны отображаться в определенном формате.
Используйте их так же, как Dirname
, Normpath
, Realpath
, Join
или другие манипуляторы пути.
Командлеты path можно использовать с несколькими поставщиками, включая поставщики FileSystem
, Registry
и Certificate
.
Этот командлет предназначен для работы с данными, предоставляемыми любым поставщиком. Чтобы вывести список поставщиков, доступных в данном сеансе, введите командлет Get-PSProvider
. Дополнительные сведения см. в разделе about_Providers.