Bagikan melalui

Remove-CimInstance

  • Referensi
Modul:
CimCmdlets

Menghapus instans CIM dari komputer.

Sintaks

Remove-CimInstance
      [-ResourceUri <Uri>]
      [-ComputerName <String[]>]
      [-OperationTimeoutSec <UInt32>]
      [-InputObject] <CimInstance>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CimInstance
      -CimSession <CimSession[]>
      [-ResourceUri <Uri>]
      [-OperationTimeoutSec <UInt32>]
      [-InputObject] <CimInstance>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CimInstance
      -CimSession <CimSession[]>
      [[-Namespace] <String>]
      [-OperationTimeoutSec <UInt32>]
      [-Query] <String>
      [-QueryDialect <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CimInstance
      [-ComputerName <String[]>]
      [[-Namespace] <String>]
      [-OperationTimeoutSec <UInt32>]
      [-Query] <String>
      [-QueryDialect <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Deskripsi

Cmdlet ini hanya tersedia di platform Windows.

Cmdlet ini menghapus instans CIM dari server CIM. Anda dapat menentukan instans CIM yang akan dihapus dengan menggunakan objek instans CIM yang diambil oleh Get-CimInstance cmdlet, atau dengan menentukan kueri.

Jika parameter InputObject tidak ditentukan, cmdlet berfungsi dengan salah satu cara berikut:

  • Jika parameter ComputerName maupun parameter CimSession tidak ditentukan, cmdlet ini tidak berfungsi pada Instrumentasi Manajemen Windows (WMI) lokal menggunakan sesi Model Objek Komponen (COM).
  • Jika parameter ComputerName atau parameter CimSession ditentukan, maka cmdlet ini berfungsi terhadap server CIM yang ditentukan oleh parameter ComputerName atau parameter CimSession.

Contoh

Contoh 1: Menghapus instans CIM

Contoh ini menggunakan parameter Kueri untuk menghapus instans CIM dari kelas bernama Win32_Environment yang dimulai dengan testvar string karakter .

Remove-CimInstance -Query 'Select * from Win32_Environment where name LIKE "testvar%"'

Contoh 2: Hapus instans CIM menggunakan objek instans CIM

Contoh ini mengambil objek instans CIM yang difilter oleh parameter Kueri dan menyimpannya dalam variabel bernama $var menggunakan Get-CimInstance cmdlet. Konten variabel kemudian diteruskan ke Remove-CimInstance cmdlet, yang menghapus instans CIM.

notepad.exe
$var = Get-CimInstance -Query 'Select * from Win32_Process where name LIKE "notepad%"'
Remove-CimInstance -InputObject $var

Parameter

-CimSession

Menjalankan perintah menggunakan sesi CIM yang ditentukan. Masukkan variabel yang berisi sesi CIM, atau perintah yang membuat atau mendapatkan sesi CIM, seperti New-CimSession cmdlet atau Get-CimSession . Untuk informasi selengkapnya, lihat about_CimSession.

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

-ComputerName

Menentukan nama komputer tempat Anda ingin menjalankan operasi CIM. Anda dapat menentukan nama domain yang sepenuhnya memenuhi syarat (FQDN) atau nama NetBIOS.

Jika Anda menentukan parameter ini, cmdlet membuat sesi sementara ke komputer yang ditentukan menggunakan protokol WsMan.

Jika Anda tidak menentukan parameter ini, cmdlet melakukan operasi pada komputer lokal menggunakan Model Objek Komponen (COM).

Jika beberapa operasi sedang dilakukan pada komputer yang sama, menyambungkan menggunakan sesi CIM memberikan performa yang lebih baik.

Jenis:String[]
Alias:CN, ServerName
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

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

-InputObject

Menentukan objek instans CIM yang akan dihapus dari server CIM. Objek yang diteruskan ke cmdlet tidak diubah, hanya instans di server CIM yang dihapus.

Parameter InputObject tidak menghitung koleksi. Jika koleksi diteruskan, kesalahan akan muncul. Saat bekerja dengan koleksi, pipa input untuk menghitung nilai.

Jenis:CimInstance
Alias:CimInstance
Position:1
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-Namespace

Menentukan namespace layanan untuk operasi CIM. Namespace layanan default adalah root/cimv2. Anda dapat menggunakan penyelesaian tab untuk menelusuri daftar namespace, karena PowerShell mendapatkan daftar namespace layanan dari server WMI lokal untuk menyediakan daftar namespace layanan.

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

-OperationTimeoutSec

Menentukan jumlah waktu cmdlet menunggu respons dari komputer. Secara default, nilai parameter ini adalah 0, yang berarti bahwa cmdlet menggunakan nilai batas waktu default untuk server.

Jika parameter OperationTimeoutSec diatur ke nilai yang kurang dari batas waktu coba lagi koneksi yang kuat selama 3 menit, kegagalan jaringan yang berlangsung lebih dari nilai parameter OperationTimeoutSec tidak dapat dipulihkan, karena operasi pada server habis sebelum klien dapat tersambung kembali.

Jenis:UInt32
Alias:OT
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Query

Menentukan kueri yang akan dijalankan di server CIM. Anda dapat menentukan dialek kueri menggunakan parameter QueryDialect .

Jika nilai yang ditentukan berisi tanda kutip ganda ("), tanda kutip tunggal ('), atau garis miring terbalik (\), Anda harus keluar dari karakter tersebut dengan mengawalinya dengan karakter garis miring terbalik (\). Jika nilai yang ditentukan menggunakan operator WQL LIKE , maka Anda harus keluar dari karakter berikut dengan mengapitnya dalam tanda kurung siku ([]): persen (%), garis bawah (_), atau kurung siku pembuka ([).

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

-QueryDialect

Menentukan bahasa kueri yang digunakan untuk parameter Kueri. Nilai yang dapat diterima untuk parameter ini adalah: WQL atau CQL. Nilai defaultnya adalah WQL.

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

-ResourceUri

Menentukan pengidentifikasi sumber daya seragam sumber daya (URI) dari kelas atau instans sumber daya. URI digunakan untuk mengidentifikasi jenis sumber daya tertentu, seperti disk atau proses, di komputer.

URI terdiri dari awalan dan jalur ke sumber daya. Contohnya:

  • http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk
  • http://intel.com/wbem/wscim/1/amt-schema/1/AMT_GeneralSettings

Secara default, jika Anda tidak menentukan parameter ini, URI http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ sumber daya standar DMTF digunakan dan nama kelas ditambahkan ke parameter tersebut.

ResourceURI hanya dapat digunakan dengan sesi CIM yang dibuat menggunakan protokol WSMan, atau saat menentukan parameter ComputerName, yang membuat sesi CIM menggunakan WSMan. Jika Anda menentukan parameter ini tanpa menentukan parameter ComputerName, atau jika Anda menentukan sesi CIM yang dibuat menggunakan protokol DCOM, Anda mendapatkan kesalahan, karena protokol DCOM tidak mendukung parameter ResourceURI .

Jika parameter ResourceUri dan parameter Filter ditentukan, parameter Filter diabaikan.

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

-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

None

Anda tidak dapat menyalurkan objek ke cmdlet ini.

Output

None

Cmdlet ini tidak mengembalikan output.

Catatan

PowerShell menyertakan alias berikut untuk Remove-CimInstance:

  • Windows:
    • rcim

Cmdlet ini hanya tersedia di platform Windows.