CimInstance'ı Kaldır (CimCmdlet'ler)

Remove-CimInstance

Modül:
CimCmdlets

Bir CIM örneğini bilgisayardan kaldırır.

Sözdizimi

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

Tanım

Bu cmdlet yalnızca Windows platformunda mevcuttur.

Bu cmdlet, bir CIM örneğini bir CIM sunucusundan kaldırır. Kaldırılacak CIM örneğini, Get-CimInstance cmdlet'i tarafından alınan bir CIM örneği nesnesini kullanarak veya bir sorgu belirterek belirleyebilirsiniz.

InputObject parametresi belirtilmezse cmdlet aşağıdaki yollardan biriyle çalışır:

  • Ne BilgisayarAdı parametresi ne de CimSession parametresi belirtilmezse bu cmdlet, Bileşen Nesne Modeli (COM) oturumunu kullanarak yerel Windows Yönetim Araçları (WMI) üzerinde çalışır.
  • BilgisayarAdı parametresi veya CimSession parametresinden biri belirtilirse bu cmdlet, BilgisayarAdı parametresi veya < ile belirtilen CIM sunucusunda çalışır.CimSession parametresi.

Örnekler

Örnek 1: CIM örneğini kaldırın

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ırın

Bu örnek, Query parametresi tarafından filtrelenen CIM örneği nesnelerini alır ve bunları Get-CimInstance cmdlet'ini kullanarak $var adlı değişkende saklar. Değişkenin içeriği daha sonra CIM örneklerini kaldıran Remove-CimInstance cmdlet'ine iletilir.

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

Parametreler

-CimSession

Belirtilen CIM oturumunu kullanarak komutu çalıştırır. CIM oturumunu içeren bir değişken veya New-CimSession veya Get-CimSession cmdlet'leri gibi CIM oturumunu oluşturan veya alan bir komut girin. Daha fazla bilgi için bkz. about_CimSession.

Tip :

CimOturumu[]

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

True

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-ComputerName

CIM işlemini çalıştırmak istediğiniz bilgisayarın adını belirtir. Tam nitelikli bir etki alanı adı (FQDN) veya NetBIOS adı belirtebilirsiniz.

Bu parametreyi belirtirseniz cmdlet, WsMan protokolünü kullanarak belirtilen bilgisayarda geçici bir oturum oluşturur.

Bu parametreyi belirtmezseniz cmdlet, işlemi yerel bilgisayarda Bileşen Nesne Modeli'ni (COM) kullanarak gerçekleştirir.

Aynı bilgisayarda birden fazla işlem gerçekleştiriliyorsa CIM oturumu kullanarak bağlanmak daha iyi performans sağlar.

Tip :

String[]

Takma adlar:

CN, ServerName

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Tip :

SwitchParameter

Takma adlar:

cf

Konum:

Adlandırılmış

Varsayılan değer:

False

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-InputObject

CIM sunucusundan kaldırılacak bir CIM örneği nesnesini belirtir. Cmdlet'e iletilen nesne değiştirilmez, yalnızca CIM sunucusundaki örnek kaldırılır.

InputObject parametresi koleksiyonlar üzerinde numaralandırma yapmaz. Bir koleksiyon iletilirse bir hata atılır. Koleksiyonlarla çalışırken, değerleri numaralandırmak için girişi yönlendirin.

Tip :

CimInstance

Takma adlar:

CimInstance

Konum:

1

Varsayılan değer:

None

Gerekli:

True

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-Namespace

CIM işleminin ad alanını belirtir. Varsayılan ad alanı root/cimv2'dir. PowerShell, ad alanlarının listesini sağlamak için yerel WMI sunucusundan ad alanlarının bir listesini aldığından, ad alanları listesine göz atmak için sekme tamamlamayı kullanabilirsiniz.

Tip :

String

Konum:

2

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-OperationTimeoutSec

Cmdlet'in bilgisayardan yanıt almak için bekleyeceği süreyi belirtir. Varsayılan olarak bu parametrenin değeri 0'dır; 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ı süresinden daha düşük bir değere ayarlanırsa, OperationTimeoutSec parametresinin değerinden daha uzun süren ağ hataları kurtarılamaz. çünkü istemci yeniden bağlanamadan sunucudaki işlem zaman aşımına uğrar.

Tip :

UInt32

Takma adlar:

OT

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-Query

CIM sunucusunda çalıştırılacak bir sorguyu belirtir. QueryDialect parametresini kullanarak sorgu lehçesini belirtebilirsiniz.

Belirtilen değer çift tırnak ("), tek tırnak (') veya ters eğik çizgi (\) içeriyorsa, bu karakterlerden kaçmanız gerekir Belirtilen değer WQL LIKE operatörünü kullanıyorsa, aşağıdaki karakterleri köşeli parantez (<) içine alarak kaçmanız gerekir.[]): yüzde (%), alt çizgi (_) veya açılan köşeli parantez ([).

Tip :

String

Konum:

1

Varsayılan değer:

None

Gerekli:

True

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

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 WQL'dir.

Tip :

String

Konum:

Adlandırılmış

Varsayılan değer:

WQL

Gerekli:

False

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-ResourceUri

Kaynak sınıfının veya örneğinin kaynak tek tip kaynak tanımlayıcısını (URI) belirtir. URI, bilgisayardaki diskler veya işlemler gibi belirli bir kaynak türünü tanımlamak için kullanılır.

Bir URI, bir önek ve bir kaynağa giden yoldan 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'si http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ kullanılır ve sınıf adı ona eklenir.

ResourceURI yalnızca WSMan protokolü kullanılarak oluşturulan CIM oturumlarıyla veya WSMan kullanarak bir CIM oturumu oluşturan ComputerName parametresi belirtilirken kullanılabilir. Bu parametreyi ComputerName parametresini belirtmeden belirtirseniz veya DCOM protokolü kullanılarak oluşturulmuş bir CIM oturumu belirtirseniz DCOM protokolü ResourceURI parametresini desteklemediğinden hata alırsınız.

Hem ResourceUri parametresi hem de Filter parametresi belirtilirse Filter parametresi yoksayılır.

Tip :

Uri

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-WhatIf

Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmıyor.

Tip :

SwitchParameter

Takma adlar:

wi

Konum:

Adlandırılmış

Varsayılan değer:

False

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

Girişler

Yok

Nesneleri bu cmdlet'e aktaramazsınız.

Çıkışlar

Yok

Bu cmdlet hiçbir çıktı döndürmez.

Notlar

PowerShell, Remove-CimInstance için aşağıdaki takma adları içerir:

  • Windows:

      rcim

Bu cmdlet yalnızca Windows platformlarında kullanılabilir.

İlgili makaleler