Remove-WipeRequest

2/9/2009

The Remove-WipeRequest cmdlet removes a wipe request for the specified managed Windows Mobile device if the wipe request is yet unprocessed.

If you specify a deviceId, the cmdlet removes the unprocessed wipe request for that managed device, if a wipe request exists. If you specify an owner, the cmdlet removes the unprocessed wipe request for the managed device associated with that owner.

The Remove-WipeRequest cmdlet removes a wipe request for a managed device if the request is pending, if the request is being retried, or if the request has expired or failed and the DisenrollUnsuccessful option of the wipe service is set to false. If the managed device has already received the wipe request, or if the enrollment for the device has been revoked, you can no longer remove the request. If no outstanding wipe request exists for the managed device, an error occurs.

Syntax

Remove-WipeRequest [-DeviceId] <DeviceIdParameter> [-confirm] [-whatif] [<CommonParameters>]

Remove-WipeRequest -Owner <OwnerIdParameter> [-confirm] [-whatif] [<CommonParameters>]

Parameters

The following describes the Remove-WipeRequest cmdlet parameters.

  • DeviceId <DeviceIdParameter>
    Identifies the wipe request by 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 the managed device based on the device owner and removes any unprocessed wipe requests for that device. If multiple devices are found for this owner, an error message is displayed. 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 Remove-WipeRequest 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 Remove-WipeRequest command example removes a device wipe request for the managed device that has the deviceId, device1.

C:\PS>Remove-WipeRequest -DeviceId device1

This Remove-WipeRequest command example removes a device wipe request for the managed device owned by Mikael Sandberg.

C:\PS>Remove-WipeRequest -Owner "Mikael Sandberg"

Cmdlet Help

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

get-help Remove-WipeRequest -detailed, or get-help Remove-WipeRequest -full

See Also

Reference

Get-WipeRequest
New-WipeRequest
Get-MDMDevice