Remove-CimInstance

模組:

CimCmdlets

從計算機移除 CIM 實例。

語法

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

此 Cmdlet 只能在 Windows 平臺上使用。

此 Cmdlet 會從 CIM 伺服器移除 CIM 實例。 您可以使用 Get-CimInstance Cmdlet 擷取的 CIM 實例物件，或指定查詢，指定要移除的 CIM 實例。

如果未指定 InputObject 參數，Cmdlet 的運作方式如下：

• 如果未指定 ComputerName 參數或 CimSession 參數，則此 Cmdlet 會使用元件物件模型 （COM） 會話在本機 Windows Management Instrumentation （WMI） 上運作。
• 如果指定 ComputerName 參數或 CimSession 參數，則此 Cmdlet 會針對 ComputerName 參數或 CimSession 參數所指定的 CIM 伺服器運作。

範例

範例 1：移除 CIM 實例

這個範例會使用 Query 參數，從以 testvar 字元 字串開頭的類別中移除名為 Win32_Environment 的 CIM 實例。

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

範例 2：使用 CIM 實例物件移除 CIM 實例

此範例會擷取由 Query 參數篩選的 CIM 實例物件，並使用 Get-CimInstance Cmdlet 將它們儲存在名為 $var 的變數中。 變數的內容接著會傳遞至 Remove-CimInstance Cmdlet，以移除 CIM 實例。

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

參數

-CimSession

使用指定的 CIM 作業階段執行命令。 輸入包含 CIM 會話的變數，或建立或取得 CIM 工作階段的命令，例如 New-CimSession 或 Get-CimSession Cmdlet。 如需詳細資訊，請參閱 about_CimSession。

類型:	CimSession[]
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-ComputerName

指定您要執行 CIM 作業的電腦名稱。 您可以指定完整功能變數名稱 （FQDN） 或 NetBIOS 名稱。

如果您指定此參數，Cmdlet 會使用 WsMan 通訊協定，為指定的電腦建立暫存會話。

如果您未指定此參數，Cmdlet 會使用元件物件模型 （COM） 在本機計算機上執行作業。

如果在相同電腦上執行多個作業，則使用 CIM 作業進行連線可提供更佳的效能。

類型:	String[]
別名:	CN, ServerName
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-InputObject

指定要從 CIM 伺服器移除的 CIM 實例物件。 傳遞至 Cmdlet 的物件不會變更，只會移除 CIM 伺服器中的 實例。

InputObject 參數不會列舉集合。 如果傳遞集合，則會擲回錯誤。 使用集合時，使用管線傳送輸入來列舉值。

類型:	CimInstance
別名:	CimInstance
Position:	1
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-Namespace

指定 CIM 作業的命名空間。 預設命名空間為 root/cimv2。 您可以使用索引標籤自動完成來瀏覽命名空間清單，因為 PowerShell 會從本機 WMI 伺服器取得命名空間清單，以提供命名空間清單。

類型:	String
Position:	2
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-OperationTimeoutSec

指定 Cmdlet 等候電腦回應的時間量。 根據預設，此參數的值是 0，這表示 Cmdlet 會使用伺服器的預設逾時值。

如果 OperationTimeoutSec 參數設定為小於 3 分鐘強固連線重試逾時的值，則網路失敗超過 OperationTimeoutSec 參數的值無法復原，因為伺服器上的作業會在用戶端重新連線之前逾時。

類型:	UInt32
別名:	OT
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Query

指定要在 CIM 伺服器上執行的查詢。 您可以使用 QueryDialect 參數來指定查詢方言。

如果指定的值包含雙引號（"）、單引號（'），或反斜杠（\），您必須以反斜杠（\）字元前置詞來逸出這些字元。 如果指定的值使用 WQL LIKE 運算符，則必須以方括號（[]）：百分比（%）、底線（_）或左方括號（[）括住下列字元，以逸出下列字元。

類型:	String
Position:	1
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-QueryDialect

指定用於 Query 參數的查詢語言。 此參數可接受的值為：WQL 或 CQL。 預設值為 WQL。

類型:	String
Position:	Named
預設值:	WQL
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-ResourceUri

指定資源類別或實例的資源統一資源標識碼（URI）。 URI 可用來識別電腦上的特定資源類型，例如磁碟或進程。

URI 包含前置詞和資源的路徑。 例如：

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

根據預設，如果您未指定此參數，則會使用 DMTF 標準資源 URI http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/，並將類別名稱附加至該參數。

ResourceURI 只能與使用 WSMan 通訊協定建立的 CIM 會話搭配使用，或在指定 ComputerName 參數時使用 WSMan 建立 CIM 會話。 如果您在未指定 ComputerName 參數的情況下指定此參數，或指定使用 DCOM 通訊協定建立的 CIM 會話，您會收到錯誤，因為 DCOM 通訊協定不支援 ResourceURI 參數。

如果同時指定 ResourceUri 參數和 Filter 參數，則會忽略 Filter 參數。

類型:	Uri
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

None

您無法使用管線將物件傳送至此 Cmdlet。

輸出

None

此 Cmdlet 不會傳回任何輸出。

備註

PowerShell 包含下列 Remove-CimInstance別名：

• 窗戶：
  • rcim

此 Cmdlet 僅適用於 Windows 平臺。

相關連結

• New-CimInstance
• Get-CimInstance
• Set-CimInstance