Get-MDMDeviceHistory

2/9/2009

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

The HistoryDuration parameter of the Set-DeviceManagementConfig cmdlet 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-MDMDeviceHistory cmdlet 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 Force parameter. 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 Force parameter. The Owner parameter 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-MDMDeviceHistory cmdlet accepts a string through the pipeline that identifies a managed device, or an object that has the property, deviceId.

Output Type

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

Examples

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

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

Reference

Get-MDMDevice
Set-DeviceManagementConfig