Test-Path

참조

모듈:: Microsoft.PowerShell.Management

경로의 모든 요소가 있는지 여부를 확인합니다.

구문

Test-Path
    [-Path] <String[]>
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-PathType <TestPathType>]
    [-IsValid]
    [-Credential <PSCredential>]
    [-OlderThan <DateTime>]
    [-NewerThan <DateTime>]
    [<CommonParameters>]

Test-Path
    -LiteralPath <String[]>
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-PathType <TestPathType>]
    [-IsValid]
    [-Credential <PSCredential>]
    [-OlderThan <DateTime>]
    [-NewerThan <DateTime>]
    [<CommonParameters>]

Test-Path
    [-Path] <string[]>
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-PathType <TestPathType>]
    [-IsValid]
    [-Credential <pscredential>]
    [<CommonParameters>]

Test-Path
    -LiteralPath <string[]>
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-PathType <TestPathType>]
    [-IsValid]
    [-Credential <pscredential>]
    [<CommonParameters>]

Description

cmdlet은 Test-Path 경로의 모든 요소가 있는지 여부를 결정합니다. 모든 요소가 존재하고 $false 누락된 요소가 있으면 반환 $true 됩니다. 또한 경로 구문이 유효한지 여부와 경로가 컨테이너 또는 터미널 또는 리프 요소로 이어지는지 여부를 알 수 있습니다. Path가 공백 또는 빈 문자열이면 cmdlet이 반환됩니다$false. Path가 $null배열이거나 빈 배열 $null 인 경우 cmdlet은 종료되지 않는 오류를 반환합니다.

예제

예제 1: 경로 테스트

Test-Path -Path "C:\Documents and Settings\DavidC"

True

이 명령은 디렉터리, 디렉터리 및 DavidC 디렉터리를 포함하여 경로의 C: Documents and Settings 모든 요소가 존재하는지 확인합니다. 누락된 항목이 있으면 cmdlet이 반환됩니다 $false. 그 외의 경우 $true를 반환합니다.

예제 2: 프로필 경로 테스트

Test-Path -Path $profile

False

Test-Path -Path $profile -IsValid

True

이러한 명령은 PowerShell 프로필의 경로를 테스트합니다.

첫 번째 명령은 경로의 모든 요소가 존재하는지 여부를 결정합니다. 두 번째 명령은 경로의 구문이 올바른지 확인합니다. 이 경우 경로는 $false올바르지만 구문은 맞습니다 $true. 이러한 명령은 프로필이 없는 경우에도 프로필의 위치를 가리키는 자동 변수를 사용합니다 $profile.

자동 변수에 대한 자세한 내용은 about_Automatic_Variables 참조하세요.

예제 3: 지정된 형식 외에 파일이 있는지 확인

Test-Path -Path "C:\CAD\Commercial Buildings\*" -Exclude *.dwg

False

이 명령은 .dwg 파일 이외의 상업용 건물 디렉터리에 파일이 있는지 확인합니다.

이 명령은 Path 매개 변수를 사용하여 경로를 지정합니다. 경로에 공백이 포함되어 있으므로 경로는 따옴표로 묶습니다. 경로 끝의 별표는 Commercial Building 디렉터리의 내용을 나타냅니다. 이와 같은 긴 경로를 사용하여 경로의 처음 몇 글자를 입력한 다음 TAB 키를 사용하여 경로를 완료합니다.

이 명령은 평가에서 생략할 파일을 지정하는 Exclude 매개 변수를 지정합니다.

이 경우 디렉터리에 .dwg 파일만 포함되므로 결과는 다음과 같습니다 $false.

예제 4: 파일 확인

Test-Path -Path $profile -PathType leaf

True

이 명령은 변수에 저장된 경로가 파일로 $profile 이어지는지 여부를 확인합니다. 이 경우 PowerShell 프로필은 파일이므로 .ps1 cmdlet이 반환됩니다 $true.

예제 5: 레지스트리의 경로 확인

이러한 명령은 PowerShell 레지스트리 공급자와 함께 사용합니다 Test-Path .

첫 번째 명령은 시스템에서 Microsoft.PowerShell 레지스트리 키의 레지스트리 경로가 올바른지 테스트합니다. PowerShell이 올바르게 설치되면 cmdlet이 반환됩니다 $true.

Important

Test-Path 는 모든 PowerShell 공급자에서 제대로 작동하지 않습니다. 예를 들어 레지스트리 키의 경로를 테스트하는 데 사용할 Test-Path 수 있지만 레지스트리 항목의 경로를 테스트하는 데 사용하면 레지스트리 항목이 있는 경우에도 항상 반환 $false됩니다.

