Compartir a través de

Get-CimClass

  • Referencia
Módulo:
CimCmdlets

Obtiene una lista de clases CIM en un espacio de nombres específico.

Sintaxis

Get-CimClass
   [[-ClassName] <string>]
   [[-Namespace] <string>]
   [-Amended]
   [-OperationTimeoutSec <uint>]
   [-ComputerName <string[]>]
   [-MethodName <string>]
   [-PropertyName <string>]
   [-QualifierName <string>]
   [<CommonParameters>]
Get-CimClass
   [[-ClassName] <string>]
   [[-Namespace] <string>]
   -CimSession <CimSession[]>
   [-Amended]
   [-OperationTimeoutSec <uint>]
   [-MethodName <string>]
   [-PropertyName <string>]
   [-QualifierName <string>]
   [<CommonParameters>]

Description

Este cmdlet solo está disponible en la plataforma Windows.

El Get-CimClass cmdlet recupera una lista de clases CIM en un espacio de nombres específico. Si no se proporciona ningún nombre de clase, el cmdlet devuelve todas las clases del espacio de nombres. A diferencia de una instancia cim, las clases CIM no contienen el nombre de la sesión o del equipo CIM desde el que se recuperan.

Ejemplos

Ejemplo 1: Obtener todas las definiciones de clase

En este ejemplo se obtienen todas las definiciones de clase en el espacio de nombres root/cimv2.

Get-CimClass

Ejemplo 2: Obtener las clases con un nombre específico

En este ejemplo se obtienen las clases que contienen la palabra disk en sus nombres.

Get-CimClass -ClassName *disk*

Ejemplo 3: Obtener las clases con un nombre de método específico

En este ejemplo se obtienen las clases que comienzan por el nombre Win32 y tienen un nombre de método que comienza por Term.

Get-CimClass -ClassName Win32* -MethodName Term*

Ejemplo 4: Obtener las clases con un nombre de propiedad específico

En este ejemplo se obtienen las clases que comienzan por el nombre Win32 y tienen una propiedad denominada Handle.

Get-CimClass -ClassName Win32* -PropertyName Handle

Ejemplo 5: Obtener las clases con un nombre de calificador específico

En este ejemplo se obtienen las clases que comienzan con el nombre Win32, contienen la palabra Disk en sus nombres y tienen el calificador Association especificado.

Get-CimClass -ClassName Win32*Disk* -QualifierName Association

Ejemplo 6: Obtener las definiciones de clase de un espacio de nombres específico

En este ejemplo se obtienen las definiciones de clase que contienen la palabra Net en sus nombres del espacio de nombres especificado root/standardCimv2.

Get-CimClass -Namespace root/standardCimv2 -ClassName *Net*

Ejemplo 7: Obtener las definiciones de clase de un servidor remoto

En este ejemplo se obtienen las definiciones de clase que contienen el disco de palabras en sus nombres de los servidores remotos especificados Server01 y Server02.

Get-CimClass -ClassName *disk* -ComputerName Server01, Server02

Ejemplo 8: Obtener las clases mediante una sesión CIM

$s = New-CimSession -ComputerName Server01, Server02
Get-CimClass -ClassName *disk* -CimSession $s

Este conjunto de comandos crea una sesión con varios equipos y lo almacena en una variable $s mediante el New-CimSession cmdlet y, a continuación, obtiene las clases mediante el Get-CimClass cmdlet .

Parámetros

-Amended

Indica que los objetos devueltos de la consulta CIM deben contener información modificada. Normalmente, la información modificada es información localizable, como descripciones de objetos y propiedades adjuntas al objeto CIM. Esto resulta útil para traducir valores numéricos a valores legibles por el usuario.

Este parámetro se agregó en PowerShell 7.3.

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

-CimSession

Ejecuta el cmdlet en una sesión remota o en un equipo remoto. Escriba un nombre de equipo o un objeto de sesión, como la salida de un New-CimSession cmdlet o Get-CimSession . El valor predeterminado es la sesión actual en el equipo local.

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

-ClassName

Especifica el nombre de la clase CIM para la que se va a realizar la operación. Puede usar la finalización de tabulación para examinar la lista de clases, ya que PowerShell obtiene una lista de clases del servidor WMI local para proporcionar una lista de nombres de clase.

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

-ComputerName

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

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

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

Si se realizan varias operaciones en el mismo equipo, el uso de una sesión CIM ofrece un mejor rendimiento.

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

-MethodName

Busca las clases que tienen un método que coincida con este nombre. Puede usar caracteres comodín con este parámetro.

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

-Namespace

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

Tipo:String
Posición:1
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 usa 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 sólido de 3 minutos, los errores de red que duran más que el valor del parámetro OperationTimeoutSec no se pueden recuperar, ya que la operación en el servidor agota el tiempo de espera antes de que el cliente pueda volver a conectarse.

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

-PropertyName

Busca las clases que tienen una propiedad que coincida con este nombre. Puede usar caracteres comodín con este parámetro.

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

-QualifierName

Filtra las clases por nombre de calificador de nivel de clase. Puede usar caracteres comodín con este parámetro.

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

Entradas

None

No se pueden canalizar objetos a este cmdlet.

Salidas

CimClass

Este cmdlet devuelve un objeto de clase CIM.

Notas

PowerShell incluye los siguientes alias para Get-CimClass:

  • Windows:
    • gcls

Este cmdlet solo está disponible en plataformas Windows.