Remove-WmiObject

Sintaxis

class (valor predeterminado)

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

object

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

path

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

WQLQuery

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

query

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

list

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

Description

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

Ejemplo 2: Eliminar una carpeta

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

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 CIM, introducidos en 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 Remove-WmiObject, considere la posibilidad de usar el 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 continuar trabajando en la sesión mientras finaliza el trabajo. Si se usa 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, use los cmdlets que contienen el nombre de Job (los cmdlets Job ). Para obtener los resultados del trabajo, use el cmdlet Receive-Job.

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.

Propiedades de parámetro

Conjuntos de parámetros

-Authentication

Especifica el nivel de autenticación que se va a usar para la conexión WMI. Los valores aceptables para este parámetro son:

• -1: Sin cambios.
• 0: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: llamada. 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.

Propiedades de parámetro

Conjuntos de parámetros

-Authority

Especifica la autoridad que se va a 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.

Propiedades de parámetro

Conjuntos de parámetros

-Class

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

Propiedades de parámetro

Conjuntos de parámetros

-ComputerName

Especifica el nombre del equipo en el que se ejecuta este cmdlet. El valor predeterminado es el equipo local.

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

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

Propiedades de parámetro

Conjuntos de parámetros

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades de parámetro

Conjuntos de parámetros

-Credential

Especifica una cuenta de usuario que tiene 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 de PSCredential, como uno generado por el cmdlet Get-Credential. Si escribe un nombre de usuario, este cmdlet le pedirá una contraseña.

Propiedades de parámetro

Conjuntos de parámetros

-EnableAllPrivileges

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

Propiedades de parámetro

Conjuntos de parámetros

-Impersonation

Especifica el nivel de suplantación que se va a usar. Los valores aceptables para este parámetro son:

• 0: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 del autor de la llamada.
• 2: identificar. Permite a los objetos consultar las credenciales del autor de la llamada.
• 3: suplantar. Permite que los objetos usen las credenciales del autor de la llamada.
• 4: Delegado. Permite a los objetos permitir que otros objetos usen las credenciales del autor de la llamada.

Propiedades de parámetro

Conjuntos de parámetros

-InputObject

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

Propiedades de parámetro

Conjuntos de parámetros

-Locale

Especifica la configuración regional preferida para los objetos WMI. El parámetro Configuración regional se especifica como una matriz en el MS_LCID formato en el orden preferido.

Propiedades de parámetro

Conjuntos de parámetros

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

Propiedades de parámetro

Conjuntos de parámetros

-Path

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

Propiedades de parámetro

Conjuntos de parámetros

-ThrottleLimit

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

Propiedades de parámetro

Conjuntos de parámetros

-WhatIf

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

Propiedades de parámetro

Conjuntos de parámetros

CommonParameters

Entradas

ManagementObject

Salidas

None, System.Management.Automation.RemotingJob

Notas

Vínculos relacionados

• Get-WmiObject
• Invoke-WmiMethod
• Set-WmiInstance