11/11/2008

The Remove-WipeRequestcmdlet 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-WipeRequestcmdlet 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 DisenrollUnsuccessfuloption 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> [-WhatIf]
[-Confirm] [<CommonParameters>]

Remove-WipeRequest -Owner <OwnerIdParameter> [-WhatIf]
[-Confirm] [<CommonParameters>]

Parameters

The following describes the Remove-WipeRequestcmdlet 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).

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.

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 Mobile Device Manager (MDM) Shell prompt, type get-help about_commonparameters.

Input Type

The Remove-WipeRequestcmdlet accepts a string through the pipeline that identifies a managed device or an object that has the deviceIdproperty.

Output Type

None

Examples

This Remove-WipeRequestcommand example removes a device wipe request for the managed device that has the deviceId, device1.

Copy Code 
C:\PS>Remove-WipeRequest -deviceId device1

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

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