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