How to Configure Mobile Device Client Agent Settings
Applies To: System Center Configuration Manager 2007, System Center Configuration Manager 2007 R2, System Center Configuration Manager 2007 R3, System Center Configuration Manager 2007 SP1, System Center Configuration Manager 2007 SP2
You configure the Mobile Device Client Agent settings, in Microsoft System Center Configuration Manager 2007, by modifying the site control file.
To configure the Mobile Device Client Agent settings
Set up a connection to the SMS Provider.
Make a connection to the Device Client section of the site control file by using the SMS_SCI_ClientComp class.
Loop through the array of available properties, making changes as needed.
Commit the property changes to the site control file.
Example
The following example method configures various Mobile Device Client Agent settings by using the SMS_SCI_ClientComp class to connect to the site control file and change properties.
For information about calling the sample code, see Calling Configuration Manager Code Snippets.
Sub ConfigureMobileDeviceClientAgentSettings(swbemServices, _
swbemContext, _
siteCode, _
newPollIntervalMinutes, _
newPollIntervalHours, _
newFailureRetryCount, _
newFailureRetryIntervalMinutes, _
newFailureRetryIntervalHours, _
newEnableDisableSoftwareDistribution)
' Variables to build poll interval string.
' Note: The sample code only passes in minutes and hours, so setting empty values to use.
emptySeconds = "00"
emptyDays = "00"
emptyMonths = "00"
emptyYears = "0000"
' Build newPollInterval string (the format must be "0000-00-00 00:00:00").
newPollInterval = emptyYears & "-" & emptyMonths & "-" & emptyDays & " " & newPollIntervalHours & ":" & newPollIntervalMinutes & ":" & emptySeconds
newFailureRetryInterval = emptyYears & "-" & emptyMonths & "-" & emptyDays & " " & newFailureRetryIntervalHours & ":" & newFailureRetryIntervalMinutes & ":" & emptySeconds
' Load site control file and get the client component section.
swbemServices.ExecMethod "SMS_SiteControlFile.Filetype=1,Sitecode=""" & siteCode & """", "Refresh", , , swbemContext
Query = "SELECT * FROM SMS_SCI_ClientComp " & _
"WHERE ClientComponentName = 'Device Client' " & _
"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
' Loop through the array of embedded property instances.
For Each vProperty In SCIComponent.Props
' Setting: Poll Interval
If vProperty.PropertyName = "Poll Interval" Then
wscript.echo " "
wscript.echo vProperty.PropertyName
wscript.echo "Current value " & vProperty.Value2
'Modify the value.
vProperty.Value2 = newPollInterval
wscript.echo "New value " & newPollInterval
End If
' Setting: Failure Retry Count
If vProperty.PropertyName = "Failure Retry Count" Then
wscript.echo " "
wscript.echo vProperty.PropertyName
wscript.echo "Current value " & vProperty.Value
' Modify the value.
vProperty.Value = newFailureRetryCount
wscript.echo "New value " & newFailureRetryCount
End If
' Setting: Failure Retry Interval
If vProperty.PropertyName = "Failure Retry Interval" Then
wscript.echo " "
wscript.echo vProperty.PropertyName
wscript.echo "Current value " & vProperty.Value2
' Modify the value.
vProperty.Value2 = newFailureRetryInterval
wscript.echo "New value " & newFailureRetryInterval
End If
' Setting: Enable Software Dist
If vProperty.PropertyName = "Enable Software Dist" Then
wscript.echo " "
wscript.echo vProperty.PropertyName
wscript.echo "Current value " & vProperty.Value2
' Modify the value.
vProperty.Value2 = newEnableDisableSoftwareDistribution
wscript.echo "New value " & newEnableDisableSoftwareDistribution
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
' Release the copy of the site control file.
swbemServices.Get("SMS_SiteControlFile").ReleaseSessionHandle swbemContext.Item("SessionHandle").Value
End Sub
public void ConfigureMobileDeviceClientAgentSettings(WqlConnectionManager connection,
string siteCode,
string newPollIntervalMinutes,
string newPollIntervalHours,
string newFailureRetryCount,
string newFailureRetryIntervalMinutes,
string newFailureRetryIntervalHours,
bool newEnableDisableSoftwareDistribution)
{
// Define variables to build poll interval string.
// Note: The example code only passes in minutes and hours, so this sets empty values to use.
string emptyDays = "00";
string emptyMonths = "00";
string emptyYears = "0000";
string emptySeconds = "00";
// Build newPollInterval and newFailureRetryInterval strings (the format must be "0000-00-00 00:00:00").
string newPollInterval = emptyYears + "-" + emptyMonths + "-" + emptyDays + " " + newPollIntervalHours + ":" + newPollIntervalMinutes + ":" + emptySeconds;
string newFailureRetryInterval = emptyYears + "-" + emptyMonths + "-" + emptyDays + " " + newFailureRetryIntervalHours + ":" + newFailureRetryIntervalMinutes + ":" + emptySeconds;
try
{
IResultObject siteDefinition = connection.GetInstance(@"SMS_SCI_ClientComp.FileType=1,ItemType='Client Component',SiteCode='" + siteCode + "',ItemName='Device Client'");
// Loop through the array of embedded properties.
foreach (KeyValuePair<string, IResultObject> kvp in siteDefinition.EmbeddedProperties)
{
// Create temporary working copy of embedded properties.
Dictionary<string, IResultObject> embeddedProperties = siteDefinition.EmbeddedProperties;
// Setting: Poll Interval.
if (kvp.Value.PropertyList["PropertyName"] == "Poll Interval")
{
Console.WriteLine();
Console.WriteLine(kvp.Value.PropertyList["PropertyName"]);
Console.WriteLine("Current value: " + embeddedProperties[kvp.Value.PropertyList["PropertyName"]]["Value2"].StringValue);
// Change value using the newPollInterval value passed in.
embeddedProperties[kvp.Value.PropertyList["PropertyName"]]["Value2"].StringValue = newPollInterval;
Console.WriteLine("New value : " + newPollInterval);
}
// Setting: Failure Retry Count.
if (kvp.Value.PropertyList["PropertyName"] == "Failure Retry Count")
{
Console.WriteLine();
Console.WriteLine(kvp.Value.PropertyList["PropertyName"]);
Console.WriteLine("Current value: " + embeddedProperties[kvp.Value.PropertyList["PropertyName"]]["Value"].StringValue);
// Change value using the newFailureRetryCount value passed in.
embeddedProperties[kvp.Value.PropertyList["PropertyName"]]["Value"].StringValue = newFailureRetryCount;
Console.WriteLine("New value : " + newFailureRetryCount);
}
// Setting: Failure Retry Interval.
if (kvp.Value.PropertyList["PropertyName"] == "Failure Retry Interval")
{
Console.WriteLine();
Console.WriteLine(kvp.Value.PropertyList["PropertyName"]);
Console.WriteLine("Current value: " + embeddedProperties[kvp.Value.PropertyList["PropertyName"]]["Value2"].StringValue);
// Change value using the newFailureRetryInterval value passed in.
embeddedProperties[kvp.Value.PropertyList["PropertyName"]]["Value2"].StringValue = newFailureRetryInterval;
Console.WriteLine("New value : " + newFailureRetryInterval);
}
// Setting: Enable Software Dist.
if (kvp.Value.PropertyList["PropertyName"] == "Enable Software Dist")
{
Console.WriteLine();
Console.WriteLine(kvp.Value.PropertyList["PropertyName"]);
Console.WriteLine("Current value: " + embeddedProperties[kvp.Value.PropertyList["PropertyName"]]["Value2"].StringValue);
// Change value using the newEnableDisableSoftwareDistribution value passed in.
embeddedProperties[kvp.Value.PropertyList["PropertyName"]]["Value2"].BooleanValue = newEnableDisableSoftwareDistribution;
Console.WriteLine("New value : " + newEnableDisableSoftwareDistribution);
}
// 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;
}
}
The example method has the following parameters:
Parameter |
Type |
Description |
Connection |
|
A valid connection to the SMS Provider. |
siteCode |
|
The site code. |
newPollInterval |
|
The interval that the client tries to contact the server. The format of the string must be: Years-months-days hours:minutes:seconds "0000-00-00 00:00:00" |
newPollIntervalMinutes |
|
A value representing the minutes of the newPollInterval string. |
newPollIntervalHours |
|
A value representing the hours of the newPollInterval string. |
newFailureRetryCount |
|
A value representing the hours of the newPollInterval string. |
newFailureRetryIntervalMinutes |
|
A value representing the minutes of the newFailureRetryInterval string. |
newFailureRetryIntervalHours |
|
A value representing the hours of the newFailureInterval string. |
newEnableDisableSoftwareDistribution |
|
A value that enables or disables software distribution. Enabled = true Disabled = false |
Compiling the Code
This C# example requires:
Namespaces
System
System.Collections.Generic
System.Text
Microsoft.ConfigurationManagement.ManagementProvider
Microsoft.ConfigurationManagement.ManagementProvider.WqlQueryEngine
Assembly
adminui.wqlqueryengine
microsoft.configurationmanagement.managementprovider
Robust Programming
For more information about error handling, see About Configuration Manager Errors.
Security
For more information about securing Configuration Manager applications, see Securing Configuration Manager Applications.
See Also
Concepts
System Center Configuration Manager Software Development Kit
Configuration Manager Mobile Device Management
About Software Updates Setup and Configuration
About the Configuration Manager Site Control File
How to Read and Write to the Configuration Manager Site Control File by Using Managed Code
How to Read and Write to the Configuration Manager Site Control File by Using WMI
SMS_SCI_Component Server WMI Class