Calificadores de contexto de Configuration Manager

Los objetos de contexto se usan, en Configuration Manager, para proporcionar información adicional al proveedor de SMS. Normalmente, los calificadores de contexto se usan para proporcionar al proveedor de SMS información contextual, como el nombre de la aplicación. Puede utilizar cualificadores de contexto cuando se conecta al proveedor de SMS y con objetos de proveedor de SMS individuales.

Código administrado

Al usar las bibliotecas de proveedores de SMS administradas, se usa la propiedad ConnectionManagerBase.Context para especificar los cualificadores de contexto. Para obtener más información, consulta How to add a Configuration Manager Context Qualifier by using Managed Code.

VBScript

Cuando se usa VBScript, se usa el conjunto de interfaces SWBemNamedValue para especificar cualificadores de contexto como una colección de objetos de valor con nombre. Para obtener más información, consulta Cómo agregar un calificador de contexto de Configuration Manager mediante WMI.

Calificadores de contexto

La tabla siguiente contiene los cualificadores de contexto (valores con nombre) utilizados por el proveedor de SMS. La mayoría de los cualificadores, como SessionHandle, solo se usan con áreas funcionales específicas del proveedor de SMS; but LocaleID, MachineName, y ApplicationName son para el uso de la aplicación.

ApplicationName

El ApplicationName cualificador de contexto es un valor de cadena que identifica el nombre de la aplicación que realizó la llamada. Debe especificarlo ApplicationName para la aplicación, ya que se usa para auditoría. Si no proporciona el nombre de la aplicación, se usa un valor de Desconocido. Debe proporcionar el ApplicationName valor cuando llame a cualquiera de los métodos de mensaje de estado de elevación, como SMS_StatusMessage::RaiseErrorStatusMsg, o se producirá un error en la llamada.

Identificador de contexto

El ContextHandle calificador de contexto es un valor de cadena que identifica dónde ha almacenado el proveedor de SMS los calificadores de contexto almacenados en caché. El proveedor de SMS administrado administra la transferencia de datos. Al usar VBScript, puede usar los pasos siguientes para reducir la cantidad de datos que se pasan a través de la red.

1. Cree un conjunto de valores SWBemNamedValue .

2. Agregue los calificadores al objeto de contexto. Para obtener más información, consulta Cómo agregar un calificador de contexto de Configuration Manager mediante WMI.

3. Llame al método GetContextHandle para almacenar en caché los cualificadores en el servidor. El proveedor de SMS almacena en memoria caché el objeto de contexto que se pasa como parámetro de ExecMethod cuando se llama a GetContextHandle.

4. Quite todos los calificadores del objeto de contexto.

5. Agregue el calificador y el ContextHandle valor al objeto de contexto.

6. Pasar el objeto de contexto en todas las llamadas a IWbemServices.

   Debe llamar al método ClearContextHandle para quitar los calificadores almacenados en caché antes de salir de la aplicación. Puede crear tantos ContextHandle valores como desee, de modo que cada uno de ellos proporcione información variable para su aplicación.

InstanceCount

El InstanceCount calificador de contexto es un valor entero que se utiliza para limitar el número de instancias devueltas por los métodos ExecQuery y CreateInstanceEnum . Establezca InstanceCount igual al número máximo de instancias que desea que se devuelvan desde la consulta o enumerador. Por ejemplo, si se establece InstanceCount en 10, se devuelven como máximo 10 instancias.

LimitToCollectionIDs

El LimitToCollectionIDs calificador de contexto es una matriz de cadenas que contiene una lista de CollectionID valores. Actualmente, solo puede especificar un CollectionID valor. Este calificador se usa para limitar los resultados de una consulta de recursos a los miembros de la colección con nombre. Una consulta de recursos es una consulta que incluye clases derivadas de SMS_Resource o SMS_Group.

El usuario debe tener permisos de recurso de lectura de instancia para la colección a la que pertenece el recurso. Debe utilizar la limitación de colecciones cuando el usuario no tenga derechos de recurso de lectura de clase para las colecciones; de lo contrario, no se devuelve ningún dato. Para SMS 2.0 con Service Pack 1 y versiones posteriores, esta restricción solo se aplica a las clases derivadas de SMS_Group.

No puede usar este calificador al consultar colecciones.

LocaleID

El LocaleID calificador de contexto es un valor de cadena que acepta un valor hexadecimal o decimal en la forma MS\x, donde x es el identificador de configuración regional. Por ejemplo, puede escribir el valor en inglés LocaleID como ms\0x0409 o ms\1033. El proveedor de SMS solo acepta LocaleID valores que usan el formato de Microsoft. Puede encontrar una lista de locale IDsidentificadores de configuración regional asignados por Microsoft.

Si necesita la configuración regional para aplicaciones que no sean de EE. UU. puede obtenerla de la propiedad SMS_Identification Server WMI ClassLocaleID .

Nombre de máquina

El MachineName cualificador de contexto es un valor de cadena que identifica qué equipo ejecuta la aplicación. Debe especificarlo MachineName para la aplicación, ya que se usa para auditoría. Si no proporciona el nombre del equipo, se usa un valor de Desconocido. Debe proporcionar el valor MachineName cuando llame a cualquiera de los métodos de mensaje de estado de elevación, como SMS_StatusMessage::RaiseRawStatusMsg, o se producirá un error en la llamada.

QueryQualifiers

El QueryQualifiers calificador de contexto es un valor booleano que se usa para devolver las marcas de bits de SecurityVerbs al ejecutar consultas en objetos protegidos, como SMS_Site o SMS_Package. Tenga en cuenta que su uso QueryQualifiers al consultar objetos no seguros genera un error. De forma predeterminada, las marcas SecurityVerbs no se devuelven con la consulta. Debe crear este calificador y establecer su valor en si true desea que se devuelvan las marcas. No crear QueryQualifiers es lo mismo que establecer su valor en false.

Identificador de sesión

El SessionHandle cualificador de contexto es un valor de cadena que se devuelve como parámetro out del método GetSessionHandle. La cadena es un GUID único que identifica la copia del archivo de control de sitio en Configuration Manager de la aplicación. Debe utilizar este mecanismo para modificar el archivo de control de sitio y reducir las colisiones de datos con otras aplicaciones que están modificando el archivo de control de sitio al mismo tiempo. Si no proporciona ningún SessionHandle valor, la aplicación modifica la copia global del archivo de control de sitio, que no tiene protección contra las aplicaciones que sobrescriben los datos de las demás.

Consulta también

Cómo agregar un calificador de contexto de Configuration Manager mediante código administradoCómo agregar un calificador de contexto de Configuration Manager mediante WMIAspectos básicos del proveedor de SMS