10/17/2008

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

If you specify a device, the cmdlet returns information for that managed device. If you specify an owner, the cmdlet returns information on all managed devices in the current MDM instance that are associated with the owner.

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. 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 the status for those devices. This 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.

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-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