MDM_RemoteWipe class

Article
09/18/2021

Note

Some information relates to pre-released product, which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

The MDM_RemoteWipe class allows a remote wipe of a device.

The following syntax is simplified from Managed Object Format (MOF) code and includes all of the inherited properties.

Syntax

[InPartition("local-system"), dynamic, provider("DMWmiBridgeProv")]
class MDM_RemoteWipe
{
  string InstanceID;
  string ParentID;
};

Members

The MDM_RemoteWipe class has these types of members:

Methods
Properties

Methods

The MDM_RemoteWipe class has these methods.

Method	Description
doWipeMethod	Triggers the device to start the remote wipe.
doWipePersistProvisionedDataMethod	Triggers the device to back up provisioning data to a persistent location, and perform a remote wipe on the device. The information that was backed up will be restored and applied to the device when it resumes.
doWipePersistUserDataMethod	Triggers the device to start the remote wipe while persisting user accounts and data.
doWipeProtectedMethod	Triggers the device to start the remote wipe on the device, and fully clean the internal drive. In some device configurations, this command might leave the device unable to boot.

Properties

The MDM_RemoteWipe class has these properties.

InstanceID

Data type: string
Access type: Read-only
Qualifiers: key

Identifies the name of the parent node. For this class, the string is "RemoteWipe".

ParentID

Data type: string
Access type: Read-only
Qualifiers: key

Describes the full path to the parent node. For this class, the string is "./Vendor/MSFT/"

Example

The following example demonstrates how to use the RemoteWipe and invoke the doWipeMethod.

Note

This example must be executed under local system user. To do that, download the psexec tool from https://technet.microsoft.com/sysinternals/bb897553.aspx and run psexec.exe -i -s cmd.exe from an elevated admin command prompt.

$namespaceName = "root\cimv2\mdm\dmmap"
$className = "MDM_RemoteWipe"
$methodName = "doWipeMethod"

$session = New-CimSession

$params = New-Object Microsoft.Management.Infrastructure.CimMethodParametersCollection
$param = [Microsoft.Management.Infrastructure.CimMethodParameter]::Create("param", "", "String", "In")
$params.Add($param)

try
{
    $instance = Get-CimInstance -Namespace $namespaceName -ClassName $className -Filter "ParentID='./Vendor/MSFT' and InstanceID='RemoteWipe'"
    $session.InvokeMethod($namespaceName, $instance, $methodName, $params)
}
catch [Exception]
{
    write-host $_ | out-string
}

Requirements

Requirement	Value
Minimum supported client	Windows 10 [desktop apps only]
Minimum supported server	None supported
Namespace	Root\CIMv2\MDM\DMMap
MOF	DMWmiBridgeProv.mof
DLL	DMWmiBridgeProv.dll