Como adicionar um qualificador de contexto de Configuration Manager usando código gerenciado

  • Artigo

Em Configuration Manager, para adicionar um qualificador de contexto usando o Provedor de SMS gerenciado, use a propriedade Context que é um Dictionary objeto que contém qualificadores de contexto.

Normalmente, você adicionará o nome do aplicativo ao qualificador de contexto ApplicationName, juntamente com o nome do computador (MachineName) e o identificador Locale (LocaleID).

Para adicionar Configuration Manager qualificador de contexto

  1. Configure uma conexão com o Provedor de SMS. Para obter mais informações, consulte Como se conectar a um provedor de SMS em Configuration Manager usando código gerenciado

  2. Obtenha o objeto SmsNamedValuesDictionary do objeto WqlConnectionManager que você obtém da etapa 1.

  3. Adicione as qualificações de contexto conforme necessário.

Exemplo

O exemplo C# a seguir primeiro adiciona uma série de qualificadores de contexto a uma propriedade de dicionário de contexto do objeto WQLConnectionManager. Em seguida, ele exibe uma lista dos qualificadores de contexto no objeto dictionary.

Observação

WqlConnectionManager deriva de ConnectionManagerBase.

No exemplo, o LocaleID qualificador de contexto é codificado em inglês (EUA). Se você precisar da localidade para não-EUA. instalações, você pode obtê-lo na propriedade classe LocaleIDWMI do servidor SMS_Identification.

Para obter informações sobre como chamar o código de exemplo, consulte Chamando Configuration Manager Snippets de Código.

public void AddContextQualifiers(WqlConnectionManager connection)  
{  
    try  
    {  
        connection.Context.Add("ApplicationName", "My application name");  
        connection.Context.Add("MachineName","Computername");  
        connection.Context.Add("LocaleID", @"MS\1033");  

        foreach (KeyValuePair<string, object> namedValue in connection.Context)  
        {  
            Console.WriteLine(namedValue.Key);  
            Console.WriteLine(namedValue.Value);  
            Console.WriteLine();  
        }  
    }  
    catch (SmsException e)  
    {  
        Console.WriteLine("Failed to add context qualifier : " + e.Message);  
    }  
}

O método de exemplo tem os seguintes parâmetros:

Parâmetro Tipo Descrição
connection - WqlConnectionManager Uma conexão válida com o provedor de SMS.

Compilando o código

Namespaces

System

System.Collections.Generic

System.ComponentModel

Microsoft. ConfigurationManagement.ManagementProvider

Microsoft. ConfigurationManagement.ManagementProvider.WqlQueryEngine

Assembly

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

Programação robusta

As exceções Configuration Manager que podem ser geradas são SmsConnectionException e SmsQueryException. Elas podem ser capturadas junto com SmsException.

Confira também

Qualificadores de contexto Configuration Manager
Como se conectar a um provedor de Configuration Manager usando código gerenciado