Test-Path -Path "HKLM:\Software\Microsoft\PowerShell\1\ShellIds\Microsoft.PowerShell"

True

Test-Path -Path "HKLM:\Software\Microsoft\PowerShell\1\ShellIds\Microsoft.PowerShell\ExecutionPolicy"

False

예제 6: 지정된 날짜보다 최신 파일인지 테스트

이 명령은 NewerThan 동적 매개 변수를 사용하여 컴퓨터July 13, 2009의 pwsh.exe 파일이 최신 파일인지 여부를 확인합니다.

NewerThan 매개 변수는 파일 시스템 드라이브에서만 작동합니다.

Test-Path $pshome\pwsh.exe -NewerThan "July 13, 2009"

True

예제 7: null을 값으로 사용하여 경로 테스트

배열의 null 배열 또는 빈 배열에 대해 null반환된 오류는 종료되지 않는 오류입니다. 를 사용하여 -ErrorAction SilentlyContinue표시하지 않을 수 있습니다. 다음 예제에서는 오류를 반환하는 모든 사례를 보여 줍니다 NullPathNotPermitted .

Test-Path $null
Test-Path $null, $null
Test-Path @()

Test-Path : Cannot bind argument to parameter 'Path' because it is null.
At line:1 char:11
+ Test-Path $null
+           ~~~~~
    + CategoryInfo          : InvalidData: (:) [Test-Path], ParameterBindingValidationException
    + FullyQualifiedErrorId : ParameterArgumentValidationErrorNullNotAllowed,Microsoft.PowerShell.Commands.TestPathCommand

예제 8: 공백을 값으로 사용하여 경로 테스트

Path 매개 변수에 대해 공백 문자열이 제공되면 반환됩니다$false. 이는 Windows PowerShell 5.1에서 변경된 내용입니다. 빈 문자열이 제공되면 Test-Path 오류를 반환합니다. 다음 예제에서는 공백과 빈 문자열을 보여 있습니다.

Test-Path ' '
Test-Path ''

False
False

예제 9: 잘못된 드라이브가 있을 수 있는 경로 테스트

드라이브 사양이 포함된 경로를 테스트할 때 드라이브가 없으면 경로의 유효성을 테스트하지 못합니다. 이 문제를 해결하려면 드라이브 앞에 공급자 이름을 접두사로 추가할 수 있습니다.

Test-Path -IsValid Z:\abc.txt
Test-Path -IsValid FileSystem::Z:\abc.txt

False
True

매개 변수

-Credential

참고 항목

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

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

-Exclude

이 cmdlet에서 생략하는 항목을 지정합니다. 이 매개 변수의 값은 Path 매개 변수를 한정합니다. 경로 요소 또는 패턴(예: *.txt.)을 입력합니다. 와일드카드 문자를 사용할 수 있습니다.

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

-Filter

공급자의 형식 또는 언어로 필터를 지정합니다. 이 매개 변수의 값은 Path 매개 변수를 한정합니다. 와일드카드 문자 사용을 포함하여 필터의 구문은 공급자에 따라 달라집니다. 필터는 검색된 후 PowerShell이 개체를 필터링하지 않고 개체를 검색할 때 적용하기 때문에 다른 매개 변수보다 더 효율적입니다.

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

-Include

이 cmdlet이 테스트하는 경로를 지정합니다. 이 매개 변수의 값은 Path 매개 변수를 한정합니다. 경로 요소 또는 패턴(예: *.txt.)을 입력합니다. 와일드카드 문자를 사용할 수 있습니다.

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

-IsValid

이 cmdlet은 경로의 요소가 있는지 여부에 관계없이 경로의 구문을 테스트한다는 것을 나타냅니다. 이 cmdlet은 경로 구문이 유효한지와 $false 그렇지 않은 경우 반환 $true 합니다. 테스트 중인 경로에 드라이브 사양이 포함되어 있으면 드라이브가 없으면 cmdlet이 false를 반환합니다. PowerShell은 테스트할 드라이브 공급자를 모르기 때문에 false를 반환합니다.

참고 항목

.NET 2.1에서는 경로 API의 호환성이 손상되는 변경이 도입되었습니다. 이러한 메서드는 더 이상 잘못된 경로 문자를 확인하지 않습니다. 이 변경으로 인해 PowerShell 에서 회귀가 발생하여 IsValid 검사가 더 이상 잘못된 문자를 테스트하지 않습니다. 회귀는 향후 릴리스에서 해결될 예정입니다. 자세한 내용은 .NET Core 2.1의 호환성이 손상되는 변경 내용을 참조하세요.

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

-LiteralPath

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

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

-NewerThan

FileSystem 공급자가 사용할 수 있는 동적 매개 변수입니다.

시간을 DateTime 개체로 지정합니다.

