다음을 통해 공유

Split-Path

  • 참조
모듈:
Microsoft.PowerShell.Management

경로의 지정된 부분을 반환합니다.

구문

Split-Path
     [-Path] <String[]>
     [-Parent]
     [-Resolve]
     [-Credential <PSCredential>]
     [<CommonParameters>]
Split-Path
     [-Path] <String[]>
     -Leaf
     [-Resolve]
     [-Credential <PSCredential>]
     [<CommonParameters>]
Split-Path
     [-Path] <String[]>
     -LeafBase
     [-Resolve]
     [-Credential <PSCredential>]
     [<CommonParameters>]
Split-Path
     [-Path] <String[]>
     -Extension
     [-Resolve]
     [-Credential <PSCredential>]
     [<CommonParameters>]
Split-Path
     [-Path] <String[]>
     -Qualifier
     [-Resolve]
     [-Credential <PSCredential>]
     [<CommonParameters>]
Split-Path
     [-Path] <String[]>
     -NoQualifier
     [-Resolve]
     [-Credential <PSCredential>]
     [<CommonParameters>]
Split-Path
     [-Path] <String[]>
     [-Resolve]
     -IsAbsolute
     [-Credential <PSCredential>]
     [<CommonParameters>]
Split-Path
     -LiteralPath <String[]>
     [-Resolve]
     [-Credential <PSCredential>]
     [<CommonParameters>]

Description

cmdlet은 Split-Path 부모 폴더, 하위 폴더 또는 파일 이름과 같은 경로의 지정된 부분만 반환합니다. 또한 분할 경로에서 참조하는 항목을 가져오고 해당 경로가 상대 경로인지 아니면 절대 경로인지 표시합니다. 다른 매개 변수 Split-Path 를 지정하지 않고 경로를 분할하는 경우 제공된 경로의 부모 부분을 반환합니다.

이 Split-Path 명령은 문자열을 반환합니다. FileInfo 또는 명령과 같은 다른 항목 개체는 *-Item 반환하지 않습니다.

예제

예제 1: 경로의 한정자 가져오기

Split-Path -Path "HKCU:\Software\Microsoft" -Qualifier

HKCU:

이 명령은 경로의 한정자만 반환합니다. 한정자는 드라이브입니다.

예제 2: 경로의 파일 이름 부분 표시

Leaf 매개 변수 Split-Path 를 사용하는 경우 해당 항목이 파일인지 디렉터리인지에 관계없이 제공된 경로 문자열의 마지막 항목만 반환합니다.

Split-Path -Path .\folder1\*.txt -Leaf

*.txt

Split-Path -Path .\folder1\*.txt -Leaf -Resolve

file1.txt
file2.txt

Resolve 매개 변수 Split-Path 를 사용하는 경우 제공된 경로 문자열을 확인하고 경로에서 참조하는 항목을 반환합니다.

예제 3: 부모 컨테이너 가져오기

Parent 매개 변수 Split-Path 를 사용하는 경우 제공된 경로 문자열의 부모 컨테이너 부분만 반환합니다. Path 문자열에 부모 컨테이너 Split-Path 가 없으면 빈 문자열을 반환합니다.

Split-Path -Path .\folder1\file1.txt -Parent

.\folder1

Split-Path -Path .\folder1\file1.txt -Parent -Resolve

D:\temp\test\folder1

Resolve 매개 변수 Split-Path 를 사용하는 경우 제공된 경로 문자열을 확인하고 부모 컨테이너의 전체 경로를 반환합니다.

예제 4: 경로가 절대 경로인지 여부를 결정합니다.

이 명령은 경로가 상대 경로인지 절대 경로인지를 결정합니다. 이 경우 경로는 점().으로 표현되는 현재 폴더를 기준으로 하기 때문에 반환됩니다 $False.

Split-Path -Path ".\My Pictures\*.jpg" -IsAbsolute

False

예제 5: 위치를 지정된 경로로 변경

이 명령은 위치를 PowerShell 프로필이 포함된 폴더로 변경합니다.

PS C:\> Set-Location (Split-Path -Path $profile)
PS C:\Users\User01\Documents\PowerShell>

괄호 안의 명령은 기본 제공 $Profile 변수에 저장된 경로의 부모만 반환하는 데 사용합니다Split-Path. Parent 매개 변수는 기본 분할 위치 매개 변수입니다. 따라서 명령에서 생략할 수 있습니다. 괄호는 PowerShell이 명령을 먼저 실행하도록 지시합니다. 이 방법은 경로 이름이 긴 폴더로 이동하는 데 유용한 방법입니다.

