Távoli eszközök beállításainak konfigurálása

Cikk
2023-04-04

A Configuration Manager a távoli eszközök ügyfélügynökének beállításait a szükséges helyvezérlő fájlbeállítások módosításával adhatja meg.

A Távoli eszközök beállításainak konfigurálása

Állítson be egy kapcsolatot az SMS-szolgáltatóval.
Hozzon létre kapcsolatot a helyvezérlő fájl Távoli eszközök ügyfélügynök szakaszával a SMS_SCI_ClientComp osztály használatával.
Végighalad az elérhető tulajdonságok tömbjén, és szükség szerint módosításokat hajt végre.
Véglegesítse a webhelyvezérlő fájl módosításait.

Példa

Az alábbi példa a távoli eszközök ügyfélügynökének beállításait állítja be a osztály használatával a SMS_SCI_ClientComp helyvezérlő fájlhoz való csatlakozáshoz és a tulajdonságok módosításához.

A mintakód meghívásával kapcsolatos információkért lásd: Configuration Manager Kódrészletek hívása.


Sub ConfigureRemoteControlClientAgentSettings(swbemServices,            _  
                                              swbemContext,             _  
                                              siteCode,                 _  
                                              enableDisableClientAgent, _  
                                              newPermissionRequired,    _   
                                              newVisibleSignal,         _  
                                              newAudibleSignal)  

    ' Load the site control file and get the remote tools client agent section.  
    swbemServices.ExecMethod "SMS_SiteControlFile.Filetype=1,Sitecode=""" & siteCode & """", "Refresh", , , swbemContext  

    Query = "SELECT * FROM SMS_SCI_ClientComp " & _  
    "WHERE ClientComponentName = 'Remote Control' " & _  
    "AND SiteCode = '" & siteCode & "'"            

    Set SCIComponentSet = swbemServices.ExecQuery(Query, ,wbemFlagForwardOnly Or wbemFlagReturnImmediately, swbemContext)  

    ' Only one instance is returned from the query.  
    For Each SCIComponent In SCIComponentSet  

        ' Set the client agent by setting the Flags value to 0 or 1 using the enableDisableClientAgent variable.  
        wscript.echo " "  
        wscript.echo "Remote Control Agent"  
        wscript.echo "Current value " &  SCIComponent.Flags  

        ' Modify the value.                  
        SCIComponent.Flags = enableDisableClientAgent  
        wscript.echo "New value " & enableDisableClientAgent  

        ' Loop through the array of embedded SMS_EmbeddedProperty instances.  
        For Each vProperty In SCIComponent.Props  

            ' Setting: Permission Required  
            If vProperty.PropertyName = "Permission Required" Then  
                wscript.echo " "  
                wscript.echo vProperty.PropertyName  
                wscript.echo "Current value " &  vProperty.Value                 

                'Modify the value.  
                vProperty.Value = newPermissionRequired  
                wscript.echo "New value " & newPermissionRequired  
            End If  

            ' Setting: Visible Signal  
            If vProperty.PropertyName = "Visible Signal" Then  
                wscript.echo " "  
                wscript.echo vProperty.PropertyName  
                wscript.echo "Current value " &  vProperty.Value                 

                ' Modify the value.  
                vProperty.Value = newVisibleSignal  
                wscript.echo "New value " & newVisibleSignal  
            End If  

            ' Setting: Audible Signal  
            If vProperty.PropertyName = "Audible Signal" Then  
                wscript.echo " "  
                wscript.echo vProperty.PropertyName  
                wscript.echo "Current value " &  vProperty.Value                 

                ' Modify the value.  
                vProperty.Value = newAudibleSignal  
                wscript.echo "New value " & newAudibleSignal  
            End If  

        Next     

             ' Update the component in your copy of the site control file. Get the path  
             ' to the updated object, which could be used later to retrieve the instance.  
             Set SCICompPath = SCIComponent.Put_(wbemChangeFlagUpdateOnly, swbemContext)  
    Next  

    'Commit the change to the actual site control file.  
    Set InParams = swbemServices.Get("SMS_SiteControlFile").Methods_("CommitSCF").InParameters.SpawnInstance_  
    InParams.SiteCode = siteCode  
    swbemServices.ExecMethod "SMS_SiteControlFile", "CommitSCF", InParams, , swbemContext  

End Sub


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

        // Setting: Enable Remote Control Client Agent  
        // Set Remote Control client agent by setting flags value to  0 or 1 using the EnableDisableRemoteControlClientAgent variable.   
        Console.WriteLine();  
        Console.WriteLine("Remote Control Client Agent");  
        Console.WriteLine("Current value: " + siteDefinition["Flags"].StringValue);  

        // Change value using the enableDisableRemoteControlClientAgent value passed in.   
        siteDefinition["Flags"].StringValue = enableDisableRemoteControlClientAgent;  
        Console.WriteLine("New value    : " + enableDisableRemoteControlClientAgent);  

        foreach (KeyValuePair<string, IResultObject> kvp in siteDefinition.EmbeddedProperties)  
        {  

            // Create temporary working copy of embedded properties.  
            Dictionary<string, IResultObject> embeddedProperties = siteDefinition.EmbeddedProperties;  

            // Setting: Permission Required.  
            if (kvp.Value.PropertyList["PropertyName"] == "Permission Required")  
            {  
                Console.WriteLine();  
                Console.WriteLine(kvp.Value.PropertyList["PropertyName"]);  
                Console.WriteLine("Current value: " + embeddedProperties[kvp.Value.PropertyList["PropertyName"]]["Value"].StringValue);  

                // Change value using the newPermissionRequired value passed in.   
                embeddedProperties[kvp.Value.PropertyList["PropertyName"]]["Value"].StringValue = newPermissionRequired;  
                Console.WriteLine("New value    : " + newPermissionRequired);  
            }  

            // Setting: Visible Signal.  
            if (kvp.Value.PropertyList["PropertyName"] == "Visible Signal")  
            {  
                Console.WriteLine();  
                Console.WriteLine(kvp.Value.PropertyList["PropertyName"]);  
                Console.WriteLine("Current value: " + embeddedProperties[kvp.Value.PropertyList["PropertyName"]]["Value"].StringValue);  

                // Change value using the newScanSchedule value passed in.   
                embeddedProperties[kvp.Value.PropertyList["PropertyName"]]["Value"].StringValue = newVisibleSignal;  
                Console.WriteLine("New value    : " + newVisibleSignal);  
            }  

            // Setting: Audible Signal.  
            if (kvp.Value.PropertyList["PropertyName"] == "Audible Signal")  
            {  
                Console.WriteLine();  
                Console.WriteLine(kvp.Value.PropertyList["PropertyName"]);  
                Console.WriteLine("Current value: " + embeddedProperties[kvp.Value.PropertyList["PropertyName"]]["Value"].StringValue);  

                // Change value using the newAudibleSignal value passed in.   
                embeddedProperties[kvp.Value.PropertyList["PropertyName"]]["Value"].StringValue = newAudibleSignal;  
                Console.WriteLine("New value    : " + newAudibleSignal);  
            }  

            // Store the settings that have changed.  
            siteDefinition.EmbeddedProperties = embeddedProperties;  
        }  

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

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

A példametódus a következő paraméterekkel rendelkezik:

Paraméter	Típus	Leírás
`connection` `swbemServices`	-Kezelt: `WqlConnectionManager` - VBScript: SWbemServices	Érvényes kapcsolat az SMS-szolgáltatóval.
`swbemContext`	-Vbscript: `SWbemContext`	Érvényes környezeti objektum. További információ: Configuration Manager környezeti minősítő hozzáadása WMI használatával.
`siteCode`	-Kezelt: `String` -Vbscript: `String`	A helykód.
-Kezelt: `enableDisableRemoteControlClientAgent` -Vbscript: `enableDisableClientAgent`	-Kezelt: `String` -Vbscript: `String`	Meghatározza, hogy a Távoli eszközök ügyfélügynök engedélyezve van-e vagy le van-e tiltva. 0 – letiltva 1 – engedélyezve
`newPermissionRequired`	-Kezelt: `String` -Vbscript: `String`	Meghatározza, hogy szükséges-e engedély a távvezérléshez. 0 – nem kötelező 1 – kötelező
`newVisibleSignal`	-Kezelt: `String` -Vbscript: `String`	Meghatározza, hogy a látható jel engedélyezve van-e vagy le van-e tiltva. 0 – letiltva 1 – engedélyezve
`newAudibleSignal`	-Kezelt: `String` -Vbscript: `String`	Meghatározza, hogy a hangjelzés engedélyezve van-e vagy le van-e tiltva. 0 – letiltva 1 – engedélyezve

A kód fordítása

Ehhez a C#-példához a következőre van szükség:

Névterek

Rendszer

System.Collections.Generic

System.Text

Microsoft.ConfigurationManagement.ManagementProvider

Microsoft.ConfigurationManagement.ManagementProvider.WqlQueryEngine

Összeszerelés

adminui.wqlqueryengine

microsoft.configurationmanagement.managementprovider

Robusztus programozás

A hibakezeléssel kapcsolatos további információkért lásd: A Configuration Manager hibák ismertetése.

.NET-keretrendszer Security

A Configuration Manager alkalmazások biztonságossá tételével kapcsolatos további információkért lásd: Configuration Manager szerepköralapú felügyelet.

Lásd még

Configuration Manager Software Development Kit
Tudnivalók a Configuration Manager webhelyvezérlő fájlról
Az Configuration Manager helyvezérlő fájl olvasása és írása felügyelt kód használatával
A Configuration Manager helyvezérlő fájl olvasása és írása WMI használatával
SMS_SCI_Component kiszolgálói WMI-osztály

Megosztás a következőn keresztül: