Invoke-Item

Referensi

Modul:: Microsoft.PowerShell.Management

Melakukan tindakan default pada item yang ditentukan.

Sintaks

Invoke-Item
      [-Path] <String[]>
      [-Filter <String>]
      [-Include <String[]>]
      [-Exclude <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-Item
      -LiteralPath <String[]>
      [-Filter <String>]
      [-Include <String[]>]
      [-Exclude <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Deskripsi

Cmdlet Invoke-Item melakukan tindakan default pada item yang ditentukan. Misalnya, menjalankan file yang dapat dieksekusi atau membuka file dokumen di aplikasi yang terkait dengan jenis file dokumen. Tindakan default bergantung pada jenis item dan ditentukan oleh penyedia PowerShell yang menyediakan akses ke data.

Contoh

Contoh 1: Membuka file

Perintah ini membuka file aliasApr04.doc di Microsoft Office Word. Dalam hal ini, membuka di Word adalah tindakan default untuk file .doc.

Invoke-Item "C:\Test\aliasApr04.doc"

Contoh 2: Buka semua file dari jenis tertentu

Perintah ini membuka semua lembar bentang Microsoft Office Excel di folder C:\Users\User1\Documents. Setiap lembar kerja dibuka dalam instance Excel baru. Dalam hal ini, membuka di Excel adalah tindakan default untuk file .xls.

Invoke-Item "C:\Users\User1\Documents\*.xls"

Parameter

-Confirm

Meminta konfirmasi sebelum menjalankan cmdlet.

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

-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:	Current user
Diperlukan:	False
Terima input alur:	True
Terima karakter wildcard:	False

-Exclude

Menentukan, sebagai array string, item atau item yang dikecualikan oleh cmdlet ini dalam operasi. Nilai parameter ini memenuhi syarat parameter Jalur. Masukkan elemen atau pola jalur, seperti *.txt. Karakter wildcard diizinkan. Parameter Exclude hanya efektif ketika perintah menyertakan konten item, seperti C:\Windows\*, di mana karakter wildcard menentukan konten direktori C:\Windows.

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

-Filter

Menentukan filter untuk memenuhi syarat parameter Jalur. Penyedia FileSystem adalah satu-satunya penyedia PowerShell yang diinstal yang mendukung penggunaan filter. Anda dapat menemukan sintaks untuk bahasa filter FileSystem dalam about_Wildcards. Filter lebih efisien daripada parameter lain karena penyedia menerapkannya saat cmdlet mengambil objek, bukan membiarkan PowerShell memfilter objek setelah pengambilan.

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

-Include

Menentukan, sebagai array string, item-item yang disertakan oleh cmdlet ini dalam operasi. Nilai parameter ini memenuhi syarat parameter Jalur. Masukkan elemen atau pola jalur, seperti "*.txt". Karakter wildcard diizinkan. Parameter Sertakan hanya efektif ketika perintah menyertakan konten item, seperti C:\Windows\*, di mana karakter wildcard menentukan konten direktori C:\Windows.

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

-LiteralPath

Menentukan jalur ke satu atau beberapa lokasi. Nilai LiteralPath digunakan persis seperti yang diketik. Tidak ada karakter yang ditafsirkan sebagai karakter pengganti. Jika jalur menyertakan karakter escape, sertakan dalam tanda kutip tunggal. Tanda kutip tunggal memberi tahu PowerShell untuk tidak menginterpretasikan karakter apa pun sebagai urutan escape.

Untuk informasi selengkapnya, lihat about_Quoting_Rules.

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

-Path

Menentukan jalur ke item terpilih. Karakter wildcard diizinkan.

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

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

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

Input

String

Anda dapat menyalurkan string yang berisi jalur ke cmdlet ini.

Output

None

Cmdlet ini tidak mengembalikan outputnya sendiri, tetapi item yang dipanggilnya dapat mengembalikan output mereka sendiri.

Catatan

PowerShell menyertakan alias berikut untuk Invoke-Item:

ii

Cmdlet ini dirancang untuk bekerja dengan data yang diekspos oleh penyedia mana pun. Untuk mencantumkan penyedia yang tersedia dalam sesi Anda, ketik Get-PSProvider. Untuk informasi lebih lanjut, lihat about_Providers.

Bagikan melalui