Test-Path

Referensi

Modul:: Microsoft.PowerShell.Management

Menentukan apakah semua elemen jalur ada.

Sintaks

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

Deskripsi

Cmdlet Test-Path menentukan apakah semua elemen jalur ada. Ini mengembalikan $true jika semua elemen ada dan $false jika ada yang hilang. Ini juga dapat mengetahui apakah sintaks jalur valid dan apakah jalur mengarah ke kontainer atau terminal atau elemen daun. Jika Jalur adalah spasi kosong atau string kosong, cmdlet mengembalikan $false. Jika Jalur adalah $null, sebuah array $null atau array kosong, cmdlet mengembalikan kesalahan yang tidak mengakhiri.

Contoh

Contoh 1: Menguji jalur

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

True

Perintah ini memeriksa apakah semua elemen di jalur ada, termasuk direktori C:, direktori Documents and Settings, dan direktori DavidC. Jika ada yang hilang, cmdlet mengembalikan $false. Jika tidak, ia mengembalikan $true.

Contoh 2: Menguji jalur profil

Test-Path -Path $profile

False

Test-Path -Path $profile -IsValid

True

Perintah ini menguji jalur profil PowerShell.

Perintah pertama menentukan apakah semua elemen dalam jalur ada. Perintah kedua menentukan apakah sintaks jalur sudah benar. Dalam hal ini, jalurnya $false, tetapi sintaksnya benar $true. Perintah ini menggunakan $profile, variabel otomatis yang menunjuk ke lokasi untuk profil, bahkan jika profil tidak ada.

Untuk informasi selengkapnya tentang variabel otomatis, lihat about_Automatic_Variables.

Contoh 3: Periksa apakah ada file selain jenis tertentu

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

False

Perintah ini memeriksa apakah ada file di direktori Bangunan Komersial selain file .dwg.

Perintah menggunakan parameter Jalur untuk menentukan jalur. Karena jalur menyertakan spasi, jalur diapit dalam tanda kutip. Tanda bintang di akhir jalur menunjukkan konten direktori Bangunan Komersial. Dengan jalur panjang, seperti ini, ketik beberapa huruf pertama jalur, lalu gunakan kunci TAB untuk menyelesaikan jalur.

Perintah menentukan parameter Kecualikan untuk menentukan file yang akan dihilangkan dari evaluasi.

Dalam hal ini, karena direktori hanya berisi file .dwg, hasilnya $false.

Contoh 4: Memeriksa file

Test-Path -Path $profile -PathType leaf

True

Perintah ini memeriksa apakah jalur yang disimpan dalam variabel $profile mengarah ke file. Dalam hal ini, karena profil PowerShell adalah file .ps1, cmdlet mengembalikan $true.

Contoh 5: Periksa jalur di Registri

Perintah ini menggunakan Test-Path dengan penyedia registri PowerShell.

Perintah pertama menguji apakah jalur registri kunci registri Microsoft.PowerShell benar pada sistem. Jika PowerShell diinstal dengan benar, cmdlet mengembalikan $true.

Penting

Test-Path tidak berfungsi dengan benar dengan semua penyedia PowerShell. Misalnya, Anda dapat menggunakan Test-Path untuk menguji jalur kunci registri, tetapi jika Anda menggunakannya untuk menguji jalur entri registri, itu selalu mengembalikan $false, bahkan jika entri registri ada.

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

Contoh 6: Menguji apakah file berada dalam rentang tanggal

Perintah ini menggunakan parameter dinamis NewerThan dan OlderThan untuk menentukan apakah file pwsh.exe di komputer lebih baru dari July 13, 2009 dan lebih lama dari minggu lalu.

Parameter NewerThan dan OlderThan hanya berfungsi di drive sistem file.

Get-Command pwsh |
    Select-Object -ExpandProperty Path |
    Test-Path -NewerThan "July 13, 2009" -OlderThan (Get-Date).AddDays(-7)

True

Contoh 7: Menguji jalur dengan null sebagai nilai

Kesalahan yang dikembalikan untuk null, array null, atau array yang kosong adalah kesalahan yang tidak mengakhiri proses. Ini dapat ditahan dengan menggunakan -ErrorAction SilentlyContinue. Contoh berikut menunjukkan semua kasus yang mengembalikan kesalahan 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

Contoh 8: Menguji jalur dengan spasi kosong sebagai nilai

Saat string spasi putih disediakan untuk parameter Jalur, string tersebut mengembalikan $false. Ini adalah perubahan dari Windows PowerShell 5.1. Saat string kosong disediakan, Test-Path mengembalikan kesalahan. Contoh berikut menunjukkan spasi kosong dan string kosong.