예제 6: 파이프라인을 사용하여 경로 분할

'C:\Users\User01\My Documents\My Pictures' | Split-Path

C:\Users\User01\My Documents

이 명령은 파이프라인 연산자(|)를 사용하여 경로를 Split-Path보냅니다. 경로는 작은따옴표로 묶어 단일 토큰임을 나타냅니다.

매개 변수

-Credential

참고 항목

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

형식:PSCredential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Extension

이 cmdlet은 리프의 확장만 반환한다는 것을 나타냅니다. 예를 들어 경로에서 이 경로 C:\Test\Logs\Pass1.log는 만 .log반환합니다.

이 매개 변수는 PowerShell 6.0에서 도입되었습니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-IsAbsolute

경로가 절대 $False 경로이고 상대 경로인 경우 이 cmdlet이 반환 $True 됨을 나타냅니다. Windows에서 절대 경로 문자열은 공급자 드라이브 지정자(예 C: : 또는 HKCU:.)로 시작해야 합니다. 상대 경로는 점() 또는 점점(...)으로 시작합니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Leaf

Leaf 매개 변수 Split-Path 를 사용하는 경우 해당 항목이 파일인지 디렉터리인지에 관계없이 제공된 경로 문자열의 마지막 항목만 반환합니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-LeafBase

이 cmdlet은 리프의 기본 이름만 반환한다는 것을 나타냅니다. 예를 들어 경로에서 이 경로 C:\Test\Logs\Pass1.log는 만 Pass1반환합니다.

이 매개 변수는 PowerShell 6.0에서 도입되었습니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-LiteralPath

분할할 경로를 지정합니다. Path와 달리 LiteralPath의 값은 입력된 대로 정확하게 사용됩니다. 와일드카드 문자로 해석되는 문자는 없습니다. 경로에 이스케이프 문자가 포함된 경우 작은따옴표로 묶습니다. 작은따옴표는 PowerShell에 문자를 이스케이프 시퀀스로 해석하지 않도록 지시합니다.

형식:String[]
별칭:PSPath, LP
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-NoQualifier

이 cmdlet은 한정자 없이 경로를 반환한다는 것을 나타냅니다. FileSystem 또는 레지스트리 공급자의 경우 한정자는 공급자 경로의 드라이브(예: C: 또는 HKCU:.)입니다. 예를 들어 경로에서 이 경로 C:\Test\Logs\Pass1.log는 만 \Test\Logs\Pass1.log반환합니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Parent

Split-Path 는 제공된 경로 문자열의 부모 컨테이너 부분만 반환합니다. Path 문자열에 부모 컨테이너 Split-Path 가 없으면 빈 문자열을 반환합니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Path

분할할 경로를 지정합니다. 와일드카드 문자를 사용할 수 있습니다. 경로에 공백이 포함된 경우 따옴표로 묶습니다. 경로를 이 cmdlet으로 파이프할 수도 있습니다.

형식:String[]
Position:0
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:True

-Qualifier

이 cmdlet은 지정된 경로의 한정자만 반환한다는 것을 나타냅니다. FileSystem 또는 레지스트리 공급자의 경우 한정자는 공급자 경로의 드라이브(예: C: 또는 HKCU:.)입니다.

형식:SwitchParameter
Position:1
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Resolve

이 cmdlet은 경로 요소를 표시하는 대신 결과 분할 경로에서 참조하는 항목을 표시합니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

String

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

출력

String

이 cmdlet은 텍스트 문자열을 반환합니다. Resolve 매개 변수를 지정하면 항목의 위치를 설명하는 문자열이 반환됩니다. FileInfo 또는 RegistryKey 개체와 같은 항목을 나타내는 개체는 반환하지 않습니다.

Boolean

IsAbsolute 매개 변수를 지정하면 이 cmdlet은 부울 값을 반환합니다.

참고

  • 분할 위치 매개 변수(한정자, 부모, 확장명, 리프, 리프베이스 및 NoQualifier)는 배타적입니다. 각 명령에서 하나만 사용할 수 있습니다.

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

  • 경로 cmdlet을 여러 공급자와 함께 사용할 수 있습니다. 여기에는 FileSystem, 레지스트리 및 인증서 공급자가 포함됩니다.

  • Split-Path 는 모든 공급자가 노출하는 데이터와 함께 작동하도록 설계되었습니다. 세션에서 사용할 수 있는 공급자를 나열하려면 .를 입력 Get-PSProvider합니다. 자세한 내용은 about_Providers 참조하세요.