Compartir a través de

Remove-WmiObject

  • Referencia
Módulo:
Microsoft.PowerShell.Management

Elimina una instancia de una clase existente de Instrumental de administración de Windows (WMI).

Sintaxis

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

Description

El Remove-WmiObject cmdlet elimina una instancia de una clase de Instrumental de administración de Windows (WMI) existente.

Ejemplos

Ejemplo 1: Cerrar todas las instancias de un proceso de Win32

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

En este ejemplo se cierran todas las instancias de Notepad.exe.

El primer comando inicia una instancia del Bloc de notas.

El segundo comando usa el cmdlet Get-WmiObject para recuperar las instancias del Win32_Process que corresponden a Notepad.exe y, a continuación, los almacena en la $np variable .

El tercer comando pasa el objeto de la variable $np a Remove-WmiObject, que elimina todas las instancias de Notepad.exe.

Ejemplo 2: Eliminar una carpeta

Este comando elimina la carpeta C:\Test.

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

El primer comando usa Get-WMIObject para consultar la C:\Test carpeta y, a continuación, almacena el objeto en la $a variable .

El segundo comando canaliza la $a variable a Remove-WMIObject, que elimina la carpeta .

Parámetros

-AsJob

Indica que este cmdlet se ejecuta como un trabajo en segundo plano. Use este parámetro para ejecutar comandos que tardan mucho tiempo en finalizar.

Los nuevos cmdlets de CIM, que se introdujeron con Windows PowerShell 3.0, realizan las mismas tareas que los cmdlets de WMI. Los cmdlets CIM cumplen con los estándares WS-Management (WSMan) y con el estándar Common Information Model (CIM), que permite a los cmdlets usar las mismas técnicas para administrar equipos que ejecutan el sistema operativo Windows y los que ejecutan otros sistemas operativos. En lugar de usar , considere la posibilidad de usar Remove-WmiObjectel cmdlet Remove-CimInstance.

Cuando se usa el parámetro AsJob , el comando devuelve un objeto que representa el trabajo en segundo plano y, a continuación, muestra el símbolo del sistema. Puede seguir trabajando en la sesión mientras finaliza el trabajo. Si Remove-WmiObject se usa en un equipo remoto, el trabajo se crea en el equipo local y los resultados de los equipos remotos se devuelven automáticamente al equipo local. Para administrar el trabajo, use los cmdlets que contienen el nombre job (los cmdlets job ). Para obtener los resultados del trabajo, use el Receive-Job cmdlet .

Para usar este parámetro para equipos remotos, los equipos locales y remotos deben configurarse para la comunicación remota. Inicie Windows PowerShell mediante la opción Ejecutar como administrador. Para obtener más información, consulte about_Remote_Requirements.

Para obtener más información sobre los trabajos en segundo plano de Windows PowerShell, consulte about_Jobs y about_Remote_Jobs.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Authentication

Especifica el nivel de autenticación que se usa con la conexión de WMI. Los valores permitidos para este parámetro son los siguientes:

  • -1:Inalterado.
  • 0: valor predeterminado.
  • 1:Ninguno. No se realiza ninguna autenticación.
  • 2:Conectar. La autenticación solo se realiza cuando el cliente establece una relación con la aplicación.
  • 3:Llamar. La autenticación solo se realiza al principio de cada llamada cuando la aplicación recibe la solicitud.
  • 4:Paquete. La autenticación se realiza en todos los datos que se reciben del cliente.
  • 5: PacketIntegrity. Todos los datos que se transfieren entre el cliente y la aplicación se autentican y comprueban.
  • 6: PacketPrivacy. Se usan las propiedades de los demás niveles de autenticación y todos los datos se cifran.
Tipo:AuthenticationLevel
Valores aceptados:Default, None, Connect, Call, Packet, PacketIntegrity, PacketPrivacy, Unchanged
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Authority

Especifica la autoridad que se usará para autenticar la conexión WMI. Puede especificar la autenticación NTLM o Kerberos estándar. Para usar NTLM, establezca la configuración de autoridad en ntlmdomain:<DomainName>, donde <DomainName> identifica un nombre de dominio NTLM válido. Para usar Kerberos, especifique kerberos:<DomainName>\<ServerName>. No puede incluir la configuración de autoridad al conectarse al equipo local.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Class

Especifica el nombre de una clase WMI que elimina este cmdlet.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ComputerName

Especifica el nombre del equipo en el que se ejecuta este cmdlet. La opción predeterminada es el equipo local.

Escriba el nombre NetBIOS, una dirección IP o un nombre de dominio completo de uno o más equipos. Para especificar el equipo local, escriba el nombre del equipo, un punto (.) o localhost.

Este parámetro no utiliza la comunicación remota de Windows PowerShell. Puede usar el parámetro ComputerName incluso si el equipo no está configurado para ejecutar comandos remotos.

Tipo:String[]
Alias:Cn
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Credential

Especifica una cuenta de usuario con permiso para realizar esta acción. El valor predeterminado es el usuario actual.

Escriba un nombre de usuario, como User01 o Domain01\User01, o escriba un objeto PSCredential , como uno generado por el Get-Credential cmdlet. Si escribe un nombre de usuario, este cmdlet le pedirá una contraseña.

Tipo:PSCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-EnableAllPrivileges

Indica que este cmdlet habilita todos los permisos del usuario actual antes del comando que realiza la llamada WMI.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Impersonation

Especifica el nivel de suplantación que usar. Los valores permitidos para este parámetro son los siguientes:

  • 0: valor predeterminado. Lee el registro local para el nivel de suplantación predeterminado, que normalmente se establece en 3: Suplantar.
  • 1:Anónimo. Oculta las credenciales de la persona que llama.
  • 2:Identificar. permite que los objetos consulten las credenciales de la persona que llama.
  • 3:Suplantar. permite que los objetos usen las credenciales de la persona que llama.
  • 4:Delegado. Permite que los objetos dejen que otros objetos usen las credenciales de la persona que llama.
Tipo:ImpersonationLevel
Valores aceptados:Default, Anonymous, Identify, Impersonate, Delegate
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InputObject

Especifica un objeto ManagementObject que se va a usar como entrada. Cuando se usa este parámetro, se omite el resto de parámetros.

Tipo:ManagementObject
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Locale

Especifica la configuración regional preferida para objetos WMI. El parámetro Locale se especifica como una matriz en el formato MS_<LCID> en el orden preferido.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Namespace

Especifica el espacio de nombres del repositorio WMI donde se encuentra la clase WMI a la que se hace referencia cuando se usa con el parámetro Class .

Tipo:String
Alias:NS
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Path

Especifica la ruta de acceso del objeto de WMI de una clase de WMI o especifica la ruta de acceso del objeto de WMI de una instancia de una clase de WMI que se va a eliminar.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ThrottleLimit

Especifica el número máximo de operaciones simultáneas que se pueden establecer para ejecutar este comando. Este parámetro se usa junto con el parámetro AsJob . El límite solo se aplica al comando actual, no a la sesión ni al equipo.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

ManagementObject

Puede canalizar un objeto de administración a este cmdlet.

Salidas

None, System.Management.Automation.RemotingJob

Este cmdlet devuelve un objeto de trabajo, si especifica el parámetro AsJob . De lo contrario, este cmdlet no genera resultados de ningún tipo.

Notas

Windows PowerShell incluye los siguientes alias para Remove-WmiObject:

  • rwmi