Calificadores estándar

Todas las implementaciones compatibles con CIM deben controlar un conjunto estándar de calificadores. Un objeto específico no tiene enumerados todos los calificadores. Normalmente, las clases de extensión proporcionan calificadores adicionales para facilitar el aprovisionamiento de instancias de clase y otras operaciones en la clase.

Es responsabilidad del proveedor aplicar los calificadores. WMI no aplica calificadores, sino que los usa solo para informar al usuario sobre cómo se usa la propiedad.

Nota

WMI es compatible con la especificación CIM 2.5.

Los calificadores tienen las limitaciones siguientes:

• No todos los calificadores estándar se pueden usar juntos.
• No todos los calificadores se pueden aplicar a todas las construcciones, como la asociación o la referencia. Estas limitaciones se identifican en la lista "Se aplica a".
• Para una construcción determinada, como la asociación o la referencia, el uso de calificadores legales se puede restringir aún más porque algunos calificadores se excluyen mutuamente, el uso de un calificador puede conllevar restricciones en el valor de otro, etc. Estas reglas de uso están documentadas.
• Los calificadores legales los heredan entidades como propiedades, métodos, instancias o subclases, no asociaciones ni referencias. Por ejemplo, las referencias no heredan el calificador MaxLen que se aplica a las propiedades.

A continuación se enumeran los calificadores estándar de WMI.

Abstract

Tipo de datos: booleano

Se aplica a: clases, asociaciones e indicaciones

Indica si la clase es abstracta y solo sirve como base para clases nuevas. El valor predeterminado es FALSE. No se pueden crear instancias de clases abstractas. La ausencia de este calificador indica que la clase no es abstracta; por lo tanto, este calificador es necesario para todas las clases abstractas.

Aggregate

Tipo de datos: booleano

Se aplica a: referencias

Indica si la referencia es el componente primario de una asociación de agregación. El valor predeterminado es FALSE.

Uso: los calificadores Aggregation y Aggregate se usan juntos. Aggregation califica la asociación y Aggregate especifica la referencia primaria.

Aggregation

Tipo de datos: booleano

Se aplica a: asociaciones

Indica si la asociación es una agregación. El valor predeterminado es FALSE. Se usa con Aggregate. Este calificador es necesario para todas las asociaciones de agregación.

Alias

Tipo de datos: cadena

Se aplica a: propiedades, referencias y métodos

Nombre alternativo para una propiedad o método del esquema. El valor predeterminado es NULL.

ArrayType

Tipo de datos: cadena

Se aplica a: propiedades y parámetros

Tipo de la matriz calificada.

Los valores válidos son:

• bag (valor predeterminado)
• indizadas
• ordered

Uso: aplique este tipo de calificador solo a propiedades y parámetros que sean matrices (definidas mediante la sintaxis de corchetes).

BitMap

Tipo de datos: matriz de cadenas

Se aplica a: propiedades, métodos y parámetros

Mapa de posiciones de bits significativas donde cada posición significativa puede estar "activada" o "desactivada". Cada bit "activado" se asigna a un valor correspondiente en la matriz BitValues. Al tener varios bits "activados", se indican varios valores simultáneos en la matriz BitValues. El valor predeterminado es NULL.

Para obtener más información, vea BitMap y BitValues.

BitValues

Tipo de datos: matriz de cadenas

Se aplica a: propiedades, métodos y parámetros

Traducción de un valor de posición de bits en una cadena asociada. El valor predeterminado es NULL.

Para obtener más información, vea BitMap y BitValues.

Constructor

Tipo de datos: booleano

Se aplica a: métodos

Indica si el método crea instancias. Estos métodos no están restringidos a actuar en una sola instancia o clase. Por ejemplo, un constructor puede crear instancias de asociación, así como instancias de la clase que define el constructor.

El calificador Constructor está pensado solo para aportar información y no se espera que el administrador de objetos realice ninguna acción en él. El administrador de objetos no tiene que llamar a métodos de constructor cuando se crea un objeto. Además, cuando se llama a un constructor, el administrador de objetos no tiene que invocar ningún método constructor definido para ninguna clase primaria de la clase original. El valor predeterminado es FALSE.

