Поделиться через


Включение и отключение средств удаленной отладки

Вы включаете или отключаете агент клиента удаленных средств в Configuration Manager путем изменения параметров файла элемента управления сайтом.

Включение или отключение агента клиента удаленных инструментов

  1. Настройте подключение к поставщику SMS.

  2. Установите подключение к разделу агент клиента удаленных средств файла элемента управления сайтом с помощью класса SMS_SCI_ClientComp .

  3. Циклически просматривайте массив доступных свойств, при необходимости внося изменения.

  4. Зафиксируйте изменения в файле элемента управления сайтом.

Пример

В следующем примере метод включает или отключает агент клиента remote Tools с помощью класса SMS_SCI_ClientComp для подключения к файлу элемента управления сайта и изменения свойств.

Сведения о вызове примера кода см. в разделе Вызов фрагментов кода Configuration Manager.


Sub EnableDisableRemoteControlClientAgent(swbemServices,   _  
                                          swbemContext,    _  
                                          siteCode,    _  
                                          enableDisableClientAgent)  

    ' Load site control file and get client component section.  
    swbemServices.ExecMethod "SMS_SiteControlFile.Filetype=1,Sitecode=""" & siteCode & """", "Refresh", , , swbemContext  
    Set objSWbemInst = swbemServices.Get("SMS_SCI_ClientComp.Filetype=1,Itemtype='Client Component',Sitecode='" & siteCode & "',ItemName='Remote Control'", , swbemContext)  

    ' Display client agent settings before change.  
    Wscript.Echo " "  
    Wscript.Echo "Properties - Before Change"  
    Wscript.Echo "---------------------------"  
    Wscript.Echo objSWbemInst.ClientComponentName  
    Wscript.Echo objSWbemInst.Flags & " (0 = Disabled, 1 = Enabled)"  

    ' Set the client agent by setting the Flags value to 0 or 1 using the enableDisableClientAgent variable.  
    objSWbemInst.Flags = enableDisableClientAgent  

    ' Save the new client agent settings.  
    objSWbemInst.Put_ , swbemContext  
    swbemServices.ExecMethod "SMS_SiteControlFile.Filetype=1,Sitecode=""" & siteCode & """", "Commit", , , swbemContext  

    ' Refresh the in-memory copy of the site control file and get the client component section.  
    swbemServices.ExecMethod "SMS_SiteControlFile.Filetype=1,Sitecode=""" & siteCode & """", "Refresh", , , swbemContext  
    Set objSWbemInst = swbemServices.Get("SMS_SCI_ClientComp.Filetype=1,Itemtype='Client Component',Sitecode='" & siteCode & "',ItemName='Remote Control'", , swbemContext)  

    ' Display the client agent settings after the change.  
    Wscript.Echo " "  
    Wscript.Echo "Properties - After Change"  
    Wscript.Echo "---------------------------"  
    Wscript.Echo objSWbemInst.ClientComponentName  
    Wscript.Echo objSWbemInst.Flags & " (0 = Disabled, 1 = Enabled)"  

End Sub  


public void EnableDisableRemoteControlClientAgent(WqlConnectionManager connection,  
                                                  string siteCode,  
                                                  string enableDisableClientAgent)  
{  
    try  
    {  
        IResultObject siteDefinition = connection.GetInstance(@"SMS_SCI_ClientComp.FileType=1,ItemType='Client Component',SiteCode='" + siteCode + "',ItemName='Remote Control'");  

        // Display Remote Control client agent settings before changing the properties.  
        Console.WriteLine();  
        Console.WriteLine("Properties - Before Change");  
        Console.WriteLine("---------------------------");  
        Console.WriteLine(siteDefinition["ClientComponentName"].StringValue);  
        Console.WriteLine(siteDefinition["Flags"].StringValue + " (0 = Disabled, 1 = Enabled)");  

        // Set Remote Control client agent by setting "Flags" value to 0 or 1 by using the enableDisableClientAgent variable.  
        siteDefinition["Flags"].StringValue = enableDisableClientAgent;  

        // Save the settings.  
        siteDefinition.Put();  

        // Verify the change by reconnecting and getting the value again.  
        IResultObject siteDefinition2 = connection.GetInstance(@"SMS_SCI_ClientComp.FileType=1,ItemType='Client Component',SiteCode='" + siteCode + "',ItemName='Remote Control'");  

        // Display Remote Control client agent settings after changing the properties.  
        Console.WriteLine();  
        Console.WriteLine("Properties - After Change");  
        Console.WriteLine("--------------------------");  
        Console.WriteLine(siteDefinition2["ClientComponentName"].StringValue);  
        Console.WriteLine(siteDefinition2["Flags"].StringValue + " (0 = Disabled, 1 = Enabled)");  
    }  

    catch (SmsException ex)  
    {  
        Console.WriteLine("Failed. Error: " + ex.InnerException.Message);  
        throw;  
    }  

}  

Метод примера имеет следующие параметры:

Параметр Тип Описание
Параметр Тип Описание
connection

swbemServices
-Управляемых: WqlConnectionManager
— VBScript: SWbemServices
Допустимое подключение к поставщику SMS.
swbemContext -Vbscript: SWbemContext Допустимый объект контекста. Дополнительные сведения см. в статье Добавление квалификатора контекста Configuration Manager с помощью WMI.
siteCode -Управляемых: String
-Vbscript: String
Код сайта.
enableDisableClientAgent -Управляемых: String
-Vbscript: String
Определяет, включен или отключен агент клиента удаленных средств.

- 0 — отключено
- 1 — включено

Компиляция программы

Для этого примера на C# требуется следующее:

Пространства имен

System;

System.Collections.Generic;

System.Text

Microsoft.ConfigurationManagement.ManagementProvider

Microsoft.ConfigurationManagement.ManagementProvider.WqlQueryEngine

Assembly

adminui.wqlqueryengine

microsoft.configurationmanagement.managementprovider

Надежное программирование

Дополнительные сведения об обработке ошибок см. в разделе Сведения об ошибках Configuration Manager.

Безопасность .NET Framework

Дополнительные сведения о защите приложений Configuration Manager см. в статье Configuration Manager администрирование на основе ролей.

См. также

Пакет средств разработки программного обеспечения для Configuration Manager
Сведения о файле элемента управления сайтом Configuration Manager
Чтение и запись в файл управления сайтом Configuration Manager с помощью управляемого кода
Чтение и запись в файл элемента управления сайтом Configuration Manager с помощью WMI
Класс WMI сервера SMS_SCI_Component