Så här tillämpar du anpassade klientinställningar

Artikel
2023-04-04

I Configuration Manager använder du anpassade klientinställningar genom att skapa en instans av en klientkonfigurationsklass och sedan distribuera de anpassade klientinställningarna genom att skapa en instans av SMS_ClientSettingsAssignment klassen och associera instansen av klassen Klientkonfiguration och en målsamling.

Tillämpa anpassade klientinställningar

Konfigurera en anslutning till SMS-providern.
Skapa en instans av en klientkonfigurationsklass (till exempel används SMS_StateSystemConfig nedan).
Fyll i specifika anpassade klientagentinställningar.
Skapa en instans av SMS_ClientSettingsAssignment klassen.
Fyll i tilldelningsvärdena för klientinställningar. ClientSettingsID för att identifiera instansen av anpassade klientinställningar och CollectionID för att identifiera målsamlingen för distributionen av de anpassade klientinställningarna.

Exempel

I följande exempel tillämpas anpassade klientinställningar genom att skapa en instans av en klientkonfigurationsklass och sedan distribuera de anpassade klientinställningarna genom att skapa en instans av SMS_ClientSettingsAssignment klassen och associera instansen av klassen Klientkonfiguration och en målsamling.

Information om hur du anropar exempelkoden finns i Anropa Configuration Manager kodfragment.


public void ApplyCustomClientSettings(WqlConnectionManager connection,string targetCollectionID){
    try
    {
        // Create a new instance of specific client agent settings (in this case State Messaging)
        IResultObject newCustomClientAgentSettings = connection.CreateEmbeddedObjectInstance("SMS_StateSystemConfig");

        // Populate specific custom client agent settings
        newCustomClientAgentSettings["BulkSendInterval"].IntegerValue = 120;
        newCustomClientAgentSettings["BulkSendIntervalHigh"].IntegerValue = 5;
        newCustomClientAgentSettings["BulkSendIntervalLow"].IntegerValue = 30;

        // Create a new array list to hold the custom client agent settings object(s)
        List<IResultObject> tempAgentConfigurationsArray = new List<IResultObject>();

        // Add the custom client agent settings embedded object to the local array list
        tempAgentConfigurationsArray.Add(newCustomClientAgentSettings);

        // Create a new instance of SMS_ClientSettings
        IResultObject newClientSettings = connection.CreateInstance("SMS_ClientSettings");

        // Populate the client agent settings
        newClientSettings["Name"].StringValue = "Custom State Messaging Configuration";

        // Add the array of custom client agent settinsg object(s) to the AgentConfigurations property
        newClientSettings.SetArrayItems("AgentConfigurations", tempAgentConfigurationsArray);

        // Save and retrieve the new instance of SMS_ClientSettings
        newClientSettings.Put();
        newClientSettings.Get();

        // Get the SettingsID value of the new SMS_ClientSettings instance
        Int32 SettingsID = newClientSettings["SettingsID"].IntegerValue;

        // Create a new instance of SMS_ClientSettingsAssignment
        IResultObject newClientSettingsAssignment = connection.CreateInstance("SMS_ClientSettingsAssignment");

        // Populate the client settings assignment values
        // ClientSettingsID to identify the custom client settings
        // CollectionID to identify the target collection for the custom client settings
        newClientSettingsAssignment["ClientSettingsID"].IntegerValue = SettingsID;
        newClientSettingsAssignment["CollectionID"].StringValue = targetCollectionID;

        // Save the new instance of the client settings assignment.
        newClientSettingsAssignment.Put();
    }
    catch (SmsException ex)
    {
        Console.WriteLine("Failed. Error: " + ex.InnerException.Message);
    }
}

Exempelmetoden har följande parametrar:

Parameter	Typ	Beskrivning
`connection`	-Hanterade: `WqlConnectionManager`	En giltig anslutning till SMS-providern.
`targetCollectionID`	-Hanterade: `String`	Målsamlingen för distributionen av anpassade klientinställningar.

Kompilera koden

Det här C#-exemplet kräver:

Namnområden

System

System.Collections.Generic

System.Text

Microsoft. ConfigurationManagement.ManagementProvider

Microsoft. ConfigurationManagement.ManagementProvider.WqlQueryEngine

Församlingen

adminui.wqlqueryengine

microsoft.configurationmanagement.managementprovider

Robust programmering

Mer information om felhantering finns i Om Configuration Manager fel.

.NET Framework Säkerhet

Mer information om hur du skyddar Configuration Manager program finns i Configuration Manager rollbaserad administration.

Se även

Configuration Manager SDK
SMS_ClientSettingsAssignment, serverns WMI-klass

Dela via