Share via


Get-MDMDeviceStatus

2/9/2009

The Get-MDMDeviceStatus cmdlet 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-MDMDeviceStatus cmdlet 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-MDMDeviceStatus cmdlet accepts a string through the pipeline that identifies a managed device, or an object that has the deviceId property.

Output Type

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

Examples

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

C:\PS>Get-MDMDeviceStatus -DeviceId Device1

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

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