Csatlakozás SMS-szolgáltatóhoz Configuration Manager felügyelt kód használatával

Sms-szolgáltatóhoz való csatlakozáshoz használja a WqlConnectionManager.Connect parancsot. A csatlakozás után a WqlConnectionManager.Connect metódusokkal kérdezi le, hozza létre, törli és egyéb módon használja Configuration Manager Windows Management Instrumentation (WMI) objektumokat.

Megjegyzés:

A WqlConnectionManager.Connect a ConnectionManagerBase WMI-specifikus származtatása.

Ha helyi SMS-szolgáltatóhoz csatlakozik, nem adja meg a felhasználói hitelesítő adatokat. Ha távoli SMS-szolgáltatóhoz csatlakozik, nem kell megadnia a felhasználói hitelesítő adatokat, ha az aktuális felhasználói/számítógép-környezet rendelkezik engedélyekkel a távoli SMS-szolgáltatóhoz.

Ha nem rendelkezik hozzáférési jogosultságokkal a távoli SMS-szolgáltatón, vagy ha másik felhasználói fiókot szeretne használni, meg kell adnia a felhasználói hitelesítő adatokat egy hozzáférési jogosultságokkal rendelkező felhasználói fiókhoz.

A WQLConnectionManager.Connection használatához smsNamedValuesDictionary objektum szükséges. Ez a gyorsítótárazott információk, például a számítógép nevének tárolására használható.

Számos olyan értékkel van előre kitöltve, amelyek felhasználhatók az alkalmazásban.

Érték	Leírás.
ProviderLocation	A szolgáltató helye. Például, \\<ComputerName>\ROOT\sms:SMS_ProviderLocation.SiteCode="XXX".
ProviderMachineName	A szolgáltató számítógépe. Például: \\ComputerName.
Kapcsolat	A kapcsolat elérési útja. Például: \\ComputerName\root\sms\site_XXX.
ConnectedSiteCode	Annak a Configuration Manager helynek a helykódja, amelyhez a kapcsolat csatlakozik. Például: XXX.
Kiszolgálónév	A számítógép neve, például SZÁMÍTÓGÉPNÉV.
Webhelynév	A Configuration Manager helykódja. Például: Központi hely.
ConnectedServerVersion	A csatlakoztatott kiszolgáló verziója. Például: 4.00.5830.0000
BuildSzám	A Configuration Manager telepítési buildszáma. Például: 5830.

Megjegyzés:

Az SmsNamedValuesDictionary objektum nem a szolgáltatónak átadott környezeti minősítő információ. További információ: Configuration Manager környezeti minősítő hozzáadása felügyelt kód használatával.

Csatlakozás az SMS-szolgáltatóhoz

1. Hozzon létre egy SmsNamedValuesDictionaryObject objektumot.

2. Hozzon létre egy példányt a WqlConnectionManager osztályból, és hívja meg a [Connect] metódust a kiszolgálónév átadásával, és ha a kiszolgálónév távoli, a felhasználónevet és a jelszót.

3. A WqlConnectionManager objektummal csatlakozzon a szolgáltatóhoz.

Példa

Az alábbi példametódus egy helyi vagy távoli számítógépen csatlakozik az SMS-szolgáltatóhoz. Ha servername távoli, a metódus a megadott felhasználónevet és jelszót használja a távoli számítógéphez való csatlakozáshoz. Ha az aktuális felhasználói környezetet szeretné használni a távoli kapcsolathoz, módosítsa úgy a kódot, hogy az ne adja át a felhasználónevet és a jelszót. Ha a kapcsolat sikeres, a rendszer egy WqlConnectionManager objektumot ad vissza.

A mintakód meghívásával kapcsolatos információkért lásd: Configuration Manager Kódrészletek hívása.

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 kód fordítása

Névterek

Rendszer

System.Collections.Generic

System.ComponentModel

Microsoft.ConfigurationManagement.ManagementProvider

Microsoft.ConfigurationManagement.ManagementProvider.WqlQueryEngine

Microsoft.ManagementConsole

Összeszerelés

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

Microsoft.ManagementConsole

Robusztus programozás

A Configuration Manager kivételek az SmsConnectionException és az SmsQueryException. Ezek az SmsException kivétellel együtt is elkaphatók.

.NET-keretrendszer Security

Az UnauthorizedAccessException kivétel akkor jön létre, ha a rendszer helytelen hitelesítő adatokat ad át a WqlConnectionManager.Connectnek.

Lásd még

Az SMS-szolgáltató alapjai– Configuration Manager környezeti minősítő hozzáadása felügyelt kód használatával
Objektumok áttekintése