Yönetilen Kod Kullanarak Configuration Manager Bir SMS Sağlayıcısına Bağlanma

Makale
04/04/2023

SMS Sağlayıcısına bağlanmak için WqlConnectionManager.Connect'i kullanın. Bağlandıktan sonra WqlConnectionManager.Connect'in Windows Yönetim Araçları (WMI) nesnelerini sorgulamak, oluşturmak, silmek ve Configuration Manager kullanmak için yöntemleri vardır.

Not

WqlConnectionManager.Connect , ConnectionManagerBase'in WMI'ye özgü bir türetme işlemidir.

Yerel bir SMS Sağlayıcısına bağlanıyorsanız, kullanıcı kimlik bilgilerini sağlamazsınız. Uzak bir SMS Sağlayıcısına bağlanıyorsanız, geçerli kullanıcı/bilgisayar bağlamı uzak SMS Sağlayıcısı üzerinde izinlere sahipse kullanıcı kimlik bilgilerini sağlamanız gerekmez.

Uzak SMS Sağlayıcısı'nda erişim ayrıcalıklarınız yoksa veya farklı bir kullanıcı hesabı kullanmak istiyorsanız, erişim ayrıcalıklarına sahip bir kullanıcı hesabı için kullanıcı kimlik bilgilerini sağlamanız gerekir.

WQLConnectionManager.Connection bir SmsNamedValuesDictionary nesnesi gerektirir. Bu, bilgisayar adı gibi önbelleğe alınmış bilgileri depolamak için kullanılabilir.

Uygulamanızda kullanılabilecek birçok değerle önceden doldurulur.

Değer	Açıklama.
ProviderLocation	Sağlayıcı konumu. Örneğin, \\<ComputerName>\ROOT\sms:SMS_ProviderLocation.SiteCode="XXX".
ProviderMachineName	Sağlayıcı bilgisayar. Örneğin, \\ComputerName.
Bağlantı	Bağlantı yolu. Örneğin, \\ComputerName\root\sms\site_XXX.
ConnectedSiteCode	Bağlantının bağlı olduğu Configuration Manager sitesinin site kodu. Örneğin, XXX.
Sunucuadı	Bilgisayar adı, örneğin, COMPUTERNAME.
Sitename	Configuration Manager site kodu. Örneğin, Merkezi Site.
ConnectedServerVersion	Bağlı sunucunun sürümü. Örneğin, 4.00.5830.0000
BuildNumber	Configuration Manager yükleme derleme numarası. Örneğin, 5830.

Not

SmsNamedValuesDictionary nesnesi, sağlayıcıya geçirilen bağlam niteleyicisi bilgileri değildir. Daha fazla bilgi için bkz. Yönetilen Kod Kullanarak Configuration Manager Bağlam Niteleyicisi Ekleme.

SMS Sağlayıcısına bağlanmak için

SmsNamedValuesDictionaryObject oluşturun.
WqlConnectionManager sınıfının bir örneğini oluşturun ve sunucu adını geçiren [Connect] yöntemini ve sunucu adı uzaksa kullanıcı adı ve parolayı çağırın.
Sağlayıcıya bağlanmak için WqlConnectionManager nesnesini kullanın.

Örnek

Aşağıdaki örnek yöntem, yerel veya uzak bir bilgisayardaki SMS Sağlayıcısına bağlanır. Uzaksa servername yöntemi, uzak bilgisayara bağlanmak için sağlanan kullanıcı adını ve parolayı kullanır. Uzak bağlantı için geçerli kullanıcı bağlamını kullanmak istiyorsanız, kodu kullanıcı adını ve parolasını geçirmemesi için değiştirin. Bağlantı başarılı olursa bir WqlConnectionManager nesnesi döndürülür.

Örnek kodu çağırma hakkında bilgi için bkz. Configuration Manager Kod Parçacıklarını Çağırma.

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

Kodu Derleme

Ad alanları

Sistem

System.Collections.Generic

System.ComponentModel

Microsoft.ConfigurationManagement.ManagementProvider

Microsoft.ConfigurationManagement.ManagementProvider.WqlQueryEngine

Microsoft.ManagementConsole

Derleme

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

Microsoft.ManagementConsole

Sağlam Programlama

Oluşturulabilecek Configuration Manager özel durumlar SmsConnectionException ve SmsQueryException'dır. Bunlar SmsException ile birlikte yakalanabilir.

.NET Framework Güvenliği

WqlConnectionManager.Connect'e yanlış kimlik bilgileri geçirildiğinde UnauthorizedAccessException tetiklenir.

Ayrıca Bkz

SMS Sağlayıcısı temelleri Yönetilen Kod Kullanarak Configuration Manager Bağlam Niteleyicisi Ekleme
Nesnelere genel bakış

Aracılığıyla paylaş