Remove-WmiObject

参考

模块:: Microsoft.PowerShell.Management

删除现有 Windows Management Instrumentation (WMI) 类的实例。

语法

Remove-WmiObject
      [-Class] <String>
      [-AsJob]
      [-Impersonation <ImpersonationLevel>]
      [-Authentication <AuthenticationLevel>]
      [-Locale <String>]
      [-EnableAllPrivileges]
      [-Authority <String>]
      [-Credential <PSCredential>]
      [-ThrottleLimit <Int32>]
      [-ComputerName <String[]>]
      [-Namespace <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-WmiObject
      -InputObject <ManagementObject>
      [-AsJob]
      [-ThrottleLimit <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-WmiObject
      -Path <String>
      [-AsJob]
      [-Impersonation <ImpersonationLevel>]
      [-Authentication <AuthenticationLevel>]
      [-Locale <String>]
      [-EnableAllPrivileges]
      [-Authority <String>]
      [-Credential <PSCredential>]
      [-ThrottleLimit <Int32>]
      [-ComputerName <String[]>]
      [-Namespace <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-WmiObject
      [-AsJob]
      [-Impersonation <ImpersonationLevel>]
      [-Authentication <AuthenticationLevel>]
      [-Locale <String>]
      [-EnableAllPrivileges]
      [-Authority <String>]
      [-Credential <PSCredential>]
      [-ThrottleLimit <Int32>]
      [-ComputerName <String[]>]
      [-Namespace <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-WmiObject
      [-AsJob]
      [-Impersonation <ImpersonationLevel>]
      [-Authentication <AuthenticationLevel>]
      [-Locale <String>]
      [-EnableAllPrivileges]
      [-Authority <String>]
      [-Credential <PSCredential>]
      [-ThrottleLimit <Int32>]
      [-ComputerName <String[]>]
      [-Namespace <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-WmiObject
      [-AsJob]
      [-Impersonation <ImpersonationLevel>]
      [-Authentication <AuthenticationLevel>]
      [-Locale <String>]
      [-EnableAllPrivileges]
      [-Authority <String>]
      [-Credential <PSCredential>]
      [-ThrottleLimit <Int32>]
      [-ComputerName <String[]>]
      [-Namespace <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

说明

Remove-WmiObject cmdlet 删除现有 Windows Management Instrumentation (WMI) 类的实例。

示例

示例 1：关闭 Win32 进程的所有实例

PS C:\> notepad
PS C:\> $np = Get-WmiObject -Query "select * from win32_process where name='notepad.exe'"
PS C:\> $np | Remove-WmiObject

此示例关闭 Notepad.exe 的所有实例。

第一条命令启动记事本的实例。

第二个命令使用 Get-WmiObject cmdlet 检索与 Notepad.exe 对应的Win32_Process实例，然后将其存储在 $np 变量中。

第三个命令将 $np 变量中的对象传递给 Remove-WmiObject，这将删除 Notepad.exe 的所有实例。

示例 2：删除文件夹

PS C:\> $a = Get-WMIObject -Query "Select * From Win32_Directory Where Name ='C:\\Test'"
PS C:\> $a | Remove-WMIObject

此命令将删除 C：\Test 文件夹。

第一个命令使用 Get-WMIObject 查询 C：\Test 文件夹，然后将对象存储在 $a 变量中。

第二个命令将$a变量传递给 Remove-WMIObject，这将删除文件夹。

参数

-AsJob

指示此 cmdlet 作为后台作业运行。使用此参数可运行需要较长时间才能完成的命令。

Windows PowerShell 3.0 中引入的新 CIM cmdlet 执行与 WMI cmdlet 相同的任务。 CIM cmdlet 符合 WS-Management (WSMan) 标准和通用信息模型 (CIM) 标准，使 cmdlet 能够使用相同的技术来管理运行 Windows 操作系统的计算机和运行其他操作系统的计算机。建议不要使用 Remove-WmiObject，而考虑使用 Remove-CimInstancehttps://go.microsoft.com/fwlink/?LinkId=227964 cmdlet。

使用 AsJob 参数时，该命令将返回表示后台作业的对象，然后显示命令提示符。当作业完成时，你可以继续在此会话中工作。如果将 Remove-WmiObject 用于远程计算机，则会在本地计算机上创建相应作业，并且来自远程计算机的结果将自动返回至本地计算机。若要管理作业，请使用包含作业名词的 cmdlet (作业 cmdlet) 。若要获取作业结果，请使用 Receive-Job cmdlet。

若要对远程计算机使用此参数，必须配置本地计算机和远程计算机进行远程处理。使用“以管理员身份运行”选项启动Windows PowerShell。有关详细信息，请参阅 about_Remote_Requirements。

有关 Windows PowerShell 后台作业的详细信息，请参阅 about_Jobs 和 about_Remote_Jobs。

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

-Authentication

指定用于 WMI 连接的身份验证级别。此参数的可接受值为：

-1：未更改。
0：Default。
1：无。未执行身份验证。
2：连接。仅当客户端与应用程序建立关系时，才会执行身份验证。
3：调用。仅当应用程序收到请求时，才会在每次调用开始时执行身份验证。
4：数据包。对从客户端接收的所有数据执行身份验证。
5：PacketIntegrity。在客户端和应用程序之间传输的所有数据都经过身份验证和验证。
6：PacketPrivacy。使用其他身份验证级别的属性，并加密所有数据。

Type:	AuthenticationLevel
Accepted values:	Default, None, Connect, Call, Packet, PacketIntegrity, PacketPrivacy, Unchanged
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Authority

指定用于对 WMI 连接进行身份验证的授权机构。可以指定标准 NTLM 或 Kerberos 身份验证。若要使用 NTLM，请将授权机构设置设为 ntlmdomain:<DomainName>，其中 <DomainName> 标识有效的 NTLM 域名。若要使用 Kerberos，请指定 kerberos：<DomainName>\<ServerName>。连接到本地计算机时不能包含授权机构设置。

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

-Class

指定此 cmdlet 删除的 WMI 类的名称。

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

-ComputerName

指定运行此 cmdlet 的计算机的名称。默认为本地计算机。

键入一台或多台计算机的 NetBIOS 名称、IP 地址或完全限定的域名。若要指定本地计算机，请键入该计算机名称、句点 (.) 或 localhost。

此参数不依赖于 Windows PowerShell 远程处理。即使你的计算机未配置为运行远程命令，你也可以使用 ComputerName 参数。

Type:	String[]
Aliases:	Cn
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

-Credential

指定有权执行此操作的用户帐户。默认为当前用户。

键入用户名（如 User01 或 Domain01\User01），或输入 PSCredential 对象，例如 Get-Credential cmdlet 生成的对象。键入用户名时，此 cmdlet 会提示输入密码。

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

-EnableAllPrivileges

指示此 cmdlet 在命令进行 WMI 调用之前启用当前用户的所有权限。

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

-Impersonation

指定要使用的模拟级别。此参数的可接受值为：

0：Default。读取默认模拟级别的本地注册表，该级别通常设置为 3：模拟。
1：Anonymous。隐藏调用方的凭据。
2：Identify。允许对象查询调用方的凭据。
3：Impersonate。允许对象使用调用方的凭据。
4：Delegate。允许对象允许其他对象使用调用方的凭据。

Type:	ImpersonationLevel
Accepted values:	Default, Anonymous, Identify, Impersonate, Delegate
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

指定要用作输入的 ManagementObject 对象。使用此参数时，将忽略所有其他参数。

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

-Locale

指定 WMI 对象的首选区域设置。区域设置参数以首选顺序指定为 MS_<LCID> 格式的数组。

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

-Namespace

指定引用的 WMI 类与 Class 参数一起使用时，引用的 WMI 类所在的 WMI 存储库命名空间。

Type:	String
Aliases:	NS
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Path

指定 WMI 类的 WMI 对象路径，或指定要删除的 WMI 类实例的 WMI 对象路径。

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

-ThrottleLimit

指定为运行此命令可建立的并发连接的最大数目。此参数与 AsJob 参数一起使用。节流限制仅适用于当前命令，而不适用于会话或计算机。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
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

输入

ManagementObject

可以通过管道将管理对象传递给此 cmdlet。

输出

None, System.Management.Automation.RemotingJob

如果指定 AsJob 参数，则此 cmdlet 将返回作业对象。否则，将不生成任何输出。

通过