11/11/2008

The Set-DeviceManagementConfigcmdlet sets the global device management configuration values.

Syntax

Set-DeviceManagementConfig [[-Instance]
<DeviceManagementConfig>] [-WhatIf] [-Confirm]
[<CommonParameters>]

Set-DeviceManagementConfig [-ConnectInterval <TimeSpan>]
[-HistoryDuration <TimeSpan>] [-OMASessionTimeout
<TimeSpan>] [-WhatIf] [-Confirm] [<CommonParameters>]

Parameters

The following describes the Set-DeviceManagementConfigcmdlet parameters.

Instance <DeviceManagementConfig>

Accepts a DeviceManagementConfigobject as input.

ConnectInterval <TimeSpan>

Global device connect interval specified as a .NET TimeSpanobject. The minimum value is one minute. The default value is 8 hours.

HistoryDuration <TimeSpan>

The period, specified as a .NET TimeSpanobject, to keep device history data for reporting. The value may range from 0 to 30 days. The default value is 7 days.

OMASessionTimeout <TimeSpan>

Device management (DM) session time-out value, specified as a .NET TimeSpanobject, for Mobile Device Manager (MDM) Device Management Server. The value may range from 10 seconds to 20 minutes. The default value is 8 minutes.

WhatIf

Informs you of what changes would be made if the action were to be performed (the cmdlet is not executed).

Confirm

Prompts you for confirmation before the cmdlet executes.

CommonParameters

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, and -OutVariable. For more information, at the Mobile Device Manager (MDM) Shell prompt, type get-help about_commonparameters.

Input Type

The Set-DeviceManagementConfigcmdlet accepts a DeviceManagementConfigobject. To see all the properties for this object, at the MDM Shell prompt type, Get-DeviceManagementConfig | Get-Member.

Output Type

None

Examples

This Set-DeviceManagementConfigcommand example uses the TimeSpanobject string to set the ConnectIntervalperiod to eight hours.

Copy Code
C:\PS>Set-DeviceManagementConfig -ConnectInterval "08:00:00"

This Set-DeviceManagementConfigcommand example uses the New-TimeSpancmdlet to set the ConnectIntervalperiod to eight hours.

Copy Code
C:\PS>Set-DeviceManagementConfig -ConnectInterval (New-TimeSpan
-hours 8)

This sequence of commands uses Get-DeviceManagementConfigtogether with Set-DeviceManagementConfigto change the ConnectIntervalperiod to 10 hours.

Copy Code
C:\PS>$a = Get-DeviceManagementConfig 
C:\PS>$a.ConnectInterval = New-TimeSpan -hours 10 
C:\PS>Set-DeviceManagementConfig $a

Cmdlet Help

To view this information online, at the MDM Shell prompt, type:

get-help Set-DeviceManagementConfig -detailed, or get-help Set-DeviceManagementConfig -full

See Also