Test-Path

Syntax

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

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

Description

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

예제

예제 1: 경로 테스트

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

True

이 명령은 경로의 모든 요소, 즉 C: 디렉터리, 문서 및 설정 디렉터리 및 DavidC 디렉터리가 있는지 확인합니다. 누락된 항목이 있으면 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.

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 동적 매개 변수를 사용하여 컴퓨터의 "PowerShell.exe" 파일이 "2009년 7월 13일"보다 최신인지 여부를 확인합니다.

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

Test-Path $pshome\PowerShell.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를 반환합니다. 다음 예제에서는 공백 및 빈 문자열을 보여 냅니다.

Test-Path ' '
Test-Path ''

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

매개 변수

-Credential

-Exclude

-Filter

-Include

-IsValid

-LiteralPath

-NewerThan

-OlderThan

-Path

-PathType

-UseTransaction

입력

String

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

출력

Boolean

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

참고

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

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

관련 링크

• Convert-Path
• Join-Path
• Resolve-Path
• Split-Path