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 检索的 CIM 实例对象或通过指定查询来指定要删除的 Get-CimInstance CIM 实例。

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

  • 如果 ComputerName 参数和 CimSession 参数均未指定，则此 cmdlet 适用于使用组件对象模型 (COM) 会话的本地 Windows Management Instrumentation (WMI) 。
  • 如果指定 了 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，该 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。 可以使用 Tab 自动补全来浏览命名空间列表，因为 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。

输出

None

此 cmdlet 不返回任何输出。

备注

PowerShell 包含以下别名 Remove-CimInstance：

  • Windows：
    • rcim

此 cmdlet 仅在 Windows 平台上可用。