Připojení k poskytovateli serveru SMS v Configuration Manager pomocí spravovaného kódu

Článek
04/04/2023

Pokud se chcete připojit k poskytovateli serveru SMS, použijte WqlConnectionManager.Connect. Po připojení má WqlConnectionManager.Connect metody pro dotazování, vytváření, odstraňování a jiné použití Configuration Manager objektů WMI (Windows Management Instrumentation).

Poznámka

WqlConnectionManager.Connect je odvození ConnectionManagerBase specifické pro rozhraní WMI.

Pokud se připojujete k místnímu poskytovateli serveru SMS, nezadáte přihlašovací údaje uživatele. Pokud se připojujete ke vzdálenému poskytovateli serveru SMS, nemusíte zadávat přihlašovací údaje uživatele, pokud má aktuální kontext uživatele nebo počítače oprávnění ke vzdálenému poskytovateli serveru SMS.

Pokud u vzdáleného poskytovatele serveru SMS nemáte přístupová oprávnění nebo pokud chcete použít jiný uživatelský účet, musíte zadat přihlašovací údaje uživatele pro uživatelský účet, který má přístupová oprávnění.

WQLConnectionManager.Connection vyžaduje objekt SmsNamedValuesDictionary . Můžete ho použít k ukládání informací uložených v mezipaměti, jako je název počítače.

Je předem vyplněný mnoha hodnotami, které se dají použít ve vaší aplikaci.

Hodnota	Popis.
ProviderLocation	Umístění poskytovatele. Například, \\<Název_>počítače\ROOT\sms:SMS_ProviderLocation.SiteCode="XXX".
ProviderMachineName	Počítač poskytovatele. Například \\Název_počítače.
Připojení	Cesta připojení. Například \\Název_počítače\root\sms\site_XXX.
ConnectedSiteCode	Kód lokality pro Configuration Manager lokalitu, ke které je připojení připojeno. Například XXX.
Název_serveru	Název počítače, například NÁZEV_POČÍTAČE.
Sitename	Kód lokality Configuration Manager. Například Centrální lokalita.
ConnectedServerVersion	Verze připojeného serveru. Například 4.00.5830.0000
Číslo buildu	Číslo buildu Configuration Manager instalace. Například 5830.

Poznámka

Objekt SmsNamedValuesDictionary není informace o kontextovém kvalifikátoru předané poskytovateli. Další informace najdete v tématu Přidání kvalifikátoru kontextu Configuration Manager pomocí spravovaného kódu.

Připojení k poskytovateli serveru SMS

Vytvořte SmsNamedValuesDictionaryObject.
Vytvořte instanci třídy WqlConnectionManager a zavolejte metodu [Connect] a předejte název serveru a pokud je název serveru vzdálený, uživatelské jméno a heslo.
Pro připojení k poskytovateli použijte objekt WqlConnectionManager .

Příklad

Následující příklad metoda se připojí k poskytovateli serveru SMS na místním nebo vzdáleném počítači. Pokud servername je metoda vzdálená, použije k připojení ke vzdálenému počítači zadané uživatelské jméno a heslo. Pokud chcete pro vzdálené připojení použít aktuální kontext uživatele, změňte kód tak, aby nepředál uživatelské jméno a heslo. Pokud je připojení úspěšné, vrátí se objekt WqlConnectionManager .

Informace o volání ukázkového kódu najdete v tématu Volání Configuration Manager fragmentů kódu.

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;  
    }  
}

Kompilace kódu

Obory názvů

Systému

System.collections.generic

System.componentmodel

Microsoft.ConfigurationManagement.ManagementProvider

Microsoft.ConfigurationManagement.ManagementProvider.WqlQueryEngine

Microsoft.ManagementConsole

Sestavení

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

Microsoft.ManagementConsole

Robustní programování

Výjimky Configuration Manager, které mohou být vyvolány, jsou SmsConnectionException a SmsQueryException. Ty se dají zachytit společně s postupem SmsException.

Zabezpečení rozhraní .NET Framework

Při předání nesprávných přihlašovacích údajů do WqlConnectionManager.Connect se vyvolá výjimka UnauthorizedAccessException.

Viz taky

Základní informace o poskytovateli serveru SMS : Přidání kontextového kvalifikátoru Configuration Manager pomocí spravovaného kódu
Přehled objektů

Sdílet prostřednictvím