10/17/2008

The Get-MDMDeviceHistorycmdlet returns the complete set of transaction information for the specified managed Windows Mobile device from the server operations log file.

The HistoryDurationparameter of the Set-DeviceManagementConfigcmdlet determines the amount of data returned by this cmdlet.

Syntax

Get-MDMDeviceHistory [-DeviceId] <DeviceIdParameter[]>
[-Force] [<CommonParameters>]

Get-MDMDeviceHistory -Owner <OwnerIdParameter[]> [-Force]
[<CommonParameters>]

Parameters

The following describes the Get-MDMDeviceHistorycmdlet parameters.

DeviceId <DeviceIdParameter[]>

Identifies one or more managed devices for which to return history data. If you specify multiple managed devices, a prompt displays to ask whether you want information for all the devices. You can suppress this prompt with the Forceparameter. This parameter can be a device common name, the distinguished name, the fully qualified domain name (FQDN), or the security ID (SID). If the value contains a space or other special characters, enclose the string in quotation marks.

Owner <OwnerIdParameter[]>

Identifies all managed devices for the specified owner and returns history data for those devices. If the cmdlet finds multiple managed devices for this owner, a prompt displays to ask whether you want information for all the devices. You can suppress this prompt with the Forceparameter. The Ownerparameter can be a common name, e-mail address, distinguished name, SID, or Logon ID. If the value contains a space or other special characters, enclose the string in quotation marks.

Force

Suppresses the prompt that displays when the cmdlet finds multiple managed devices.

CommonParameters

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

Input Type

The Get-MDMDeviceHistorycmdlet accepts a string through the pipeline that identifies a managed device, or an object that has the property, deviceId.

Output Type

The Get-MDMDeviceHistorycmdlet returns a collection of MDMDeviceHistoryobjects. To see all the properties for this object, at the MDM Shell prompt, type Get-MDMDeviceHistory | Get-Member.

Examples

This Get-MDMDeviceHistorycommand example returns the history information for the managed devices, 12127312 and 12127313.

Copy Code
C:\PS>Get-MDMDeviceHistory -DeviceID 12127312,12127313

Cmdlet Help

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

get-help Get-MDMDeviceHistory -detailed, or get-help Get-MDMDeviceHistory -full

See Also