Como Ligar a um Fornecedor de SMS no Configuration Manager ao Utilizar o Código Gerido

Para ligar a um Fornecedor de SMS, utilize WqlConnectionManager.Ligação. Depois de ligado, WqlConnectionManager.Ligação tem métodos para consultar, criar, eliminar e utilizar objetos de instrumentos de gestão de Windows de configuração (WMI).

Se estiver a ligar-se a um Fornecedor de SMS local, não forneça credenciais de utilizador. Se estiver a ligar-se a um Fornecedor de SMS remoto, não necessitar de fornecer credenciais de utilizador se o atual contexto utilizador/computador tiver permissões no fornecedor de SMS remoto.

Se não tiver privilégios de acesso no fornecedor de SMS remoto, ou se pretender utilizar uma conta de utilizador diferente, então deve fornecer credenciais de utilizador para uma conta de utilizador que tenha privilégios de acesso.

WQLConnectionManager.Connection requer um objeto SmsNamedValuesDictionary. Isto pode ser usado para armazenar informações em cache, como o nome do computador.

É pré-povoado com uma série de valores que podem ser usados na sua aplicação.

Para ligar ao Fornecedor DE SMS

1. Criar um SmsNamedValuesDictionaryObject.

2. Crie uma instância da classe WqlConnectionManager e ligue para o método [Ligação] passando o nome do servidor, e se o nome do servidor for remoto, o nome de utilizador e a palavra-passe.

3. Utilize o objeto WqlConnectionManager para ligar ao fornecedor.

Exemplo

O método de exemplo a seguir liga-se ao Fornecedor DE SMS num computador local ou remoto. Se servername for remoto, o método utiliza o nome de utilizador e a palavra-passe fornecidos para se ligar ao computador remoto. Se pretender utilizar o contexto atual do utilizador, para a ligação remota, altere o código para que não passe o nome de utilizador e a palavra-passe. Se a ligação for bem sucedida, um objeto WqlConnectionManager é devolvido.

Para obter informações sobre a chamada do código de amostra, consulte o Código de Identificação do Gestor de Chamadas.

public WqlConnectionManager Connect(string serverName, string userName, string userPassword)  
{  
    try  
    {  
        SmsNamedValuesDictionary namedValues = new SmsNamedValuesDictionary();  
        WqlConnectionManager connection = new WqlConnectionManager(namedValues);  

        if (System.Net.Dns.GetHostName().ToUpper() == serverName.ToUpper())  
        {  
            // Connect to local computer.  
            connection.Connect(serverName);  
        }  
        else  
        {  
            // Connect to remote computer.  
            connection.Connect(serverName, userName, userPassword);  
        }  

        return connection;  
    }  
    catch (SmsException e)  
    {  
        Console.WriteLine("Failed to Connect. Error: " + e.Message);  
        return null;  
    }  
    catch (UnauthorizedAccessException e)  
    {  
        Console.WriteLine("Failed to authenticate. Error:" + e.Message);  
        return null;  
    }  
}  

A Compilar o Código

Espaços de nomes

Sistema

System.Collections.Generic

System.ComponentModel

Microsoft.ConfigurationManagement.ManagementProvider

Microsoft.ConfigurationManagement.ManagementProvider.WqlQueryEngine

Microsoft.ManagementConsole

Assemblagem

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

Microsoft.ManagementConsole

Programação Robusta

As exceções do Gestor de Configuração que podem ser levantadas são SmsConnectionException e SmsQueryException. Estes podem ser apanhados juntamente com o SmsException.

Segurança do .NET Framework

A Não AutorizadaAccessException é levantada quando as credenciais erradas são passadas para WqlConnectionManager.Ligação.

Consulte também

Os fundamentos do fornecedor de SMS como adicionar um qualificador de contexto de gestor de configuração usando código gerido
Objects overview (Descrição geral dos objetos)