Test-Path

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

Deskripsi

Test-Path Cmdlet 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, maka $False dikembalikan. Jika Jalur adalah $null, array dari $null atau array kosong, kesalahan yang tidak mengakhiri dikembalikan.

Contoh

Contoh 1: Menguji jalur

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

True

Perintah ini memeriksa apakah semua elemen di jalur ada, C: yaitu direktori, Documents and Settings direktori, dan DavidC direktori. Jika ada yang hilang, cmdlet mengembalikan $False. Jika tidak, ia kembali $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 di jalur ada. Perintah kedua menentukan apakah sintaks jalur sudah benar. Dalam hal ini, jalurnya adalah $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 yang ditentukan

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 tombol 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 adalah $False.

Contoh 4: Memeriksa file

Test-Path -Path $profile -PathType leaf

True

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

Contoh 5: Periksa jalur di Registri

Perintah ini digunakan Test-Path dengan penyedia registri PowerShell.

Perintah pertama menguji apakah jalur registri kunci registri Microsoft.PowerShell sudah benar pada sistem. Jika PowerShell diinstal dengan benar, cmdlet akan 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 , bahkan jika entri registri $Falseada.

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: Uji apakah file lebih baru dari tanggal yang ditentukan

Perintah ini menggunakan parameter dinamis NewerThan untuk menentukan apakah file "PowerShell.exe" di komputer lebih baru dari "13 Juli 2009".

Parameter NewerThan hanya berfungsi di drive sistem file.

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

True

Contoh 7: Menguji jalur dengan null sebagai nilai

Kesalahan yang dikembalikan untuk null, array dari null atau array kosong adalah kesalahan yang tidak mengakhiri. Ini dapat ditekan dengan menggunakan -ErrorAction SilentlyContinue. Contoh berikut menunjukkan semua kasus yang mengembalikan NullPathNotPermitted kesalahan.

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

Parameter

-Credential

Catatan

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.

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

-Exclude

Menentukan item yang dihilangkan cmdlet ini. Nilai parameter ini memenuhi syarat parameter Path . Masukkan elemen atau pola jalur, seperti "*.txt". Karakter kartubebas diizinkan.

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

-Filter

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

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

-Include

Menentukan jalur yang diuji cmdlet ini. Nilai parameter ini memenuhi syarat parameter Path . Masukkan elemen atau pola jalur, seperti "*.txt". Karakter kartubebas diizinkan.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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 kartubebas. Jika jalur menyertakan karakter yang dapat ditafsirkan oleh PowerShell sebagai urutan escape, Anda harus mengapit jalur dalam tanda kutip tunggal sehingga tidak akan ditafsirkan.

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

-NewerThan

Tentukan waktu sebagai objek DateTime .

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

-OlderThan

Tentukan waktu sebagai objek DateTime .

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

-Path

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

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

-PathType

Menentukan jenis elemen akhir di jalur. Cmdlet ini mengembalikan jika elemen berjenis $True yang ditentukan dan $False jika tidak. Nilai yang dapat diterima untuk parameter ini adalah:

  • Wadah. Elemen yang berisi elemen lain, seperti direktori atau kunci registri.
  • Daun. Elemen yang tidak berisi elemen lain, seperti file.
  • Semua. Baik kontainer atau daun.

Memberi tahu apakah elemen akhir di jalur adalah jenis tertentu.

Perhatian

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

Menurut masalah #8607, memperbaiki perilaku ini mungkin merupakan perubahan yang melanggar dalam versi mendatang, di mana sakelar IsValid dan PathType termasuk dalam set parameter terpisah, dan dengan demikian, tidak dapat digunakan bersama-sama menghindari kebingungan ini.

Type:TestPathType
Aliases:Type
Accepted values:Any, Container, Leaf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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 ) berfungsi dengan nama jalur dan mengembalikan nama dalam format ringkas yang dapat ditafsirkan oleh semua penyedia PowerShell. Mereka dirancang untuk digunakan dalam program dan skrip di mana Anda ingin menampilkan semua atau sebagian dari nama jalur dalam format tertentu. Gunakan karena 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 di sesi Anda, ketik Get-PSProvider. Untuk informasi selengkapnya, lihat about_Providers.