Test-Path ' '
Test-Path ''

False
False

Contoh 9: Menguji jalur yang mungkin memiliki drive yang tidak valid

Saat Anda menguji jalur yang menyertakan spesifikasi drive, pengujian validitas jalur akan gagal jika drive tersebut tidak ada. Anda dapat mengawali drive dengan nama penyedia untuk mengatasi masalah ini.

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

False
True

Parameter

-Credential

Nota

Parameter ini tidak didukung oleh penyedia apa pun yang diinstal dengan PowerShell. Untuk meniru pengguna lain, atau meningkatkan kredensial Anda saat menjalankan cmdlet ini, gunakan Invoke-Command.

Jenis:	PSCredential
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	True
Terima karakter wildcard:	False

-Exclude

Menentukan item yang tidak disertakan oleh cmdlet ini. Nilai parameter ini memenuhi syarat parameter Jalur. Masukkan elemen atau pola jalur, seperti *.txt. Karakter wildcard diizinkan.

Jenis:	String[]
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	True

-Filter

Menentukan filter dalam format atau bahasa penyedia. Nilai parameter ini memenuhi syarat parameter Jalur. Sintaks filter, termasuk penggunaan karakter wildcard, tergantung pada penyedia. Filter lebih efisien daripada parameter lain, karena penyedia menerapkannya saat mengambil objek alih-alih meminta PowerShell memfilter objek setelah diambil.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	True

-Include

Menentukan jalur yang diuji oleh cmdlet ini. Nilai parameter ini memenuhi syarat parameter Jalur. Masukkan elemen atau pola jalur, seperti *.txt. Karakter wildcard diizinkan.

Jenis:	String[]
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	True

-IsValid

Menunjukkan bahwa cmdlet ini menguji sintaks jalur, terlepas dari apakah elemen jalur ada. Cmdlet ini mengembalikan $true jika sintaks jalur valid dan $false jika tidak. Jika jalur yang sedang diuji menyertakan spesifikasi drive, cmdlet mengembalikan nilai false saat drive tidak ada. PowerShell mengembalikan false karena tidak tahu penyedia drive mana yang akan diuji.

Nota

Perubahan yang signifikan dalam API Path diperkenalkan di .NET 2.1. Metode tersebut tidak lagi memeriksa karakter jalur yang tidak valid. Perubahan ini menyebabkan regresi di PowerShell di mana pemeriksaan IsValid tidak lagi menguji karakter yang tidak valid. Regresi akan ditangani dalam rilis mendatang. Untuk informasi selengkapnya, lihat Perubahan yang merusak di .NET Core 2.1.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-LiteralPath

Menentukan jalur yang akan diuji. Tidak seperti Path, nilai parameter LiteralPath digunakan persis seperti yang ditik. Tidak ada karakter yang ditafsirkan sebagai karakter joker. Jika jalur menyertakan karakter yang dapat ditafsirkan oleh PowerShell sebagai urutan escape, Anda harus mengapit jalur dalam tanda kutip tunggal agar tidak ditafsirkan.

Jenis:	String[]
Alias:	PSPath, LP
Position:	Named
Nilai default:	None
Diperlukan:	True
Terima input alur:	True
Terima karakter wildcard:	False

-NewerThan

Ini adalah parameter dinamis yang disediakan oleh penyedia FileSystem.

Tentukan waktu sebagai objek DateTime .

Sebelum PowerShell 7.5, cmdlet mengabaikan:

Parameter ini ketika Anda menentukan PathType sebagai nilai apa pun selain Any.
Parameter OlderThan saat digunakan dengan parameter ini.
Parameter ini digunakan ketika jalur menunjuk ke direktori.

Dimulai dengan PowerShell 7.5, Anda dapat menggunakan parameter ini dengan nilai apa pun untuk parameter PathType, untuk menguji rentang tanggal dengan parameter OlderThan, dan untuk menguji usia direktori.

Untuk informasi selengkapnya, lihat about_FileSystem_Provider.

Jenis:	Nullable<T>[[DateTime]]
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-OlderThan

Ini adalah parameter dinamis yang disediakan oleh penyedia FileSystem.

Tentukan waktu sebagai objek DateTime .

Sebelum PowerShell 7.5, cmdlet mengabaikan:

Parameter ini ketika Anda menentukan PathType sebagai nilai apa pun selain Any.
Parameter ini saat digunakan dengan parameter NewerThan.
Parameter ini digunakan ketika jalur menunjuk ke direktori.

