다음을 통해 공유


Join-Path

경로와 자식 경로를 단일 경로로 결합합니다.

구문

Default (기본값)

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

Description

Join-Path cmdlet은 경로와 자식 경로를 단일 경로로 결합합니다. 공급자는 경로 구분 기호를 제공합니다.

예제

경로와 자식 경로 결합 예제 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

기존 디렉터리 구분 기호 \PathChildPath 사이에 하나의 구분 기호만 있도록 처리됩니다.

예제 3: 자식 경로와 경로를 조인하여 파일 및 폴더 표시

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

이 명령은 C:\Win\* 경로와 System\* 자식 경로를 조인하여 참조되는 파일 및 폴더를 표시합니다. Get-ChildItem과 동일한 파일 및 폴더를 표시하지만, 각 항목에 대한 완전한 경로를 표시합니다. 이 명령에서 PathChildPath 선택적 매개 변수 이름은 생략됩니다.

예제 4: PowerShell 레지스트리 공급자에서 Join-Path 사용

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 cmdlet을 사용하여 FileSystem 공급자가 지원하는 PowerShell 드라이브를 가져옵니다. ForEach-Object 문은 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에 추가되었습니다.

매개 변수 속성

형식:

String[]

Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:2
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-ChildPath

Path 매개 변수의 값에 추가할 요소를 지정합니다. 와일드카드가 허용됩니다. 매개 변수 이름("ChildPath")은 선택 사항이지만 ChildPath 매개 변수가 필요합니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:True
DontShow:False

매개 변수 집합

(All)
Position:1
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-Credential

비고

이 매개 변수는 PowerShell과 함께 설치된 공급자에서 지원되지 않습니다. 다른 사용자를 가장하거나 이 cmdlet을 실행할 때 자격 증명을 높이려면 Invoke-Command사용합니다.

매개 변수 속성

형식:PSCredential
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-Path

자식 경로가 추가되는 기본 경로(또는 경로)를 지정합니다. 와일드카드가 허용됩니다.

Path 값은 경로를 조인하는 공급자를 결정하고 경로 구분 기호를 추가합니다. 매개 변수 이름("Path")은 선택 사항이지만 Path 매개 변수가 필요합니다.

매개 변수 속성

형식:

String[]

Default value:None
와일드카드 지원:True
DontShow:False
별칭:PSPath

매개 변수 집합

(All)
Position:0
필수:True
파이프라인의 값:True
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-Resolve

이 cmdlet은 현재 공급자에서 조인된 경로를 해결하려고 시도해야 함을 나타냅니다.

  • 와일드카드를 사용하는 경우 cmdlet은 조인된 경로와 일치하는 모든 경로를 반환합니다.
  • 와일드카드가 사용되지 않으면 경로가 존재하지 않을 경우 cmdlet에 오류가 납니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

String

경로가 포함된 문자열을 이 cmdlet에 파이프할 수 있습니다.

출력

String

이 cmdlet은 결과 경로가 포함된 문자열을 반환합니다.

참고

경로라는 명사를 포함한 cmdlet은 경로 이름을 처리하여 모든 PowerShell 공급자가 해석할 수 있는 간결한 형식으로 이름을 반환합니다. 특정 형식으로 경로 이름의 전부 또는 일부를 표시하려는 프로그램 및 스크립트에서 사용하도록 설계되었습니다. Dirname, Normpath, Realpath, Join또는 기타 경로 조작자를 사용하는 것처럼 사용합니다.

경로 cmdlet은 FileSystem, RegistryCertificate 공급자를 비롯한 여러 공급자와 함께 사용할 수 있습니다.

이 cmdlet은 모든 공급자가 노출하는 데이터를 사용하도록 설계되었습니다. 세션에서 사용할 수 있는 공급자를 나열하려면 Get-PSProvider입력합니다. 추가 정보는 about_Providers를 참조하십시오.