11/11/2008

The Get-MDMDeviceStatuscmdlet returns status information for the specified managed Windows Mobile device.

If you specify a deviceId, the information for that managed device returns. If you specify an owner, information on all managed devices associated with that owner returns.

Syntax

Get-MDMDeviceStatus [[-DeviceId] <DeviceIdParameter[]>]
[<CommonParameters>]

Get-MDMDeviceStatus [-Owner <OwnerIdParameter[]>]
[<CommonParameters>]

Parameters

The following describes the Get-MDMDeviceStatuscmdlet parameters.

DeviceId <DeviceIdParameter[]>

Specifies the identity of the managed device. The device must be enrolled. This parameter can be a device common name, the distinguished name, the fully qualified domain name (FQDN), or the security ID (SID).

Owner <OwnerIdParameter[]>

Identifies all managed devices for the specified owner and returns the status for those devices. This parameter can be a common name, e-mail address, distinguished name, SID, or Logon ID.

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 Get-MDMDeviceStatuscmdlet accepts a string through the pipeline that identifies a managed device, or an object that has the deviceIdproperty.

Output Type

The Get-MDMDeviceStatuscmdlet returns an MDMDeviceStatusobject. To view all the properties for this object, at the MDM Shell prompt, type Get-MDMDeviceStatus | Get-Member.

Examples

This Get-MDMDeviceStatuscommand example returns the status of the managed device, Device1.

Copy Code
C:\PS>Get-MDMDeviceStatus -deviceid Device1

This Get-MDMDeviceStatuscommand example returns the status of all the managed devices associated with the owner, Mikael Sandberg.

Copy Code
C:\PS>Get-MDMDeviceStatus -owner "Mikael Sandberg"

Cmdlet Help

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

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

See Also

Reference

Get-MDMDevice