CreateBy

Tipo de datos: cadena

Se aplica a: clases

Nombre del método por el que se crean instancias de esta clase. El valor es "PutInstance" o el nombre de otro método que crea las instancias. El valor predeterminado es NULL.

Uso: este calificador solo se puede usar si el calificador SupportsCreate está presente.

DeleteBy

Tipo de datos: cadena

Se aplica a: clases

Nombre del método por el que se eliminan instancias de esta clase. El valor es "DeleteInstance" o el nombre de otro método que elimina las instancias. El valor predeterminado es NULL.

Uso: este calificador solo se puede usar si el calificador SupportsDelete está presente.

Description

Tipo de datos: cadena

Se aplica a: todo

Descripción de un elemento con nombre. El valor predeterminado es NULL.

Destructor

Tipo de datos: booleano

Se aplica a: métodos

Indica si el método elimina instancias. Los métodos que usan el calificador Destructor eliminan las instancias a las que se aplica el destructor y no están restringidas a actuar en una sola instancia o clase. Por ejemplo, un destructor puede eliminar instancias de asociación, así como instancias de la clase que define el destructor.

El calificador Destructor está pensado solo para aportar información y no se espera que el administrador de objetos realice ninguna acción en él. No hay ninguna obligación de que el administrador de objetos llame a un método que tenga el calificador Destructor cuando se elimina una instancia. Además, cuando se llama a un destructor, el administrador de objetos no tiene que invocar ningún método destructor definido para ninguna clase primaria de la clase original. El valor predeterminado es FALSE.

DisplayName

Tipo de datos: cadena

Se aplica a: todo

Nombre que se muestra en la interfaz de usuario en lugar del nombre real del elemento. El valor predeterminado es NULL.

EmbeddedInstance

Tipo de datos: cadena

Se aplica a: todo

El elemento de tipo de cadena calificado contiene una instancia insertada. El valor de calificador especifica el nombre de una clase CIM en el mismo espacio de nombres que la clase propietaria del elemento calificado. La instancia insertada es una de la clase especificada, incluidas las instancias de sus subclases. El valor predeterminado es NULL.

Gauge

Tipo de datos: booleano

Se aplica a: todo

Indica si la propiedad representa un entero no negativo, que puede aumentar o disminuir, pero nunca superar un valor máximo. El valor predeterminado es FALSE.

El valor máximo de la propiedad no puede ser mayor que 2^n - 1. N puede ser 8, 16, 32 o 64, según el tipo de datos de la propiedad a la que se aplica este calificador. El valor de un medidor tiene su valor máximo cada vez que la información que se modela es mayor o igual que ese valor máximo. Si la información que se modela posteriormente disminuye por debajo del valor máximo, el medidor también disminuye. Este calificador solo se aplica a las propiedades con un tipo de datos entero sin signo.

In

Tipo de datos: booleano

Se aplica a: parámetros

Indica si el parámetro se usa para pasar valores a un método. El valor predeterminado es TRUE.

In, Out

Tipo de datos: booleano

Se aplica a: parámetros

Indica si el parámetro es un parámetro de entrada y de salida.

Key

Tipo de datos: booleano

Se aplica a: propiedades y referencias

Indica si la propiedad forma parte del identificador del espacio de nombres. Si más de una propiedad tiene el calificador Key, todas forman colectivamente la clave (una clave compuesta). Cuando se combinan, las propiedades de clave deben proporcionar una referencia única para cada instancia de clase. Si este calificador se coloca en una propiedad, solo se permite el valor TRUE.

Lazy

Se aplica a: propiedades

Indica que la propiedad consume muchos recursos para devolver, y requiere una gran cantidad de tiempo y memoria del procesador. WMI mejora el rendimiento de las consultas al no intentar devolver las propiedades marcadas con el calificador Lazy.

MappingStrings

Tipo de datos: matriz de cadenas

