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.
Remove-WipeRequest [-DeviceId] <DeviceIdParameter> [-confirm] [-whatif] [<CommonParameters>] Remove-WipeRequest -Owner <OwnerIdParameter> [-confirm] [-whatif] [<CommonParameters>]
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). 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.
Informs you of what changes would be made if the action were to be performed (the cmdlet is not executed).
Prompts you for confirmation before the cmdlet executes.
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.
The Remove-WipeRequestcmdlet accepts a string through the pipeline that identifies a managed device or an object that has the deviceIdproperty.
This Remove-WipeRequestcommand example removes a device wipe request for the managed device that has the deviceId, device1.
C:\PS>Remove-WipeRequest -DeviceId device1
This Remove-WipeRequestcommand example removes a device wipe request for the managed device owned by Mikael Sandberg.
C:\PS>Remove-WipeRequest -Owner "Mikael Sandberg"
To view this information online, at the MDM Shell prompt, type:
get-help Remove-WipeRequest -detailed, or get-help Remove-WipeRequest -full