Jak włączyć i wyłączyć narzędzia zdalne

Artykuł
2023-04-04

Agent klienta narzędzi zdalnych można włączyć lub wyłączyć w Configuration Manager, modyfikując ustawienia pliku kontroli lokacji.

Aby włączyć lub wyłączyć agenta klienta narzędzi zdalnych

Skonfiguruj połączenie z dostawcą programu SMS.
Nawiązywanie połączenia z sekcją Agent klienta narzędzi zdalnych w pliku kontroli lokacji przy użyciu klasy SMS_SCI_ClientComp .
Przeprowadź pętlę przez tablicę dostępnych właściwości, wprowadzając zmiany zgodnie z potrzebami.
Zatwierdź zmiany w pliku kontroli lokacji.

Przykład

Poniższa przykładowa metoda włącza lub wyłącza agenta klienta narzędzi zdalnych przy użyciu klasy SMS_SCI_ClientComp w celu nawiązania połączenia z plikiem kontroli lokacji i zmiany właściwości.

Aby uzyskać informacje na temat wywoływania przykładowego kodu, zobacz Wywoływanie fragmentów kodu 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;  
    }  

}

Przykładowa metoda ma następujące parametry:

Parametr	Wpisać	Opis
Parametr	Wpisać	Opis
`connection` `swbemServices`	-Zarządzane: `WqlConnectionManager` - VBScript: SWbemServices	Prawidłowe połączenie z dostawcą programu SMS.
`swbemContext`	-Vbscript: `SWbemContext`	Prawidłowy obiekt kontekstu. Aby uzyskać więcej informacji, zobacz How to Add a Configuration Manager Context Qualifier by Using WMI (Jak dodać kwalifikator kontekstu Configuration Manager przy użyciu usługi WMI).
`siteCode`	-Zarządzane: `String` -Vbscript: `String`	Kod witryny.
`enableDisableClientAgent`	-Zarządzane: `String` -Vbscript: `String`	Określa, czy agent klienta narzędzi zdalnych jest włączony, czy wyłączony. - 0 — wyłączone - 1 — włączone

Kompilowanie kodu

Ten przykład języka C# wymaga:

Obszary nazw

System

System.collections.generic

System.text

Microsoft.ConfigurationManagement.ManagementProvider

Microsoft.ConfigurationManagement.ManagementProvider.WqlQueryEngine

Zestawu

adminui.wqlqueryengine

microsoft.configurationmanagement.managementprovider

Niezawodne programowanie

Aby uzyskać więcej informacji na temat obsługi błędów, zobacz Informacje o błędach Configuration Manager.

zabezpieczenia .NET Framework

Aby uzyskać więcej informacji na temat zabezpieczania aplikacji Configuration Manager, zobacz Configuration Manager administracja oparta na rolach.

Zobacz też

zestaw Configuration Manager Software Development Kit
Informacje o pliku kontrolki lokacji Configuration Manager
Jak odczytywać i zapisywać w pliku kontroli lokacji Configuration Manager przy użyciu kodu zarządzanego
Jak odczytywać i zapisywać w pliku kontroli lokacji Configuration Manager przy użyciu usługi WMI
SMS_SCI_Component Server WMI Class

Udostępnij za pośrednictwem