10/17/2008

The Get-MDMDeviceRecoveryPasswordcmdlet 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 Passwordmust be enabled on the device with using MDM Serverselected, and additional software must be installed on the device. For more information, see "Configure Password Recovery in MDM" in the MDM Technical Library on TechNet .

Syntax 

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

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

Parameters

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

Output Type

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

Examples

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

Copy Code 
C:\PS>Get-MDMDeviceRecoveryPassword -DeviceId device1

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

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

See Also