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

说明

此 cmdlet 仅在 Windows 平台上可用。

此 cmdlet 从 CIM 服务器中删除 CIM 实例。可以使用 cmdlet 检索 Get-CimInstance 的 CIM 实例对象或指定查询来指定要删除的 CIM 实例。

如果未指定 InputObject 参数，则 cmdlet 通过以下方式之一工作：

如果未指定 ComputerName 参数和 CimSession 参数，则此 cmdlet 适用于本地 Windows Management Instrumentation (WMI) ，使用组件对象模型 (COM) 会话。
如果指定 了 ComputerName 参数或 CimSession 参数，则此 cmdlet 适用于 由 ComputerName 参数或 CimSession 参数指定的 CIM 服务器。

示例

示例 1：删除 CIM 实例

此示例使用 Query 参数从名为 Win32_Environment 的类中删除以字符串 testvar 开头的 CIM 实例。

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

示例 2：使用 CIM 实例对象删除 CIM 实例

此示例检索由 Query 参数筛选的 CIM 实例对象，并使用 cmdlet 将它们存储在名为 $var 的 Get-CimInstance 变量中。然后，变量的内容将 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。

Type:	CimSession[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ComputerName

指定要运行 CIM 操作的计算机的名称。可以 (FQDN) 或 NetBIOS 名称指定完全限定的域名。

如果指定此参数，cmdlet 将使用 WsMan 协议创建与指定计算机的临时会话。

如果未指定此参数，cmdlet 将使用组件对象模型 (COM) 在本地计算机上执行操作。

如果在同一台计算机上执行多个操作，则使用 CIM 会话进行连接可提供更好的性能。

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

-Confirm

提示你在运行 cmdlet 之前进行确认。

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

-InputObject

指定要从 CIM 服务器中删除的 CIM 实例对象。传递给 cmdlet 的对象不会更改，只会删除 CIM 服务器中的实例。

InputObject 参数不枚举集合。如果传递集合，则会引发错误。使用集合时，通过管道传递输入以枚举值。

Type:	CimInstance
Aliases:	CimInstance
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Namespace

指定 CIM 操作的命名空间。默认命名空间为 root/cimv2。可以使用选项卡补全来浏览命名空间列表，因为 PowerShell 从本地 WMI 服务器获取命名空间列表以提供命名空间列表。

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

-OperationTimeoutSec

指定 cmdlet 等待计算机响应的时间量。默认情况下，此参数 0的值为，这意味着 cmdlet 使用服务器的默认超时值。

如果将 OperationTimeoutSec 参数设置为小于 3 分钟可靠连接重试超时的值，则持续超过 OperationTimeoutSec 参数值的网络故障不可恢复，因为服务器上的操作在客户端重新连接之前会超时。

Type:	UInt32
Aliases:	OT
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Query

指定要在 CIM 服务器上运行的查询。可以使用 QueryDialect 参数指定查询方言。

如果指定的值包含) (" 双引号、单引号 () ' 或反斜杠 (\) ，则必须用反斜杠 (\) 字符作为前缀来转义这些字符。如果指定的值使用 WQL LIKE 运算符，则必须通过将以下字符括在方括号 ([]) 中来转义这些字符：百分比 (%) 、下划线 (_) 或左方括号 ([) 。

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

-QueryDialect

指定用于 Query 参数的查询语言。此参数的可接受值为： WQL 或 CQL。默认值为 WQL。

Type:	String
Position:	Named
Default value:	WQL
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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 参数。

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

-WhatIf

显示运行该 cmdlet 时会发生什么情况。此 cmdlet 未运行。

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

输入

None

无法通过管道将对象传递给此 cmdlet。

输出