Remove-CimInstance
CiM örneğini bilgisayardan kaldırır.
Syntax
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>]
Description
Bu cmdlet yalnızca Windows platformunda kullanılabilir.
Bu cmdlet bir CIM örneğini CIM sunucusundan kaldırır. Kaldırılacak CIM örneğini, cmdlet tarafından Get-CimInstance
alınan cim örneği nesnesini kullanarak veya bir sorgu belirterek belirtebilirsiniz.
InputObject parametresi belirtilmezse, cmdlet aşağıdaki yollardan biriyle çalışır:
- ComputerName parametresi veya CimSession parametresi belirtilmezse, bu cmdlet bir Bileşen Nesne Modeli (COM) oturumu kullanarak yerel Windows Yönetim Araçları'nda (WMI) çalışır.
- ComputerName parametresi veya CimSession parametresi belirtilirse, bu cmdlet ComputerName parametresi veya CimSession parametresi tarafından belirtilen CIM sunucusunda çalışır.
Örnekler
Örnek 1: CIM örneğini kaldırma
Bu örnekte, testvar karakter dizesiyle başlayan Win32_Environment adlı sınıftan CIM örneklerini kaldırmak için Query parametresi kullanılır.
Remove-CimInstance -Query 'Select * from Win32_Environment where name LIKE "testvar%"'
Örnek 2: CIM örneği nesnesini kullanarak CIM örneğini kaldırma
Bu örnek, Query parametresi tarafından filtrelenen CIM örnek nesnelerini alır ve cmdlet'ini kullanarak adlı $var
değişkende Get-CimInstance
depolar. Değişkenin içeriği daha sonra CIM örneklerini kaldıran cmdlet'ine Remove-CimInstance
geçirilir.
notepad.exe
$var = Get-CimInstance -Query 'Select * from Win32_Process where name LIKE "notepad%"'
Remove-CimInstance -InputObject $var
Parametreler
-CimSession
Belirtilen CIM oturumunu kullanarak komutunu çalıştırır. CIM oturumunu içeren bir değişken veya VEYA cmdlet'leri gibi CIM oturumunu New-CimSession
oluşturan veya Get-CimSession
alan bir komut girin. Daha fazla bilgi için bkz . about_CimSession.
Type: | CimSession[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ComputerName
CIM işlemini çalıştırmak istediğiniz bilgisayarın adını belirtir. Tam etki alanı adı (FQDN) veya NetBIOS adı belirtebilirsiniz.
Bu parametreyi belirtirseniz, cmdlet WsMan protokolunu kullanarak belirtilen bilgisayarda geçici bir oturum oluşturur.
Bu parametreyi belirtmezseniz, cmdlet işlemi Bileşen Nesne Modeli (COM) kullanarak yerel bilgisayarda gerçekleştirir.
Aynı bilgisayarda birden çok işlem gerçekleştiriliyorsa, CIM oturumu kullanarak bağlanmak daha iyi performans sağlar.
Type: | String[] |
Aliases: | CN, ServerName |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Cmdlet'i çalıştırmadan önce sizden onay ister.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
CIM sunucusundan kaldırılacak CIM örneği nesnesini belirtir. Cmdlet'e geçirilen nesne değiştirilmez, yalnızca CIM sunucusundaki örnek kaldırılır.
InputObject parametresi koleksiyonlar üzerinde numaralandırılmıyor. Bir koleksiyon geçirilirse bir hata oluşur. Koleksiyonlarla çalışırken, değerleri numaralandırmak için girişi kanala yazın.
Type: | CimInstance |
Aliases: | CimInstance |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Namespace
CIM işlemi için ad alanını belirtir. Varsayılan ad alanı root/cimv2
. PowerShell, ad alanlarının listesini sağlamak üzere yerel WMI sunucusundan bir ad alanı listesi aldığından, ad alanları listesine göz atmak için sekme tamamlama özelliğini kullanabilirsiniz.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-OperationTimeoutSec
Cmdlet'in bilgisayardan yanıt bekleme süresini belirtir. Varsayılan olarak, bu parametrenin değeri olur 0
. Bu, cmdlet'in sunucu için varsayılan zaman aşımı değerini kullandığı anlamına gelir.
OperationTimeoutSec parametresi 3 dakikalık sağlam bağlantı yeniden deneme zaman aşımından daha küçük bir değere ayarlanırsa, istemci yeniden bağlanamadan önce sunucudaki işlem zaman aşımına uğraması nedeniyle OperationTimeoutSec parametresinin değerinden daha uzun süren ağ hataları kurtarılamaz.
Type: | UInt32 |
Aliases: | OT |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Query
CIM sunucusunda çalıştırılacak sorguyu belirtir. QueryDialect parametresini kullanarak sorgu diyalektini belirtebilirsiniz.
Belirtilen değer çift tırnak ("
), tek tırnak işareti ()'
veya ters eğik çizgi ()\
içeriyorsa, bu karakterlerin önüne ters eğik çizgi (\
) karakteri ekleyerek bu karakterlerden kaçmalısınız. Belirtilen değer WQL LIKE
işlecini kullanıyorsa, bunları köşeli ayraç içine alarak (): yüzde (%
), alt çizgi ([]
_
) veya köşeli ayraç ([
) açarak aşağıdaki karakterlerden kaçmalısınız.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-QueryDialect
Sorgu parametresi için kullanılan sorgu dilini belirtir. Bu parametre için kabul edilebilir değerler şunlardır: WQL
veya CQL
. Varsayılan değer şudur: WQL
.
Type: | String |
Position: | Named |
Default value: | WQL |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResourceUri
Kaynak sınıfının veya örneğin kaynak tekdüzen kaynak tanımlayıcısını (URI) belirtir. URI, bir bilgisayardaki diskler veya işlemler gibi belirli bir kaynak türünü tanımlamak için kullanılır.
URI bir ön ek ve kaynağın yolundan oluşur. Örneğin:
http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk
http://intel.com/wbem/wscim/1/amt-schema/1/AMT_GeneralSettings
Varsayılan olarak, bu parametreyi belirtmezseniz, DMTF standart kaynak URI'sini http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/
kullanılır ve sınıf adı eklenir.
ResourceURI yalnızca WSMan protokolü kullanılarak oluşturulan CIM oturumlarıyla veya WSMan kullanarak cim oturumu oluşturan ComputerName parametresini belirtirken kullanılabilir. ComputerName parametresini belirtmeden bu parametreyi belirtirseniz veya DCOM protokolü kullanılarak oluşturulan bir CIM oturumu belirtirseniz, DCOM protokolü ResourceURI parametresini desteklemediğinden bir hata alırsınız.
Hem ResourceUri parametresi hem de Filter parametresi belirtilirse, Filter parametresi yoksayılır.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Girişler
None
Nesneleri bu cmdlet'e yöneltemezsiniz.
Çıkışlar
None
Bu cmdlet çıkış döndürmez.
Notlar
PowerShell için aşağıdaki diğer adları Remove-CimInstance
içerir:
- Windows:
rcim
Bu cmdlet yalnızca Windows platformlarında kullanılabilir.
İlişkili Bağlantılar
PowerShell
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin