Qualificações de contexto do gestor de configuração

Artigo
08/14/2021

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

Código Gerido

Ao utilizar as bibliotecas geridas do Fornecedor de SMS, utilize a propriedade ConnectionManagerBase.Context para especificar os qualificadores de contexto. Para obter mais informações, consulte Como Adicionar uma Classificativa de Contexto do Gestor de Configuração utilizando código gerido.

VBScript

Ao utilizar o VBScript, utiliza o conjunto de interface SWBemNamedValue para especificar os qualificadores de contexto como uma coleção de objetos de valor nomeados. Para obter mais informações, consulte Como Adicionar uma Classificativa de Contexto do Gestor de Configuração utilizando o WMI.

Qualificações de contexto

A tabela a seguir contém os qualificadores de contexto (valores nomeados) que são utilizados pelo Fornecedor de SMS. A maioria dos qualificadores, por SessionHandle exemplo, são utilizados apenas com áreas funcionais específicas do Fornecedor de SMS; LocaleID MachineName mas, e ApplicationName são para uso da sua aplicação.

Qualificador de contexto	Description
`ApplicationName`	Identifica o pedido que fez a chamada.
`ContextHandle`	Identifica onde o Fornecedor DE SMS guardou os seus qualificadores de contexto em cache.
`InstanceCount`	Limita o número de casos devolvidos do ExecQuery e da CreateInstanceEnum.
`LimitToCollectionIDs`	Limita os resultados de uma consulta de recursos aos membros das coleções nomeadas.
`LocaleID`	Identifica a página de código a utilizar.
`MachineName`	Identifica qual o computador que está a executar a aplicação.
`QueryQualifiers`	Devolve as bandeiras bit SecurityVerbs quando executa consultas contra objetos seguros.
`SessionHandle`	Identifica a cópia do ficheiro de controlo do site da sua aplicação para o Gestor de Configuração.

ApplicationName

O ApplicationName qualificador de contexto é um valor de cadeia que identifica o nome da aplicação que fez a chamada. Deve especificar ApplicationName para a sua aplicação porque é usada para auditoria. Se não fornecer o nome da sua aplicação, é utilizado um valor de Desconhecido. Deve fornecer o ApplicationName valor quando ligar para qualquer um dos métodos de mensagem de elevação, como SMS_StatusMessage::RaiseErrorStatusMsg,ou a chamada falhará.

Tratamento de Contexto

O ContextHandle qualificador de contexto é um valor de cadeia que identifica onde o Fornecedor de SMS guardou os seus 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 que são transmitidos sobre a rede.

Crie o conjunto de valor SWBemNamEdValue.
Adicione as suas qualificações ao objeto de contexto. Para obter mais informações, consulte Como Adicionar uma Classificativa de Contexto do Gestor de Configuração utilizando o WMI.
Ligue para o método GetContextHandle para cache as suas qualificações no servidor. O Fornecedor DE SMS caches o objeto de contexto que passa como parâmetro do ExecMethod quando chama GetContextHandle.
Remova todas as qualificações do seu objeto de contexto.
Adicione o ContextHandle qualificador e valor ao seu objeto de contexto.
Passe o objeto de contexto em todas as chamadas para iWbemServices.

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

Nota

Depois de cache as suas qualificações de contexto, pode anular os seus valores em cache adicionando os mesmos qualificadores de contexto, com valores diferentes, ao seu objeto de contexto.

InstânciaCount

O InstanceCount qualificador de contexto é um valor inteiro que é usado para limitar o número de casos devolvidos dos métodos ExecQuery e CreateInstanceEnum. Define InstanceCount igual ao número máximo de casos que deseja devolvidos da consulta ou enumerador. Por exemplo, InstanceCount fixando 10 devoluções, no máximo, 10 instâncias.

LimitToCollectionIDs

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

O utilizador deve ter por exemplo a leitura das permissões de recursos para a recolha a que o recurso pertence. Deve utilizar a limitação da recolha quando o utilizador não tiver direitos de recurso de leitura de classe para cobranças; caso contrário, nenhum dado é devolvido. Para SMS 2.0 com o Service Pack 1 e versões posteriores, esta restrição aplica-se apenas às classes derivadas de SMS_Group.

Não pode utilizar esta qualificação quando consultar as coleções.

LocaleID

O LocaleID qualificador de contexto é um valor de corda que aceita um valor hexadecimal ou um valor decimal na forma MS\x, onde x é o ID local. Por exemplo, pode introduzir o valor inglês LocaleID como ms\0x0409 ou ms\1033. O Fornecedor de SMS apenas aceita LocaleID valores que utilizam o formato Microsoft. Pode encontrar uma lista de locale IDs IDs locais atribuídos pela Microsoft.

Se precisar do local para não-EUA. instalações, você pode obtê-lo a partir da propriedade classe WMI do SMS_Identification servidor. LocaleID

Nome da máquina

O MachineName qualificador de contexto é um valor de cadeia que identifica qual o computador que está a executar a aplicação. Deve especificar MachineName para a sua aplicação porque é usada para auditoria. Se não fornecer o nome do computador, é utilizado um valor de Desconhecido. Tem de fornecer o valor do Nome de Máquina quando ligar para qualquer um dos métodos de mensagem de elevação, como SMS_StatusMessage::RaiseRawStatusMsg,ou a chamada falhará.

QueryQualifiers

O QueryQualifiers qualificador de contexto é um valor Boolean que é usado para devolver as bandeiras bits SecurityVerbs quando executa consultas contra objetos seguros, tais como SMS_Site ou SMS_Package. Note que a QueryQualifiers utilização de objetos não protegidos gera um erro. Por predefinição, as bandeiras SecurityVerbs não são devolvidas com a consulta. Você deve criar esta qualificação e definir o seu valor para true se você quiser as bandeiras devolvidas. Não criar QueryQualifiers é o mesmo que definir o seu valor para false .

Tratamento de Sessão

O SessionHandle qualificador de contexto é um valor de corda que é devolvido como um parâmetro fora do método GetSessionHandle. O string é um GUID único que identifica a cópia da sua aplicação do ficheiro de controlo do site ao Gestor de Configuração. 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 sobreempundo os dados uns dos outros.