Se aplica a: clases, propiedades, asociaciones, indicaciones y referencias

Conjunto de valores que indican una ruta de acceso a una ubicación donde se puede encontrar más información sobre el origen de una propiedad, clase, asociación, indicación o referencia. La cadena de asignación puede ser una ruta de acceso de directorio, una dirección URL, una clave del Registro, un archivo de inclusión, una referencia a una clase CIM o algún otro formato. El valor predeterminado es NULL.

Max

Tipo de datos: entero

Se aplica a: referencias

Número máximo de valores que una referencia determinada puede tener para cada conjunto de otros valores de referencia de la asociación. El valor predeterminado es NULL. Por ejemplo, si una asociación relaciona instancias A con instancias B y debe haber como máximo una instancia A para cada instancia B, la referencia a A debe tener un máximo de un calificador.

MaxLen

Tipo de datos: entero

Se aplica a: propiedades, métodos y parámetros

Longitud máxima (en caracteres) de un elemento de datos de cadena. Indica compatibilidad con matrices de longitud fija.

Si se encuentra una matriz de longitud fija, el calificador MaxLen contiene la longitud fija que se detecta durante el análisis. Si se encuentra una matriz de longitud variable, no se usa este calificador. MaxLen se usa para sugerir el número máximo de elementos que se deben almacenar en una matriz. Al invalidar el valor predeterminado, se puede especificar cualquier valor entero sin signo (uint32). Un valor de NULL (valor predeterminado) implica una longitud ilimitada.

MaxValue

Tipo de datos: entero

Se aplica a: propiedades, métodos y parámetros

Valor máximo del objeto. El valor predeterminado es NULL.

Min

Tipo de datos: entero

Se aplica a: referencias

Cardinalidad mínima de la referencia (número mínimo de valores que una referencia determinada puede tener para cada conjunto de otros valores de referencia de la asociación). El valor predeterminado es 0.

Por ejemplo, si una asociación relaciona instancias A con instancias B y debe haber como mínimo una instancia A para cada instancia B, la referencia a A debe tener un mínimo de un calificador.

MinValue

Tipo de datos: entero

Se aplica a: propiedades, métodos y parámetros

Indica el valor mínimo del objeto. El valor predeterminado es NULL.

ModelCorrespondence

Tipo de datos: matriz de cadenas

Se aplica a: propiedades

Conjunto de valores que indican la correspondencia entre la propiedad de un objeto y otras propiedades del esquema CIM. El valor predeterminado es NULL.

Las propiedades de objeto se identifican mediante la sintaxis siguiente.

<nombre> de esquema "_" nombre de <clase o asociación> "." <nombre de propiedad>

Nonlocal

Tipo de datos: cadena

Se aplica a: referencias

Ubicación de una instancia, cuyo valor es <namespacetype>://<namespacehandle>. El valor predeterminado es NULL.

Uso: este calificador no se puede usar con el calificador NonlocalType.

NonlocalType

Tipo de datos: cadena

Se aplica a: referencias

Tipo de ubicación de una instancia. Su valor es <namespacetype>. El valor predeterminado es NULL.

Uso: este calificador no se puede usar con el calificador Nonlocal.

NullValue

Tipo de datos: cadena

Se aplica a: propiedades

Valor que indica que la propiedad asociada es NULL (la propiedad no tiene un valor válido o significativo). El valor predeterminado es NULL.

Las convenciones y restricciones que se usan para definir valores NULL son las mismas que las que se aplican al calificador ValueMap. Tenga en cuenta que este calificador no se puede invalidar. No es razonable permitir que una subclase devuelva un valor NULL diferente al de la clase primaria.

Out

Tipo de datos: booleano

Se aplica a: parámetros

Indica si el parámetro devuelve valores de un método. El valor predeterminado es FALSE.

Override

Tipo de datos: cadena

Se aplica a: propiedades, métodos y referencias

Clase primaria o construcción subordinada (propiedad, método o referencia) que se invalida mediante la propiedad, el método o la referencia del mismo nombre en la clase derivada. El valor predeterminado es NULL.

