calificadores de contexto de Configuration Manager

Artículo
04/04/2023

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

Código administrado

Cuando se usan las bibliotecas de proveedores de SMS administrados, se usa la propiedad ConnectionManagerBase.Context para especificar calificadores de contexto. Para obtener más información, vea Cómo agregar un calificador de contexto de Configuration Manager mediante código administrado.

VBScript

Cuando se usa VBScript, se usa la interfaz SWBemNamedValue establecida para especificar calificadores de contexto como una colección de objetos de valor con nombre. Para obtener más información, vea Cómo agregar un calificador de contexto de Configuration Manager mediante WMI.

Calificadores de contexto

La tabla siguiente contiene los calificadores de contexto (valores con nombre) que usa el proveedor de SMS. La mayoría de los calificadores, como SessionHandle, solo se usan con áreas funcionales específicas del proveedor de SMS; pero LocaleID, MachineNamey ApplicationName son para el uso de la aplicación.

Calificador de contexto	Descripción
`ApplicationName`	Identifica la aplicación que realizó la llamada.
`ContextHandle`	Identifica dónde el proveedor de SMS ha almacenado los calificadores de contexto almacenados en caché.
`InstanceCount`	Limita el número de instancias devueltas de ExecQuery y CreateInstanceEnum.
`LimitToCollectionIDs`	Limita los resultados de una consulta de recursos a los miembros de las colecciones con nombre.
`LocaleID`	Identifica la página de códigos que se va a usar.
`MachineName`	Identifica qué equipo ejecuta la aplicación.
`QueryQualifiers`	Devuelve las marcas de bits SecurityVerbs al ejecutar consultas en objetos protegidos.
`SessionHandle`	Identifica la copia de la aplicación del archivo de control de sitio para Configuration Manager.

ApplicationName

El ApplicationName calificador de contexto es un valor de cadena que identifica el nombre de la aplicación que realizó la llamada. Debe especificar ApplicationName para la aplicación porque se usa para la auditoría. Si no proporciona el nombre de la aplicación, se usa un valor de Unknown. Debe proporcionar el ApplicationName valor al llamar a cualquiera de los métodos de mensaje de estado de generación, como SMS_StatusMessage::RaiseErrorStatusMsg, o se producirá un error en la llamada.

ContextHandle

El ContextHandle calificador de contexto es un valor de cadena que identifica dónde el proveedor de SMS ha almacenado 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.

Cree el conjunto de valores SWBemNamedValue .
Agregue los calificadores al objeto de contexto. Para obtener más información, vea Cómo agregar un calificador de contexto de Configuration Manager mediante WMI.
Llame al método GetContextHandle para almacenar en caché los calificadores en el servidor. El proveedor de SMS almacena en caché el objeto de contexto que se pasa como parámetro de ExecMethod cuando se llama a GetContextHandle.
Quite todos los calificadores del objeto de contexto.
Agregue el calificador y el ContextHandle valor al objeto de contexto.
Pase 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, y cada uno de ellos proporciona información variable para la aplicación.

Nota:

Después de almacenar en caché los calificadores de contexto, puede invalidar los valores almacenados en caché agregando los mismos calificadores de contexto, con valores diferentes, al objeto de contexto.

InstanceCount

El InstanceCount calificador de contexto es un valor entero que se usa para limitar el número de instancias devueltas de los métodos ExecQuery y CreateInstanceEnum . InstanceCount Establezca igual al número máximo de instancias que desea que se devuelvan de la consulta o enumerador. Por ejemplo, establecer en InstanceCount 10 devuelve, 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. Use este calificador 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 usar la limitación de recopilación cuando el usuario no tenga derechos de recurso de lectura de clase para 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 se puede usar este calificador al consultar colecciones.

LocaleID

El LocaleID calificador de contexto es un valor de cadena que acepta un valor hexadecimal o un valor decimal con el formato 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 valores LocaleID que usan el formato Microsoft. Puede encontrar una lista de en Identificadores de locale IDsconfiguración regional asignados por Microsoft.

Si necesita la configuración regional para los estados que no son de EE. UU. instalaciones, puede obtenerla de la propiedad SMS_Identification ClaseLocaleID WMI de servidor.

Machinename

El MachineName calificador de contexto es un valor de cadena que identifica qué equipo ejecuta la aplicación. Debe especificar MachineName para la aplicación porque se usa para la auditoría. Si no proporciona el nombre del equipo, se usa un valor desconocido. Debe proporcionar el valor MachineName al llamar a cualquiera de los métodos de mensaje de estado de generació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 SecurityVerbs al ejecutar consultas en objetos protegidos, como SMS_Site o SMS_Package. Tenga en cuenta que el uso QueryQualifiers de cuando se consultan 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 true si desea que se devuelvan las marcas. No crear QueryQualifiers es lo mismo que establecer su valor en false.

SessionHandle

El SessionHandle calificador 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 de la aplicación del archivo de control de sitio para Configuration Manager. Debe usar este mecanismo para modificar el archivo de control de sitio y reducir las colisiones de datos con otras aplicaciones que modifican el archivo de control de sitio al mismo tiempo. Si no proporciona un SessionHandle valor, la aplicación modifica la copia global del archivo de control de sitio, que no tiene ninguna protección contra las aplicaciones que sobrescriben los datos del otro.