PowerShell 7.5 이전에는 cmdlet이 다음을 무시합니다.

PathType을 이외의 값Any으로 지정할 때 이 매개 변수입니다.
이 매개 변수와 함께 사용되는 경우 OlderThan 매개 변수입니다.
Path가 디렉터리를 가리키는 경우 이 매개 변수입니다.

PowerShell 7.5부터 PathType 매개 변수에 대한 모든 값과 함께 이 매개 변수를 사용하여 OlderThan 매개 변수로 날짜 범위를 테스트하고 디렉터리 기간을 테스트할 수 있습니다.

자세한 내용은 about_FileSystem_Provider 참조하세요.

형식:	Nullable<T>[[DateTime]]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-OlderThan

FileSystem 공급자가 사용할 수 있는 동적 매개 변수입니다.

시간을 DateTime 개체로 지정합니다.

PowerShell 7.5 이전에는 cmdlet이 다음을 무시합니다.

PathType을 이외의 값Any으로 지정할 때 이 매개 변수입니다.
NewerThan 매개 변수와 함께 사용할 경우 이 매개 변수입니다.
Path가 디렉터리를 가리키는 경우 이 매개 변수입니다.

PowerShell 7.5부터 PathType 매개 변수에 대한 값과 함께 이 매개 변수를 사용하여 NewerThan 매개 변수로 날짜 범위를 테스트하고 디렉터리 기간을 테스트할 수 있습니다.

자세한 내용은 about_FileSystem_Provider 참조하세요.

형식:	Nullable<T>[[DateTime]]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Path

테스트할 경로를 지정합니다. 와일드카드 문자를 사용할 수 있습니다. 경로에 공백이 포함된 경우 따옴표로 묶습니다.

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

-PathType

경로에 있는 최종 요소의 형식을 지정합니다. 이 cmdlet은 요소가 지정된 형식 $false 이고 그렇지 않은 경우 반환 $true 합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

Container - 디렉터리 또는 레지스트리 키와 같은 다른 요소를 포함하는 요소입니다.
Leaf - 파일과 같은 다른 요소를 포함하지 않는 요소입니다.
Any - 컨테이너 또는 리프 중 하나.

경로에서 마지막 요소가 특정 유형인지를 나타냅니다.

주의

PowerShell 버전 6.1.2까지 IsValid 및 PathType 스위치를 함께 Test-Path 지정하면 cmdlet은 PathType 스위치를 무시하고 경로 형식의 유효성을 검사하지 않고 구문 경로의 유효성만 검사합니다.

문제 #8607에 따르면 이 동작을 수정하는 것은 IsValid 및 PathType 스위치가 별도의 매개 변수 집합에 속하므로 이러한 혼동을 피하기 위해 함께 사용할 수 없는 이후 버전의 호환성이 손상되는 변경일 수 있습니다.

형식:	TestPathType
별칭:	Type
허용되는 값:	Any, Container, Leaf
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

입력

String

리터럴 경로가 아닌 경로가 포함된 문자열을 이 cmdlet으로 파이프할 수 있습니다.

출력

Boolean

cmdlet은 부울 값을 반환합니다.

참고

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

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

다음을 통해 공유

Test-Path

구문

Description

예제

예제 1: 경로 테스트

예제 2: 프로필 경로 테스트

예제 3: 지정된 형식 외에 파일이 있는지 확인

예제 4: 파일 확인

예제 5: 레지스트리의 경로 확인

예제 6: 지정된 날짜보다 최신 파일인지 테스트

예제 7: null을 값으로 사용하여 경로 테스트

예제 8: 공백을 값으로 사용하여 경로 테스트

예제 9: 잘못된 드라이브가 있을 수 있는 경로 테스트

매개 변수

-Credential

-Exclude

-Filter

-Include

-IsValid

-LiteralPath

-NewerThan

-OlderThan

-Path

-PathType

입력

출력

참고

추가 리소스

다음을 통해 공유

Test-Path

구문

Description

예제

예제 1: 경로 테스트

예제 2: 프로필 경로 테스트

예제 3: 지정된 형식 외에 파일이 있는지 확인

예제 4: 파일 확인

예제 5: 레지스트리의 경로 확인

예제 6: 지정된 날짜보다 최신 파일인지 테스트

예제 7: null을 값으로 사용하여 경로 테스트

예제 8: 공백을 값으로 사용하여 경로 테스트

예제 9: 잘못된 드라이브가 있을 수 있는 경로 테스트

매개 변수

-Credential

-Exclude

-Filter

-Include

-IsValid

-LiteralPath

-NewerThan

-OlderThan

-Path

-PathType

입력

출력

참고

관련 링크

추가 리소스