El formato es:

[<clase>.]<construcción subordinada>

Si se omite el nombre de clase, la invalidación se aplica a la construcción subordinada en la clase primaria de la jerarquía de clases.

Uso: el calificador Override solo puede hacer referencia a construcciones basadas en el mismo metamodelo. No se permite cambiar una firma o nombre de construcción durante una operación de invalidación.

OverrideValue

Se aplica a: clases

Indica si el valor de propiedad de una subclase invalida el valor de una clase primaria. La implicación funcional es que, si se realiza una consulta en la clase primaria y si la cláusula WHERE incluye esta propiedad, el elemento primario debe devolver una instancia con el valor invalidado. Como resultado, Administración de Windows ajusta la cláusula WHERE de la consulta enviada a la clase primaria para excluir las referencias a esta propiedad.

Propagated

Tipo de datos: cadena

Se aplica a: propiedades

Nombre de la clave que se va a propagar. El valor predeterminado es NULL.

El uso de este calificador da por supuesto que existe un solo calificador débil en una referencia que tiene la clase contenedora como destino. La propiedad asociada debe tener el mismo valor que la propiedad denominada por el calificador de la clase en el otro lado de la asociación débil. El formato es:

[<clase>.]<construcción subordinada>

Uso: cuando se usa el calificador Propagated, el calificador Key debe especificarse con un valor TRUE.

Read

Tipo de datos: booleano

Se aplica a: propiedades

Indica si la propiedad se puede leer. El valor predeterminado es TRUE.

Required

Tipo de datos: booleano

Se aplica a: propiedades

Indica si se requiere un valor distinto de NULL para la propiedad. El valor predeterminado es FALSE.

Revision

Tipo de datos: cadena

Se aplica a: clases, asociaciones, indicaciones y esquemas

Número de revisión menor del objeto de esquema. El valor predeterminado es NULL.

Uso: el calificador Version debe estar presente para proporcionar el número de versión principal cuando se usa el calificador Revision.

Schema

Tipo de datos: cadena

Se aplica a: propiedades, métodos

Nombre del esquema donde se define la característica. El valor predeterminado es NULL.

Source

Tipo de datos: cadena

Se aplica a: clases, asociaciones, indicaciones y referencias

Ubicación de una instancia. El valor predeterminado es NULL.

El valor del calificador es <namespacetype>://<namespacehandle>.

Uso: el calificador Source no se puede usar con el calificador SourceType.

SourceType

Tipo de datos: cadena

Se aplica a: clases, asociaciones, indicaciones y referencias

Tipo de ubicación de una instancia. El valor de este calificador es <namespacetype>. El valor predeterminado es NULL.

Uso: el calificador SourceType no se puede usar con el calificador Source.

SupportsCreate

Tipo de datos: booleano

Se aplica a: clases

Indica si la clase admite la creación de instancias. El valor predeterminado es FALSE.

SupportsDelete

Tipo de datos: booleano

Se aplica a: clases

Indica si la clase admite la eliminación de instancias. El valor predeterminado es FALSE.

SupportsUpdate

Tipo de datos: booleano

Se aplica a: clases

Indica si la clase admite la modificación (actualización) de instancias. El valor predeterminado es FALSE.

Terminal

Tipo de datos: booleano

Se aplica a: clases

Indica si la clase puede tener subclases. El valor predeterminado es FALSE.

Si se declara una subclase, el compilador genera un error.

Uso: este calificador no puede coexistir con el calificador Abstract. Si se especifican los calificadores Terminal y Abstract, el compilador genera un error.

Units

Tipo de datos: cadena

Se aplica a: propiedades, métodos y parámetros

Tipo de unidad en la que se expresa el elemento de datos asociado. El valor predeterminado es NULL.

Por ejemplo, un elemento de datos de tamaño podría tener un valor de "bytes" para Units.

ValueMap

Tipo de datos: matriz de cadenas

Se aplica a: propiedades, métodos y parámetros

Conjunto de valores permitidos para una propiedad, un tipo de valor devuelto de método o un parámetro de método. El valor predeterminado es NULL.