Dimulai dengan PowerShell 7.5, Anda dapat menggunakan parameter ini dengan nilai apa pun untuk parameter PathType, untuk menguji rentang tanggal dengan parameter NewerThan, dan untuk menguji usia direktori.

Untuk informasi selengkapnya, lihat about_FileSystem_Provider.

Jenis:	Nullable<T>[[DateTime]]
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Path

Menentukan jalur yang akan diuji. Karakter wildcard diizinkan. Jika jalur menyertakan spasi, sertakan dalam tanda kutip.

Jenis:	String[]
Position:	0
Nilai default:	None
Diperlukan:	True
Terima input alur:	True
Terima karakter wildcard:	True

-PathType

Menentukan jenis elemen akhir dalam jalur. Cmdlet ini mengembalikan $true jika elemennya adalah jenis yang ditentukan dan $false jika tidak. Nilai yang dapat diterima untuk parameter ini adalah:

Container - Elemen yang berisi elemen lain, seperti direktori atau kunci registri.
Leaf - Elemen yang tidak berisi elemen lain, seperti file.
Any - Baik kontainer atau daun.

Memberi tahu apakah elemen akhir dalam jalur adalah jenis tertentu.

Perhatian

Hingga PowerShell versi 6.1.2, saat sakelar IsValid dan PathType ditentukan bersama-sama, cmdlet Test-Path mengabaikan sakelar PathType dan hanya memvalidasi jalur sintaktik tanpa memvalidasi jenis jalur.

Menurut masalah #8607, memperbaiki perilaku ini mungkin akan menjadi perubahan signifikan dalam versi mendatang, di mana sakelar IsValid dan PathType termasuk dalam set parameter yang terpisah, dan karenanya tidak dapat digunakan bersamaan yang dapat mencegah kebingungan ini.

Jenis:	TestPathType
Alias:	Type
Nilai yang diterima:	Any, Container, Leaf
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

Input

String

Anda dapat menyalurkan string yang berisi jalur, tetapi bukan jalur harfiah, ke cmdlet ini.

Output

Boolean

Cmdlet mengembalikan nilai Boolean.

Catatan

Cmdlet yang berisi kata benda Jalur (cmdlet Jalur ) bekerja dengan jalur dan mengembalikan nama dalam format singkat yang dapat diinterpretasikan oleh semua penyedia PowerShell. Mereka dirancang untuk digunakan dalam program dan skrip tempat Anda ingin menampilkan semua atau sebagian jalur dalam format tertentu. Gunakan mereka seperti Anda akan menggunakan Dirname, Normpath, Realpath, Join, atau manipulator jalur lainnya.

Test-Path dirancang untuk bekerja dengan data yang diekspos oleh penyedia mana pun. Untuk mencantumkan penyedia yang tersedia dalam sesi Anda, ketik Get-PSProvider. Untuk informasi selengkapnya, lihat about_Providers.

Bagikan melalui

Test-Path

Sintaks

Deskripsi

Contoh

Contoh 1: Menguji jalur

Contoh 2: Menguji jalur profil

Contoh 3: Periksa apakah ada file selain jenis tertentu

Contoh 4: Memeriksa file

Contoh 5: Periksa jalur di Registri

Contoh 6: Menguji apakah file berada dalam rentang tanggal

Contoh 7: Menguji jalur dengan null sebagai nilai

Contoh 8: Menguji jalur dengan spasi kosong sebagai nilai

Contoh 9: Menguji jalur yang mungkin memiliki drive yang tidak valid

Parameter

-Credential

-Exclude

-Filter

-Include

-IsValid

-LiteralPath

-NewerThan

-OlderThan

-Path

-PathType

Input

Output

Catatan

Sumber Daya Tambahan:

Bagikan melalui

Test-Path

Sintaks

Deskripsi

Contoh

Contoh 1: Menguji jalur

Contoh 2: Menguji jalur profil

Contoh 3: Periksa apakah ada file selain jenis tertentu

Contoh 4: Memeriksa file

Contoh 5: Periksa jalur di Registri

Contoh 6: Menguji apakah file berada dalam rentang tanggal

Contoh 7: Menguji jalur dengan null sebagai nilai

Contoh 8: Menguji jalur dengan spasi kosong sebagai nilai

Contoh 9: Menguji jalur yang mungkin memiliki drive yang tidak valid

Parameter

-Credential

-Exclude

-Filter

-Include

-IsValid

-LiteralPath

-NewerThan

-OlderThan

-Path

-PathType

Input

Output

Catatan

Link Terkait

Sumber Daya Tambahan: