Remove-WmiObject

Artículo
01/12/2010

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

Sintaxis

Remove-WmiObject [-Class] <string> [-Authentication {<Default> | <None> | <Connect> | <Call> | <Packet> | <PacketIntegrity> | <PacketPrivacy> | <Unchanged>}] [-Authority <string>] [-ComputerName <string[]>] [-Credential <PSCredential>] [-EnableAllPrivileges] [-Impersonation {<Default> | <Anonymous> | <Identify> | <Impersonate> | <Delegate>}] [-Locale <string>] [-Namespace <string>] [-AsJob] [-ThrottleLimit <int>] [-Confirm] [-WhatIf] [<CommonParameters>]

Remove-WmiObject [-Authentication {<Default> | <None> | <Connect> | <Call> | <Packet> | <PacketIntegrity> | <PacketPrivacy> | <Unchanged>}] [-Authority <string>] [-ComputerName <string[]>] [-Credential <PSCredential>] [-EnableAllPrivileges] [-Impersonation {<Default> | <Anonymous> | <Identify> | <Impersonate> | <Delegate>}] [-Locale <string>] [-Namespace <string>] [-AsJob] [-ThrottleLimit <int>] [-Confirm] [-WhatIf] [<CommonParameters>]

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

Remove-WmiObject -Path <string> [-Authentication {<Default> | <None> | <Connect> | <Call> | <Packet> | <PacketIntegrity> | <PacketPrivacy> | <Unchanged>}] [-Authority <string>] [-ComputerName <string[]>] [-Credential <PSCredential>] [-EnableAllPrivileges] [-Impersonation {<Default> | <Anonymous> | <Identify> | <Impersonate> | <Delegate>}] [-Locale <string>] [-Namespace <string>] [-AsJob] [-ThrottleLimit <int>] [-Confirm] [-WhatIf] [<CommonParameters>]

Remove-WmiObject [-Authentication {<Default> | <None> | <Connect> | <Call> | <Packet> | <PacketIntegrity> | <PacketPrivacy> | <Unchanged>}] [-Authority <string>] [-ComputerName <string[]>] [-Credential <PSCredential>] [-EnableAllPrivileges] [-Impersonation {<Default> | <Anonymous> | <Identify> | <Impersonate> | <Delegate>}] [-Locale <string>] [-Namespace <string>] [-AsJob] [-ThrottleLimit <int>] [-Confirm] [-WhatIf] [<CommonParameters>]

Remove-WmiObject [-Authentication {<Default> | <None> | <Connect> | <Call> | <Packet> | <PacketIntegrity> | <PacketPrivacy> | <Unchanged>}] [-Authority <string>] [-ComputerName <string[]>] [-Credential <PSCredential>] [-EnableAllPrivileges] [-Impersonation {<Default> | <Anonymous> | <Identify> | <Impersonate> | <Delegate>}] [-Locale <string>] [-Namespace <string>] [-AsJob] [-ThrottleLimit <int>] [-Confirm] [-WhatIf] [<CommonParameters>]

Descripción

El cmdlet Remove-WmiObject elimina una instancia de una clase existente de WMI.

Parámetros

-AsJob

Ejecuta el comando como un trabajo en segundo plano. Use este parámetro para ejecutar comandos que tardan mucho tiempo en completarse.

Cuando se utiliza 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 se completa el trabajo. Si se utiliza Remove-WmiObject 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, utilice los cmdlets que contienen el nombre Job (cmdlets Job). Para obtener los resultados del trabajo, use el cmdlet Receive-Job.

Nota: para utilizar este parámetro en equipos remotos, los equipos locales y remotos deben estar configurados para la comunicación remota. Además, debe iniciar Windows PowerShell con la opción "Ejecutar como administrador" en Windows Vista y versiones posteriores de Windows. Para obtener más información, vea about_Remote_Requirements.

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

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-Authentication <AuthenticationLevel>

Especifica el nivel de autenticación que se va a utilizar con la conexión de WMI. Los valores válidos son:

-1: Unchanged

0: Default

1: None (no se realiza ninguna autenticación.)

2: Connect (la autenticación se realiza solo cuando el cliente establece una relación con la aplicación.)

3: Call (la autenticación se realiza solo al comienzo de cada llamada cuando la aplicación recibe la solicitud.)

4: Packet (se autentican todos los datos que se reciben del cliente.)

5: PacketIntegrity (se autentican y se comprueban todos los datos que se transfieren entre el cliente y la aplicación.)

6: PacketPrivacy (se utilizan las propiedades de los demás niveles de autenticación y se cifran todos los datos.)

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-Authority <string>

Especifica la autoridad que se va a utilizar para autenticar la conexión de WMI. Puede especificar la autenticación estándar NTLM o Kerberos. Para utilizar NTLM, establezca el valor de autoridad en "ntlmdomain:<nombreDeDominio>", donde <nombreDeDominio> identifica un nombre de dominio NTLM válido. Para utilizar Kerberos, especifique "kerberos:<nombreDeDominio>\<nombreDeServidor>". No puede incluir el valor de autoridad cuando se conecta al equipo local.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-Class <string>

Especifica el nombre de la clase de WMI que se va a eliminar.

¿Requerido?	true
¿Posición?	1
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-ComputerName <string[]>

Especifica el equipo en el que desea ejecutar la operación de administración. El valor puede ser un nombre de dominio completo, un nombre NetBIOS o una dirección IP. Use el nombre del equipo local, localhost, o bien, un punto (.) para especificar el equipo local. El equipo local es el valor predeterminado. Cuando el equipo remoto está en un dominio diferente que el usuario, debe usar un nombre de dominio completo. Puede establecer el valor de este parámetro canalizando el valor al parámetro.

Este parámetro no se basa en la comunicación remota de Windows PowerShell, que utiliza WS-Management. Puede usar el parámetro ComputerName de Get-WmiObject incluso si el equipo no está configurado para la ejecución de comandos remotos de WS-Management.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-Credential <PSCredential>

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 "Usuario01", "Dominio01\Usuario01" o "Usuario@Contoso.com". O bien, escriba un objeto PSCredential, como el objeto devuelto por el cmdlet Get-Credential. Cuando escriba un nombre de usuario, se le solicitará una contraseña.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-EnableAllPrivileges

Habilita todos los privilegios del usuario actual antes de que el comando realice la llamada a WMI.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-Impersonation <ImpersonationLevel>

Especifica el nivel de suplantación que se va a usar. Los valores válidos son:

0: Default (lee el Registro local para determinar el nivel de suplantación predeterminado, que suele estar establecido en "3: Impersonate".)

1: Anonymous (oculta las credenciales del autor de la llamada.)

2: Identify (permite que los objetos consulten las credenciales del autor de la llamada.)

3: Impersonate (permite a los objetos utilizar las credenciales del autor de la llamada.)

4: Delegate (permite que los objetos dejen que otros objetos usen las credenciales del autor de la llamada.)

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-InputObject <ManagementObject>

Especifica un objeto ManagementObject que se va a usar como entrada. Cuando se utiliza este parámetro, se omiten todos los demás parámetros.

¿Requerido?	true
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	true (ByValue)
¿Aceptar caracteres comodín?	false

-Locale <string>

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

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-Namespace <string>

Si se usa con el parámetro Class, este parámetro especifica el espacio de nombres del repositorio de WMI donde se encuentra la clase de WMI a la que se hace referencia.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-Path <string>

Especifica la ruta de acceso al objeto de WMI de una clase de WMI, o bien, la ruta de acceso al objeto de WMI de una instancia de una clase de WMI que se va a eliminar.

¿Requerido?	true
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-ThrottleLimit <int>

Permite al usuario especificar un valor de límite para el número de operaciones de WMI que se pueden ejecutar de manera simultánea. Este parámetro se utiliza con el parámetro AsJob. Este límite se aplica únicamente al comando actual; no se aplica a la sesión ni al equipo.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-Confirm

Solicita confirmación antes de ejecutar el comando.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-WhatIf

Describe lo que ocurriría si ejecutara el comando sin ejecutarlo realmente.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

<CommonParameters>

Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.

Entradas y salidas

El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.

Entradas

System.Management.ManagementObject

Puede canalizar un objeto de administración a Remove-WmiObject.

Salidas

Ninguno o System.Management.Automation.RemotingJob

Cuando se usa el parámetro AsJob, este cmdlet devuelve un objeto de trabajo. De lo contrario, no genera resultados.

Ejemplo 1

C:\PS>notepad   
C:\PS> $np = get-wmiobject -query "select * from win32_process where name='notepad.exe'"
C:\PS> $np | remove-wmiobject

Descripción
-----------
Este comando cierra todas las instancias de Notepad.exe.

El primer comando inicia una instancia de Bloc de notas. 

El segundo comando usa el cmdlet Get-WmiObject para recuperar las instancias de Win32_Process correspondientes a Notepad.exe y las almacena en la variable $np. 

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

Ejemplo 2

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

Descripción
-----------
Este comando elimina el directorio C:\Test.

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

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

Vea también

Conceptos

Get-WmiObject
Invoke-WmiMethod
Set-WmiInstance
Get-WSManInstance
Invoke-WSManAction
New-WSManInstance
Remove-WSManInstance

Compartir a través de