Test-Path

참조

모듈:: Microsoft.PowerShell.Management

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

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>]

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

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

Description

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

예제

예제 1: 경로 테스트

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

True

이 명령은 디렉터리, Documents and Settings 디렉터리 및 DavidC 디렉터리를 포함하여 경로의 C: 모든 요소가 존재하는지 여부를 검사. 누락된 항목이 있으면 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의 PowerShell.exe 파일이 최신 파일인지 여부를 확인합니다.

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 매개 변수에 대해 공백 문자열이 제공되면 반환됩니다$true. 빈 문자열이 제공되면 Test-Path 오류를 반환합니다. 다음 예제에서는 공백과 빈 문자열을 보여 있습니다.

Test-Path ' '
Test-Path ''

True
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

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

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

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

False
True

매개 변수

-Credential

참고 항목

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

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Exclude

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	True

-Filter

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	True

-Include

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	True

-IsValid

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LiteralPath

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

Type:	String[]
Aliases:	PSPath
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-NewerThan

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

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

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

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

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

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

Type:	Nullable<T>[[DateTime]]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-OlderThan

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

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

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

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

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

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

Type:	Nullable<T>[[DateTime]]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Path

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

Type:	String[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	True

-PathType

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

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

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

주의

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

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

Type:	TestPathType
Aliases:	Type
Accepted values:	Any, Container, Leaf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UseTransaction

활성 트랜잭션에 명령을 포함합니다. 이 매개 변수는 트랜잭션이 진행 중인 경우에만 유효합니다. 자세한 내용은 about_Transactions 참조 하세요.

Type:	SwitchParameter
Aliases:	usetx
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

입력

String

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

출력

Boolean

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

참고

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

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

Share via

Test-Path

Syntax

Description

예제

예제 1: 경로 테스트

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

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

예제 4: 파일 확인

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

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

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

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

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

매개 변수

-Credential

-Exclude

-Filter

-Include

-IsValid

-LiteralPath

-NewerThan

-OlderThan

-Path

-PathType

-UseTransaction

입력

출력

참고

피드백

추가 리소스

Share via

Test-Path

Syntax

Description

예제

예제 1: 경로 테스트

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

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

예제 4: 파일 확인

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

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

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

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

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

매개 변수

-Credential

-Exclude

-Filter

-Include

-IsValid

-LiteralPath

-NewerThan

-OlderThan

-Path

-PathType

-UseTransaction

입력

출력

참고

관련 링크

피드백

추가 리소스