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


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

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

String

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

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

String

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

Примечания

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

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

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