10/17/2008

The Update-MDMDeviceRecoveryPasswordcmdlet forces the specified managed Windows Mobile device to generate a new recovery password and send it to the server in the next two scheduled device management sessions.

This cmdlet is needed only to address device recovery password problems and does not need to be used under normal conditions. Normally, the device recovery password is created and sent to the server when the User Reset of PasswordGroup Policy setting is changed to Enabledwith using MDM Serverselected, or when a password reset operation is completed successfully.

Important:
To enable the password recovery functionality, the Group Policy setting User Reset of Passwordmust be enabled on the device with u sing 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 

Update-MDMDeviceRecoveryPassword [-DeviceId]
<DeviceIdParameter> [-confirm] [-whatif]
[<CommonParameters>]

Update-MDMDeviceRecoveryPassword -Owner <OwnerIdParameter>
[-confirm] [-whatif] [<CommonParameters>]

Parameters

The following describes the Update-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, then a new recovery password is created for each device. 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.

WhatIf

Informs you of what changes would be made if the action were to be performed (the cmdlet is not executed).

Confirm

Prompts you for confirmation before the cmdlet executes.

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

Output Type

None

Examples

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

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

This Update-MDMDeviceRecoveryPasswordcommand example updates the recovery passwords for all managed devices owned by Mikael Sandberg.

Copy Code 
C:\PS>Update-MDMDeviceRecoveryPassword -Owner "Mikael Sandberg"

Cmdlet Help

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

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

See Also