Qualificadores de Contexto Configuration Manager

Artigo
03/04/2025

Os objetos de contexto são utilizados, no Configuration Manager, para fornecer informações adicionais ao Fornecedor de SMS. Normalmente, utiliza qualificadores de contexto para fornecer ao Fornecedor de SMS informações contextuais, como o nome da sua aplicação. Pode utilizar qualificadores de contexto quando se liga ao Fornecedor de SMS e a objetos individuais do Fornecedor de SMS.

Código gerenciado

Ao utilizar as bibliotecas do Fornecedor de SMS geridas, utilize a propriedade ConnectionManagerBase.Context para especificar qualificadores de contexto. Para obter mais informações, veja How to Add a Configuration Manager Context Qualifier by Using Managed Code (Como Adicionar um Qualificador de Contexto Configuration Manager Através do Código Gerido).

VBScript

Ao utilizar o VBScript, utiliza a interface SWBemNamedValue definida para especificar qualificadores de contexto como uma coleção de objetos de valor nomeado. Para obter mais informações, veja How to Add a Configuration Manager Context Qualifier by Using WMI (Como Adicionar um Qualificador de Contexto do Configuration Manager através da WMI).

Qualificadores de Contexto

A tabela seguinte contém os qualificadores de contexto (valores nomeados) que são utilizados pelo Fornecedor de SMS. A maioria dos qualificadores, como SessionHandle, só são utilizados com áreas funcionais específicas do Fornecedor de SMS, mas LocaleID, MachineNamee ApplicationName são para utilização da sua aplicação.

Qualificador de contexto	Descrição
`ApplicationName`	Identifica a aplicação que efetuou a chamada.
`ContextHandle`	Identifica onde o Fornecedor de SMS armazenou os qualificadores de contexto em cache.
`InstanceCount`	Limita o número de instâncias devolvidas de ExecQuery e CreateInstanceEnum.
`LimitToCollectionIDs`	Limita os resultados de uma consulta de recurso aos membros das coleções nomeadas.
`LocaleID`	Identifica a página de código a utilizar.
`MachineName`	Identifica o computador que está a executar a aplicação.
`QueryQualifiers`	Devolve os sinalizadores de bits SecurityVerbs quando executa consultas em objetos protegidos.
`SessionHandle`	Identifica a cópia da aplicação do ficheiro de controlo do site para Configuration Manager.

ApplicationName

O ApplicationName qualificador de contexto é um valor de cadeia que identifica o nome da aplicação que efetuou a chamada. Deve especificar ApplicationName para a sua aplicação porque é utilizada para auditoria. Se não fornecer o nome da sua aplicação, é utilizado um valor desconhecido. Tem de fornecer o ApplicationName valor quando chamar qualquer um dos métodos de mensagem de status de aumento, como SMS_StatusMessage::RaiseErrorStatusMsg ou a chamada falhará.

ContextHandle

O ContextHandle qualificador de contexto é um valor de cadeia que identifica onde o Fornecedor de SMS armazenou os qualificadores de contexto em cache. O Fornecedor de SMS gerido gere a transferência de dados. Ao utilizar o VBScript, pode utilizar os seguintes passos para reduzir a quantidade de dados transmitidos pela rede.

Crie o conjunto de valores SWBemNamedValue .
Adicione os qualificadores ao objeto de contexto. Para obter mais informações, veja How to Add a Configuration Manager Context Qualifier by Using WMI (Como Adicionar um Qualificador de Contexto do Configuration Manager através da WMI).
Chame o método GetContextHandle para colocar os qualificadores em cache no servidor. O Fornecedor de SMS coloca em cache o objeto de contexto que transmite como um parâmetro de ExecMethod quando chama GetContextHandle.
Remova todos os qualificadores do objeto de contexto.
Adicione o ContextHandle qualificador e o valor ao objeto de contexto.
Transmita o objeto de contexto em todas as chamadas para IWbemServices.

Tem de chamar o método ClearContextHandle para remover os qualificadores em cache antes de sair da aplicação. Pode criar quantos ContextHandle valores quiser, sendo que cada um fornece informações variadas para a sua aplicação.

Observação

Depois de colocar em cache os qualificadores de contexto, pode substituir os valores em cache ao adicionar os mesmos qualificadores de contexto, com valores diferentes, ao objeto de contexto.

InstanceCount

O InstanceCount qualificador de contexto é um valor inteiro que é utilizado para limitar o número de instâncias devolvidas dos métodos ExecQuery e CreateInstanceEnum . InstanceCount Define igual ao número máximo de instâncias que pretende que sejam devolvidas a partir da consulta ou enumerador. Por exemplo, definir InstanceCount como 10 devolve, no máximo, 10 instâncias.

LimitToCollectionIDs

O LimitToCollectionIDs qualificador de contexto é uma matriz de cadeia que contém uma lista de CollectionID valores. Atualmente, só pode especificar um CollectionID valor. Utilize este qualificador para limitar os resultados de uma consulta de recurso aos membros da coleção nomeada. Uma consulta de recurso é uma consulta que inclui classes derivadas de SMS_Resource ou SMS_Group.

O utilizador tem de ter permissões de recursos de leitura de instâncias para a coleção à qual o recurso pertence. Tem de utilizar a limitação da coleção quando o utilizador não tiver direitos de recurso de leitura de classe para coleções; caso contrário, não são devolvidos dados. Para o SMS 2.0 com o Service Pack 1 e versões posteriores, esta restrição aplica-se apenas a classes derivadas de SMS_Group.

Não pode utilizar este qualificador ao consultar coleções.

LocaleID

O LocaleID qualificador de contexto é um valor de cadeia que aceita um valor hexadecimal ou um valor decimal no formulário MS\x, em que x é o ID de região. Por exemplo, pode introduzir o valor inglês LocaleID como ms\0x0409 ou ms\1033. O Fornecedor de SMS só aceita LocaleID valores que utilizem o formato Microsoft. Pode encontrar uma lista de em IDs de locale IDsRegião Atribuídos pela Microsoft.

Se precisar da região para não E.U.A. instalações, pode obtê-la a partir da propriedade Classe LocaleIDWMI de Servidor SMS_Identification.

MachineName

O MachineName qualificador de contexto é um valor de cadeia que identifica o computador que está a executar a aplicação. Deve especificar MachineName para a sua aplicação porque é utilizada para auditoria. Se não fornecer o nome do computador, é utilizado um valor desconhecido. Tem de fornecer o valor MachineName quando chamar qualquer um dos métodos de mensagem de status de aumento, como SMS_StatusMessage::RaiseRawStatusMsg ou a chamada falhará.

QueryQualifiers

O QueryQualifiers qualificador de contexto é um valor booleano que é utilizado para devolver os sinalizadores de bits SecurityVerbs quando executa consultas em objetos protegidos, como SMS_Site ou SMS_Package. Tenha em atenção que utilizar QueryQualifiers ao consultar objetos não seguro gera um erro. Por predefinição, os sinalizadores SecurityVerbs não são devolvidos com a consulta. Tem de criar este qualificador e definir o respetivo valor como true se pretender que os sinalizadores sejam devolvidos. Não criar QueryQualifiers é o mesmo que definir o respetivo valor como false.

SessionHandle

O SessionHandle qualificador de contexto é um valor de cadeia que é devolvido como um parâmetro de saída do método GetSessionHandle. A cadeia é um GUID exclusivo que identifica a cópia da aplicação do ficheiro de controlo do site para Configuration Manager. Deve utilizar este mecanismo para modificar o ficheiro de controlo do site e reduzir as colisões de dados com outras aplicações que estão a modificar o ficheiro de controlo do site ao mesmo tempo. Se não fornecer um SessionHandle valor, a sua aplicação modifica a cópia global do ficheiro de controlo do site, que não tem proteção contra aplicações que substituem os dados uns dos outros.