Come abilitare e disabilitare strumenti remoti

È possibile abilitare o disabilitare l'agente client di Strumenti remoti, in Configuration Manager, modificando le impostazioni del file di controllo del sito.

Per abilitare o disabilitare l'agente client di Strumenti remoti

1. Configurare una connessione al provider SMS.

2. Stabilire una connessione alla sezione Remote Tools Client Agent del file di controllo del sito usando la classe SMS_SCI_ClientComp .

3. Scorrere la matrice di proprietà disponibili, apportando modifiche in base alle esigenze.

4. Eseguire il commit delle modifiche apportate al file di controllo del sito.

Esempio

Il metodo di esempio seguente abilita o disabilita l'agente client di Strumenti remoti usando la classe SMS_SCI_ClientComp per connettersi al file di controllo del sito e modificare le proprietà.

Per informazioni sulla chiamata del codice di esempio, vedere Chiamata di frammenti di codice 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;  
    }  

}  

Il metodo di esempio include i parametri seguenti:

Parametro	Tipo	Descrizione
Parametro	Tipo	Descrizione
connection swbemServices	-Gestito: WqlConnectionManager - VBScript: SWbemServices	Connessione valida al provider SMS.
swbemContext	-Vbscript: SWbemContext	Oggetto di contesto valido. Per altre informazioni, vedere Come aggiungere un qualificatore di contesto Configuration Manager usando WMI.
siteCode	-Gestito: String -Vbscript: String	Codice del sito.
enableDisableClientAgent	-Gestito: String -Vbscript: String	Determina se l'agente client di Strumenti remoti è abilitato o disabilitato. - 0 - Disabilitato - 1 - Abilitato

Compilazione del codice

Questo esempio C# richiede:

Namespaces

Sistema

System.collections.generic

System.Text

Microsoft.ConfigurationManagement.ManagementProvider

Microsoft.ConfigurationManagement.ManagementProvider.WqlQueryEngine

Assembly

adminui.wqlqueryengine

microsoft.configurationmanagement.managementprovider

Programmazione efficiente

Per altre informazioni sulla gestione degli errori, vedere Informazioni sugli errori di Configuration Manager.

Sicurezza di .NET Framework

Per altre informazioni sulla protezione delle applicazioni Configuration Manager, vedere Configuration Manager'amministrazione basata sui ruoli.

Vedere anche

Configuration Manager Software Development Kit
Informazioni sul file di controllo del sito Configuration Manager
Come leggere e scrivere nel file di controllo del sito Configuration Manager usando codice gestito
Come leggere e scrivere nel file di controllo del sito Configuration Manager tramite WMI
Classe WMI del server SMS_SCI_Component