The New-WipeRequestcmdlet creates a new wipe request that deletes all content on the specified managed Windows Mobile device.
The wipe request is sent to the managed device as soon as possible. If the managed device is unreachable, the wipe request remains active until the managed device retrieves it or the wipe request fails or expires. When the device retrieves the wipe request, it formats the external storage card and restores the factory default settings on the device. After the wipe, the device can no longer connect to the network through Mobile Device Manager Gateway Server, it is no longer enrolled in MDM, and MDM no longer manages the device.
There can only be one outstanding wipe request per device.
New-WipeRequest [-DeviceId] <DeviceIdParameter> [-confirm] [-whatif] [<CommonParameters>] New-WipeRequest -Owner <OwnerIdParameter> [-confirm] [-whatif] [<CommonParameters>]
The following describes the New-WipeRequestcmdlet parameters.
- DeviceId <DeviceIdParameter>
Specifies the identity of the managed device to be wiped. 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 to be wiped based on the device owner. If multiple managed 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 New-WipeRequestcmdlet accepts a string through the pipeline that identifies a managed device or an object that has the property, deviceId.
The New-WipeRequestcmdlet returns a WipeRequestobject. To see all the properties for this object, at the MDM Shell prompt, type Get-WipeRequest | Get-Member.
This New-WipeRequestcommand example creates a wipe request for the managed device that has the deviceId, device1.
C:\PS>New-WipeRequest -DeviceId device1
This New-WipeRequestcommand example creates a wipe request for the managed device owned by Mikael Sandberg. If this owner has multiple devices, an error is returned and no devices are wiped.
C:\PS>New-WipeRequest -Owner "Mikael Sandberg"
To view this information online, at the MDM Shell prompt, type:
get-help New-WipeRequest -detailed, or get-help New-WipeRequest -full