경로의 지정된 일부를 반환합니다.
구문
Split-Path [-IsAbsolute] [-Path] <string[]> [-Credential <PSCredential>] [-LiteralPath <string[]>] [-Resolve] [-UseTransaction] [<CommonParameters>] Split-Path [-Leaf] [-Path] <string[]> [-Credential <PSCredential>] [-LiteralPath <string[]>] [-Resolve] [-UseTransaction] [<CommonParameters>] Split-Path [-NoQualifier] [-Path] <string[]> [-Credential <PSCredential>] [-LiteralPath <string[]>] [-Resolve] [-UseTransaction] [<CommonParameters>] Split-Path [-Parent] [-Path] <string[]> [-Credential <PSCredential>] [-LiteralPath <string[]>] [-Resolve] [-UseTransaction] [<CommonParameters>] Split-Path [-Qualifier] [-Path] <string[]> [-Credential <PSCredential>] [-LiteralPath <string[]>] [-Resolve] [-UseTransaction] [<CommonParameters>]
설명
Split-Path cmdlet은 상위 디렉터리, 하위 디렉터리 또는 파일 이름 등 경로의 지정한 부분만 반환합니다. 또한 분할 경로에서 참조하는 항목을 표시하고 해당 경로가 상대 경로인지 아니면 절대 경로인지 표시합니다.
이 cmdlet을 사용하여 경로의 선택한 부분만 표시하거나 전송할 수 있습니다.
매개 변수
-Credential <PSCredential>
이 작업을 수행할 수 있는 권한을 가진 사용자 계정을 지정합니다. 기본값은 현재 사용자입니다.
"User01" 또는 "Domain01\User01"과 같은 사용자 이름을 입력합니다. 또는 Get-Credential cmdlet에 의해 생성된 개체와 같은 PSCredential 개체를 입력합니다. 사용자 이름을 입력하면 암호를 묻는 메시지가 표시됩니다.
이 매개 변수는 Windows PowerShell과 함께 설치된 어떤 공급자에서도 지원되지 않습니다.
|
필수 여부 |
false |
|
위치 |
named |
|
기본값 |
|
|
파이프라인 입력 적용 여부 |
true (ByPropertyName) |
|
와일드카드 문자 적용 여부 |
false |
-IsAbsolute
경로가 절대 경로이면 TRUE를, 상대 경로이면 FALSE를 반환합니다. 절대 경로는 길이가 0보다 크고 점(.)을 사용하여 현재 경로를 나타내지 않습니다.
|
필수 여부 |
false |
|
위치 |
named |
|
기본값 |
|
|
파이프라인 입력 적용 여부 |
false |
|
와일드카드 문자 적용 여부 |
false |
-Leaf
경로의 마지막 항목 또는 컨테이너만 반환합니다. 예를 들어 "C:\Test\Logs\Pass1.log" 경로에서는 "Pass1.log"만 반환합니다.
|
필수 여부 |
false |
|
위치 |
named |
|
기본값 |
|
|
파이프라인 입력 적용 여부 |
true (ByPropertyName) |
|
와일드카드 문자 적용 여부 |
false |
-LiteralPath <string[]>
분할할 경로를 지정합니다. Path와 달리 LiteralPath 값은 입력한 그대로 사용됩니다. 와일드카드로 해석되는 문자는 없습니다. 경로에 이스케이프 문자가 포함된 경우 경로를 작은따옴표로 묶어야 합니다. 작은따옴표는 Windows PowerShell이 어떤 문자도 이스케이프 시퀀스로 해석하지 않도록 지시합니다.
|
필수 여부 |
false |
|
위치 |
named |
|
기본값 |
|
|
파이프라인 입력 적용 여부 |
true (ByPropertyName) |
|
와일드카드 문자 적용 여부 |
false |
-NoQualifier
한정자 없이 경로만 반환합니다. 파일 시스템 또는 레지스트리 공급자의 경우 한정자는 공급자 경로의 드라이브(예: C: 또는 HKCU:)입니다. 예를 들어 "C:\Test\Logs\Pass1.log" 경로에서는 "\Test\Logs\Pass1.log"만 반환합니다.
|
필수 여부 |
false |
|
위치 |
named |
|
기본값 |
|
|
파이프라인 입력 적용 여부 |
true (ByPropertyName) |
|
와일드카드 문자 적용 여부 |
false |
-Parent
경로에서 지정하는 항목 또는 컨테이너의 상위 컨테이너만 반환합니다. 예를 들어 "C:\Test\Logs\Pass1.log" 경로에서는 "C:\Test\Logs"를 반환합니다. 기본 분할 위치 매개 변수는 Parent입니다.
|
필수 여부 |
false |
|
위치 |
named |
|
기본값 |
|
|
파이프라인 입력 적용 여부 |
true (ByPropertyName) |
|
와일드카드 문자 적용 여부 |
false |
-Path <string[]>
분할할 경로를 지정합니다. 와일드카드를 사용할 수 있습니다. 경로에 공백이 포함된 경우 경로를 따옴표로 묶어야 합니다. 또한 경로를 Split-Path로 파이프할 수 있습니다.
|
필수 여부 |
true |
|
위치 |
1 |
|
기본값 |
|
|
파이프라인 입력 적용 여부 |
true (ByValue, ByPropertyName) |
|
와일드카드 문자 적용 여부 |
false |
-Qualifier
지정된 경로의 한정자만 반환합니다. 파일 시스템 또는 레지스트리 공급자의 경우 한정자는 공급자 경로의 드라이브(예: C: 또는 HKCU:)입니다.
|
필수 여부 |
false |
|
위치 |
2 |
|
기본값 |
|
|
파이프라인 입력 적용 여부 |
true (ByPropertyName) |
|
와일드카드 문자 적용 여부 |
false |
-Resolve
경로 요소를 표시하는 대신 분할 후 남아 있는 경로에서 참조하는 항목을 표시합니다.
|
필수 여부 |
false |
|
위치 |
named |
|
기본값 |
|
|
파이프라인 입력 적용 여부 |
false |
|
와일드카드 문자 적용 여부 |
false |
-UseTransaction
명령을 활성 트랜잭션에 포함합니다. 이 매개 변수는 트랜잭션이 진행 중인 경우에만 유효합니다. 자세한 내용은 about_Transactions를 참조하십시오.
|
필수 여부 |
false |
|
위치 |
named |
|
기본값 |
|
|
파이프라인 입력 적용 여부 |
false |
|
와일드카드 문자 적용 여부 |
false |
<CommonParameters>
이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_Commonparameters.
입력 및 출력
입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.
|
입력 |
System.String 경로가 포함된 문자열을 Split-Path로 파이프할 수 있습니다. |
|
출력 |
System.String Split-Path cmdlet은 텍스트 문자열을 반환합니다. Resolver 매개 변수를 사용하는 경우 Split-Path는 항목 위치를 설명하는 문자열을 반환하며, FileInfo나 RegistryKey 개체 같이 항목을 나타내는 개체는 반환하지 않습니다. |
참고
분할 위치 매개 변수 Qualifier, Parent, Leaf 및 NoQualifier는 함께 사용할 수 없습니다. 각 명령에서 하나만 사용할 수 있습니다.
Path 명사(Path cmdlet)를 포함하는 cmdlet은 경로 이름을 조작하여 모든 Windows PowerShell 공급자가 해석할 수 있는 간결한 형식으로 이름을 반환합니다. 이 cmdlet은 경로 이름의 전체 또는 일부를 특정 형식으로 표시하려는 프로그램 및 스크립트에 사용하도록 디자인되었습니다. Dirname, Normpath, Realpath, Join 또는 기타 경로 조작자를 사용할 때와 같은 방법으로 사용하면 됩니다.
파일 시스템, 레지스트리 및 인증서 공급자를 포함하여 여러 공급자와 함께 Path cmdlet을 사용할 수 있습니다.
Split-Path cmdlet은 모든 공급자가 제공하는 데이터에 사용할 수 있습니다. 세션에서 사용할 수 있는 공급자를 나열하려면 "Get-PSProvider"를 입력합니다. 자세한 내용은 about_Providers를 참조하십시오.
예 1
C:\PS>split-path "HKCU:\Software\Microsoft" -qualifier HKCU: 설명 ----------- 이 명령은 경로의 한정자(드라이브)만 반환합니다.
예 2
C:\PS>split-path "C:\Test\Logs\*.log" -leaf -resolve
Pass1.log
Pass2.log
...
설명
-----------
이 명령은 분할 경로에서 참조하는 파일을 표시합니다. 이 경로는 마지막 항목("leaf")에서 분할되었으므로 경로의 파일 이름만 표시됩니다.
Resolve 매개 변수를 사용하면 Split-Path에서 분할 경로를 표시하는 대신 분할 경로에서 참조하는 항목을 표시합니다.
모든 Split-Path 명령과 마찬가지로 이 명령은 문자열을 반환합니다. 파일을 나타내는 FileInfo 개체를 반환하지는 않습니다.
예 3
C:\PS>split-path "C:\WINDOWS\system32\WindowsPowerShell\V1.0\about_*.txt" C:\WINDOWS\system32\WindowsPowerShell\V1.0 설명 ----------- 이 명령은 경로의 상위 컨테이너만 반환합니다. 여기에는 분할을 지정할 매개 변수가 포함되어 있지 않으므로 Split-Path는 분할 위치 기본값(Parent)을 사용합니다.
예 4
C:\PS>split-path ".\My Pictures\*.jpg" -IsAbsolute False 설명 ----------- 이 명령은 경로가 절대 경로인지 상대 경로인지 결정합니다. 이 예의 경우 점(.)을 통해 알 수 있듯이 경로가 현재 디텍터리에 상대적이므로 FALSE($false)를 반환합니다.
예 5
C:\PS>set-location (split-path $profile) PS C:\Documents and Settings\juneb\My Documents\WindowsPowerShell> 설명 ----------- 이 명령은 현재 위치를 Windows PowerShell 프로필이 포함된 디렉터리로 변경합니다. 괄호 안의 명령은 Split-Path cmdlet을 사용하여 기본 제공 $Profile 변수에 저장된 경로의 상위 항목만 반환합니다. Parent 매개 변수는 기본 분할 위치 매개 변수이므로 명령에서 생략할 수 있습니다. 괄호는 Windows PowerShell이 괄호 안의 명령을 먼저 실행하도록 지시합니다. 이 방법을 사용하면 경로 이름이 긴 디렉터리를 검색할 때 편리합니다.
예 6
C:\PS>'C:\Documents and Settings\User01\My Documents\My Pictures' | split-path C:\Documents and Settings\User01\My Documents 설명 ----------- 이 명령은 파이프라인 연산자(|)를 사용하여 경로를 Split-Path cmdlet으로 보냅니다. 경로는 단일 토큰이라는 것을 나타내기 위해 따옴표로 묶어야 합니다.
참고 항목