Uso: este calificador se puede usar solo o en combinación con el calificador Values. Cuando se usa en combinación con el calificador Values, la ubicación del valor en la matriz ValueMap proporciona la ubicación de la entrada correspondiente en la matriz Values. Use el calificador ValueMap solo con valores enteros y de cadena. La sintaxis para representar un valor entero en la matriz de mapa de valores es [+|=]digit[*digit]. El contenido, número máximo de dígitos y valor representado están restringidos por el tipo de la propiedad asociada. Por ejemplo, uint8 puede no tener signo, debe tener menos de cuatro dígitos y debe representar un valor inferior a 256.

Values

Tipo de datos: matriz de cadenas

Se aplica a: propiedades, métodos y parámetros

Conjunto de valores que traducen un valor entero a una cadena asociada. El valor predeterminado es NULL.

Esta propiedad también especifica una matriz de valores de cadena que se asignarán a una propiedad de enumeración. Este calificador se puede aplicar a una propiedad entera o a una propiedad de cadena, y la asignación puede ser implícita o explícita. Si la asignación es implícita, los valores enteros o de propiedad de cadena representan posiciones ordinales en la matriz Values. Si la asignación es explícita, la propiedad debe ser un entero y los valores de propiedad válidos se muestran en la matriz que define el calificador ValueMap. Para obtener más información, vea Mapa de valores.

Si un calificador ValueMap no está presente, la matriz Values se indexa (de forma relativa a cero) mediante el valor de la propiedad asociada, el tipo de valor devuelto del método o el parámetro de método. Si hay presente un calificador ValueMap, el índice de valores se define mediante la ubicación del valor de propiedad en el mapa de valores.

Version

Tipo de datos: cadena

Se aplica a: clases, esquemas, asociaciones e indicaciones

Número de versión principal del objeto de esquema. El valor predeterminado es NULL. El número de versión se incrementa cuando se realizan cambios en el esquema que modifican la interfaz.

Weak

Tipo de datos: booleano

Se aplica a: referencias

Indica si las claves de la clase a la que se hace referencia incluyen las claves de los demás participantes de la asociación. El valor predeterminado es FALSE.

Este calificador se usa cuando la identidad de la clase a la que se hace referencia depende de la identidad de los demás participantes de la asociación. No puede haber más de una referencia débil a una clase determinada. Las demás clases de la asociación deben definir una clave. Las claves de las otras clases de la asociación se repiten en la clase a la que se hace referencia y se etiquetan con un calificador Propagated.

Write

Tipo de datos: booleano

Se aplica a: propiedades

Indica que las aplicaciones o scripts pueden cambiar el valor de propiedad. La cuenta que ejecuta la aplicación debe tener acceso al espacio de nombres que contiene instancias de la clase. La implementación del proveedor también puede limitar el acceso a los datos del proveedor. Un valor TRUE indica que los consumidores a los que WMI y el proveedor permiten el acceso pueden leer la propiedad y escribir en ella. El valor predeterminado es FALSE.

Es posible que se pueda escribir igualmente en una propiedad que no tenga el calificador Write. La implementación del proveedor podría permitir que se cambien las propiedades de las clases de proveedor, independientemente de si está presente el calificador Write.

WriteAtCreate

Tipo de datos: booleano

Se aplica a: propiedades

Indica si se puede escribir en la propiedad cuando se crea la instancia. Este calificador se puede usar junto con el calificador WriteAtCreate. El valor predeterminado es FALSE.

WriteAtUpdate

Tipo de datos: booleano

Se aplica a: propiedades

Indica si se puede escribir en la propiedad cuando se actualiza la instancia. Este calificador se puede usar junto con el calificador WriteAtCreate. El valor predeterminado es FALSE.

Ejemplos

Para obtener más información sobre cómo recuperar calificadores, vea el ejemplo de código de PowerShell Get-WmiClassMethodsAndWritableWmiProperties en la Galería de TechNet.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008

Consulte también

Calificadores de WMI

Agregar un calificador