Get-MDMDeviceRecoveryPassword

Article
02/10/2009

2/9/2009

The Get-MDMDeviceRecoveryPassword cmdlet returns the recovery password that corresponds to the specified Windows Mobile managed device. If a user forgets the device password, the recovery password may be used to unlock the device and reset the device password. The recovery password is a 20-character numeric string.

The device is not required to be connected to MDM Device Management Server during the password reset operation. When the password reset operation is completed successfully on the device, a new recovery password is generated and sent to MDM Device Management Server in a device management session. The previous recovery password may be used until the device management session begins.

Important

To enable the password recovery functionality, the Group Policy setting User Reset of Password must be enabled on the device with using MDM Server selected, and additional software must be installed on the device. For more information, see Configure Password Reset in MDM.

Syntax

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

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

Parameters

The following describes the Get-MDMDeviceRecoveryPassword cmdlet parameters.

DeviceId <DeviceIdParameter>
Specifies the identity of the managed device for which a recovery password is requested. 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 the managed device for which a recovery password is requested based on the device owner. If the cmdlet finds more than one managed device for this owner, an error message is returned. 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-MDMDeviceRecoveryPassword cmdlet accepts a string through the pipeline that identifies a managed device, or an object that has the deviceId property.

Output Type

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

Examples

This Get-MDMDeviceRecoveryPassword command example returns the recovery password for the managed device that has the deviceId, device1.

C:\PS>Get-MDMDeviceRecoveryPassword -DeviceId device1

This Get-MDMDeviceRecoveryPassword command example returns the recovery password for the managed device owned by Mikael Sandberg.

C:\PS>Get-MDMDeviceRecoveryPassword -Owner "Mikael Sandberg"

Cmdlet Help

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

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