Távoli eszközök engedélyezése és letiltása

Cikk
2023-04-04

A távoli eszközök ügyfélügynökét a helyvezérlő fájl beállításainak módosításával engedélyezheti vagy tilthatja le a Configuration Manager.

A Távoli eszközök ügyfélügynök engedélyezése vagy letiltása

Állítson be egy kapcsolatot az SMS-szolgáltatóval.
Létesítsen 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éldametódus engedélyezi vagy letiltja a Távoli eszközök ügyfélügynököt a SMS_SCI_ClientComp osztály használatával a 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 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;  
    }  

}

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

Paraméter	Típus	Leírás
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.
`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

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: