Update-MDMDeviceRecoveryPassword

  • Article

2/9/2009

The Update-MDMDeviceRecoveryPassword cmdlet 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 Password Group Policy setting is changed to Enabled with using MDM Server selected, or when a password reset operation is completed successfully.

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

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

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

Parameters

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

Output Type

None

Examples

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

C:\PS>Update-MDMDeviceRecoveryPassword -DeviceId device1

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

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

Reference

Get-MDMDeviceRecoveryPassword
Update-MDMDeviceRecoveryPasswordEncryptionKey