Eliminar-CimInstance (CimCmdlets)

Remove-CimInstance

Módulo:

CimCmdlets

Elimina una instancia CIM de una computadora.

Sintaxis

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

Descripción

Este cmdlet solo está disponible en la plataforma Windows.

Este cmdlet elimina una instancia CIM de un servidor CIM. Puede especificar la instancia de CIM que desea eliminar utilizando un objeto de instancia de CIM recuperado por el cmdlet Get-CimInstance o especificando una consulta.

Si no se especifica el parámetro InputObject, el cmdlet funciona de una de las siguientes maneras:

• Si no se especifica ni el parámetro ComputerName ni el parámetro CimSession, este cmdlet funciona en el Instrumental de administración de Windows (WMI) local mediante una sesión del Modelo de objetos componentes (COM).
• Si se especifica el parámetro ComputerName o el parámetro CimSession, este cmdlet funciona con el servidor CIM especificado por el parámetro ComputerName o el < parámetroCimSession.

Ejemplos

Ejemplo 1: eliminar la instancia CIM

Este ejemplo utiliza el parámetro Query para eliminar instancias CIM de la clase denominada Win32_Environment que comienzan con la cadena de caracteres testvar.

Remove-CimInstance -Query 'Select * from Win32_Environment where name LIKE "testvar%"'

Ejemplo 2: eliminar la instancia CIM utilizando el objeto de instancia CIM

Este ejemplo recupera los objetos de instancia CIM filtrados por el parámetro Query y los almacena en una variable denominada $var mediante el cmdlet Get-CimInstance. Luego, el contenido de la variable se pasa al cmdlet Remove-CimInstance, que elimina las instancias de CIM.

notepad.exe
$var = Get-CimInstance -Query 'Select * from Win32_Process where name LIKE "notepad%"'
Remove-CimInstance -InputObject $var

Parámetros

-CimSession

Ejecuta el comando utilizando la sesión CIM especificada. Introduzca una variable que contenga la sesión CIM o un comando que cree u obtenga la sesión CIM, como los cmdlets New-CimSession o Get-CimSession. Para obtener más información, consulte about_CimSession.

Tipo :

Sesión cim[]

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

True

Aceptar entrada de canalización:

True

Aceptar caracteres comodín:

False

-ComputerName

Especifica el nombre de la computadora en la que desea ejecutar la operación CIM. Puede especificar un nombre de dominio completo (FQDN) o un nombre NetBIOS.

Si especifica este parámetro, el cmdlet crea una sesión temporal en la computadora especificada mediante el protocolo WsMan.

Si no especifica este parámetro, el cmdlet realiza la operación en la computadora local usando el Modelo de objetos componentes (COM).

Si se realizan varias operaciones en la misma computadora, conectarse mediante una sesión CIM proporciona un mejor rendimiento.

Tipo :

String[]

Alias:

CN, ServerName

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-Confirm

Le solicita confirmación antes de ejecutar el cmdlet.

Tipo :

SwitchParameter

Alias:

cf

Posición:

Nombrado

Valor predeterminado:

False

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-InputObject

Especifica un objeto de instancia CIM que se eliminará del servidor CIM. El objeto pasado al cmdlet no se modifica, solo se elimina la instancia en el servidor CIM.

El parámetro InputObject no enumera colecciones. Si se pasa una colección, se genera un error. Cuando trabaje con colecciones, canalice la entrada para enumerar los valores.

Tipo :

CimInstance

Alias:

CimInstance

Posición:

1

Valor predeterminado:

None

Requerido:

True

Aceptar entrada de canalización:

True

Aceptar caracteres comodín:

False

-Namespace

Especifica el espacio de nombres para la operación CIM. El espacio de nombres predeterminado es root/cimv2. Puede utilizar la función de tabulación para examinar la lista de espacios de nombres, porque PowerShell obtiene una lista de espacios de nombres del servidor WMI local para proporcionar la lista de espacios de nombres.

Tipo :

String

Posición:

2

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

True

Aceptar caracteres comodín:

False

-OperationTimeoutSec

Especifica la cantidad de tiempo que el cmdlet espera una respuesta del equipo. De forma predeterminada, el valor de este parámetro es 0, lo que significa que el cmdlet utiliza el valor de tiempo de espera predeterminado para el servidor.

Si el parámetro OperationTimeoutSec se establece en un valor menor que el tiempo de espera de reintento de conexión robusta de 3 minutos, las fallas de red que duran más que el valor del parámetro OperationTimeoutSec no son recuperables. porque la operación en el servidor expira antes de que el cliente pueda volver a conectarse.

Tipo :

UInt32

Alias:

OT

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-Query

Especifica una consulta para ejecutar en el servidor CIM. Puede especificar el dialecto de consulta utilizando el parámetro QueryDialect.

Si el valor especificado contiene comillas dobles ("), comillas simples (') o una barra invertida (\), debe aplicar escape a esos caracteres. prefijándolos con el carácter de barra invertida (\). Si el valor especificado utiliza el operador WQL LIKE, debe escapar los siguientes caracteres encerrándolos entre corchetes (<).[]): porcentaje (%), guión bajo (_) o corchete de apertura ([).

Tipo :

String

Posición:

1

Valor predeterminado:

None

Requerido:

True

Aceptar entrada de canalización:

True

Aceptar caracteres comodín:

False

-QueryDialect

Especifica el lenguaje de consulta utilizado para el parámetro de consulta. Los valores aceptables para este parámetro son: WQL o CQL. El valor predeterminado es WQL.

Tipo :

String

Posición:

Nombrado

Valor predeterminado:

WQL

Requerido:

False

Aceptar entrada de canalización:

True

Aceptar caracteres comodín:

False

-ResourceUri

Especifica el identificador uniforme de recursos (URI) de la clase o instancia de recurso. El URI se utiliza para identificar un tipo específico de recurso, como discos o procesos, en una computadora.

Un URI consta de un prefijo y una ruta a un recurso. Por ejemplo:

http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk

http://intel.com/wbem/wscim/1/amt-schema/1/AMT_GeneralSettings

De forma predeterminada, si no especifica este parámetro, se utiliza el URI de recurso estándar DMTF http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ y la clase se le añade el nombre.

ResourceURI solo se puede utilizar con sesiones CIM creadas mediante el protocolo WSMan o al especificar el parámetro ComputerName, que crea una sesión CIM mediante WSMan. Si especifica este parámetro sin especificar el parámetro ComputerName, o si especifica una sesión CIM creada utilizando el protocolo DCOM, obtendrá un error, porque el protocolo DCOM no admite el parámetro ResourceURI.

Si se especifican tanto el parámetro ResourceUri como el parámetro Filter, el parámetro Filter se ignora.

Tipo :

uri

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

True

Aceptar caracteres comodín:

False

-WhatIf

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

Tipo :

SwitchParameter

Alias:

wi

Posición:

Nombrado

Valor predeterminado:

False

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

Entradas

Ninguno

No puede canalizar objetos a este cmdlet.

Salidas

Ninguno

Este cmdlet no devuelve ningún resultado.

Notas

PowerShell incluye los siguientes alias para Remove-CimInstance:

• Windows:

  rcim

Este cmdlet solo está disponible en plataformas Windows.