Remove-WmiObject

  • Referensi
Modul:
Microsoft.PowerShell.Management

Menghapus instans kelas Windows Management Instrumentation (WMI) yang ada.

Sintaks

Remove-WmiObject
      [-Class] <String>
      [-AsJob]
      [-Impersonation <ImpersonationLevel>]
      [-Authentication <AuthenticationLevel>]
      [-Locale <String>]
      [-EnableAllPrivileges]
      [-Authority <String>]
      [-Credential <PSCredential>]
      [-ThrottleLimit <Int32>]
      [-ComputerName <String[]>]
      [-Namespace <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-WmiObject
      -InputObject <ManagementObject>
      [-AsJob]
      [-ThrottleLimit <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-WmiObject
      -Path <String>
      [-AsJob]
      [-Impersonation <ImpersonationLevel>]
      [-Authentication <AuthenticationLevel>]
      [-Locale <String>]
      [-EnableAllPrivileges]
      [-Authority <String>]
      [-Credential <PSCredential>]
      [-ThrottleLimit <Int32>]
      [-ComputerName <String[]>]
      [-Namespace <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-WmiObject
      [-AsJob]
      [-Impersonation <ImpersonationLevel>]
      [-Authentication <AuthenticationLevel>]
      [-Locale <String>]
      [-EnableAllPrivileges]
      [-Authority <String>]
      [-Credential <PSCredential>]
      [-ThrottleLimit <Int32>]
      [-ComputerName <String[]>]
      [-Namespace <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-WmiObject
      [-AsJob]
      [-Impersonation <ImpersonationLevel>]
      [-Authentication <AuthenticationLevel>]
      [-Locale <String>]
      [-EnableAllPrivileges]
      [-Authority <String>]
      [-Credential <PSCredential>]
      [-ThrottleLimit <Int32>]
      [-ComputerName <String[]>]
      [-Namespace <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-WmiObject
      [-AsJob]
      [-Impersonation <ImpersonationLevel>]
      [-Authentication <AuthenticationLevel>]
      [-Locale <String>]
      [-EnableAllPrivileges]
      [-Authority <String>]
      [-Credential <PSCredential>]
      [-ThrottleLimit <Int32>]
      [-ComputerName <String[]>]
      [-Namespace <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Deskripsi

Remove-WmiObject Cmdlet menghapus instans kelas Windows Management Instrumentation (WMI) yang ada.

Contoh

Contoh 1: Tutup semua instans proses Win32

notepad
$np = Get-WmiObject -Query "select * from win32_process where name='notepad.exe'"
$np | Remove-WmiObject

Contoh ini menutup semua instans Notepad.exe.

Perintah pertama memulai instans Notepad.

Perintah kedua menggunakan cmdlet Get-WmiObject untuk mengambil instans Win32_Process yang sesuai dengan Notepad.exe, lalu menyimpannya dalam $np variabel.

Perintah ketiga meneruskan objek dalam variabel $np ke Remove-WmiObject, yang menghapus semua instans Notepad.exe.

Contoh 2: Menghapus folder

Perintah ini menghapus folder C:\Test.

$a = Get-WMIObject -Query "Select * From Win32_Directory Where Name ='C:\\Test'"
$a | Remove-WMIObject

Perintah pertama menggunakan untuk mengkueri Get-WMIObjectC:\Test folder, lalu menyimpan objek dalam $a variabel.

Perintah kedua menyalurkan $a variabel ke Remove-WMIObject, yang menghapus folder.

Parameter

-AsJob

Menunjukkan bahwa cmdlet ini berjalan sebagai pekerjaan latar belakang. Gunakan parameter ini untuk menjalankan perintah yang membutuhkan waktu lama untuk diselesaikan.

Cmdlet CIM baru, memperkenalkan Windows PowerShell 3.0, melakukan tugas yang sama dengan cmdlet WMI. Cmdlet CIM mematuhi standar WS-Management (WSMan) dan dengan standar Common Information Model (CIM), yang memungkinkan cmdlet menggunakan teknik yang sama untuk mengelola komputer yang menjalankan sistem operasi Windows dan yang menjalankan sistem operasi lainnya. Alih-alih menggunakan Remove-WmiObject, pertimbangkan untuk menggunakan cmdlet Remove-CimInstance.

Saat Anda menggunakan parameter AsJob , perintah mengembalikan objek yang mewakili pekerjaan latar belakang lalu menampilkan prompt perintah. Anda dapat terus bekerja dalam sesi saat pekerjaan selesai. Jika Remove-WmiObject digunakan terhadap komputer jarak jauh, pekerjaan dibuat pada komputer lokal, dan hasil dari komputer jarak jauh secara otomatis dikembalikan ke komputer lokal. Untuk mengelola pekerjaan, gunakan cmdlet yang berisi kata benda Pekerjaan ( cmdlet Pekerjaan ). Untuk mendapatkan hasil pekerjaan, gunakan Receive-Job cmdlet .

Untuk menggunakan parameter ini untuk komputer jarak jauh, komputer lokal dan jarak jauh harus dikonfigurasi untuk jarak jauh. Mulai Windows PowerShell dengan menggunakan opsi Jalankan sebagai administrator. Untuk informasi selengkapnya, lihat about_Remote_Requirements.

Untuk informasi selengkapnya tentang pekerjaan latar belakang Windows PowerShell, lihat about_Jobs dan about_Remote_Jobs.

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

-Authentication

Menentukan tingkat autentikasi yang akan digunakan untuk koneksi WMI. Nilai yang dapat diterima untuk parameter ini adalah:

  • -1:Berubah.
  • 0:Default.
  • 1:Tidak. Tidak ada autentikasi dalam yang dilakukan.
  • 2: Koneksi. Autentikasi dilakukan hanya ketika klien membuat hubungan dengan aplikasi.
  • 3:Panggilan. Autentikasi hanya dilakukan pada awal setiap panggilan saat aplikasi menerima permintaan.
  • 4:Paket. Autentikasi dilakukan pada semua data yang diterima dari klien.
  • 5: PacketIntegrity. Semua data yang ditransfer antara klien dan aplikasi diautentikasi dan diverifikasi.
  • 6: PacketPrivacy. Properti tingkat autentikasi lainnya digunakan, dan semua data dienkripsi.
Type:AuthenticationLevel
Accepted values:Default, None, Connect, Call, Packet, PacketIntegrity, PacketPrivacy, Unchanged
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Authority

Menentukan otoritas yang akan digunakan untuk mengautentikasi koneksi WMI. Anda dapat menentukan autentikasi NTLM atau Kerberos standar. Untuk menggunakan NTLM, atur pengaturan otoritas ke ntlmdomain:<DomainName>, di mana <DomainName> mengidentifikasi nama domain NTLM yang valid. Untuk menggunakan Kerberos, tentukan kerberos:<DomainName>\<ServerName>. Anda tidak dapat menyertakan pengaturan otoritas ketika Anda tersambung ke komputer lokal.

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

-Class

Menentukan nama kelas WMI yang dihapus cmdlet ini.

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

-ComputerName

Menentukan nama komputer tempat cmdlet ini berjalan. Defaultnya adalah komputer lokal.

Ketik nama NetBIOS, alamat IP, atau nama domain yang sepenuhnya memenuhi syarat dari satu atau beberapa komputer. Untuk menentukan komputer lokal, ketik nama komputer, titik (.), atau localhost.

Parameter ini tidak bergantung pada jarak jauh Windows PowerShell. Anda dapat menggunakan parameter ComputerName meskipun komputer Anda tidak dikonfigurasi untuk menjalankan perintah jarak jauh.

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

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

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

-Credential

Menentukan akun pengguna yang memiliki izin untuk melakukan tindakan ini. Defaultnya adalah pengguna saat ini.

Ketik nama pengguna, seperti User01 atau Domain01\User01, atau masukkan objek PSCredential , seperti yang dihasilkan oleh Get-Credential cmdlet. Jika Anda mengetik nama pengguna, cmdlet ini akan meminta kata sandi kepada Anda.

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

-EnableAllPrivileges

Menunjukkan bahwa cmdlet ini memungkinkan semua izin pengguna saat ini sebelum perintah melakukan panggilan WMI.

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

-Impersonation

Menentukan tingkat peniruan yang akan digunakan. Nilai yang dapat diterima untuk parameter ini adalah:

  • 0:Default. Membaca registri lokal untuk tingkat peniruan default, yang biasanya diatur ke 3: Meniru.
  • 1:Anonim. Menyembunyikan kredensial pemanggil.
  • 2:Mengidentifikasi. Memungkinkan objek untuk mengkueri kredensial pemanggil.
  • 3:Meniru. Memungkinkan objek menggunakan kredensial pemanggil.
  • 4:Mendelegasikan. Memungkinkan objek untuk mengizinkan objek lain menggunakan kredensial pemanggil.
Type:ImpersonationLevel
Accepted values:Default, Anonymous, Identify, Impersonate, Delegate
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Menentukan objek ManagementObject untuk digunakan sebagai input. Ketika parameter ini digunakan, semua parameter lain diabaikan.

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

-Locale

Menentukan lokal pilihan untuk objek WMI. Parameter Lokal ditentukan sebagai array dalam format MS_<LCID> dalam urutan yang disukai.

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

-Namespace

Menentukan namespace repositori WMI tempat kelas WMI yang direferensikan berada saat digunakan dengan parameter Kelas .

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

-Path

Menentukan jalur objek WMI dari kelas WMI, atau menentukan jalur objek WMI dari instans kelas WMI yang akan dihapus.

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

-ThrottleLimit

Menentukan jumlah maksimum koneksi bersamaan yang dapat dibuat untuk menjalankan perintah ini. Parameter ini digunakan bersama dengan parameter AsJob . Batas pembatasan hanya berlaku untuk perintah saat ini, bukan ke sesi atau ke komputer.

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

-WhatIf

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

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

Input

ManagementObject

Anda dapat menyalurkan objek manajemen ke cmdlet ini.

Output

None, System.Management.Automation.RemotingJob

Cmdlet ini mengembalikan objek pekerjaan, jika Anda menentukan parameter AsJob . Jika tidak, itu tidak menghasilkan output apa pun.

Catatan

Windows PowerShell menyertakan alias berikut untuk Remove-WmiObject:

  • rwmi