Deleting System Defense Policies

Supported Intel AMT Features > System Defense > Using the System Defense API > Deleting System Defense Policies

Deleting System Defense Policies

When using the HLAPI, the name of a System Defense policy is a key and must be unique. However, the Intel AMT device can also include System Defense policies created by third-party applications. This means that two policies can exist in the Intel AMT device with the same name. For this reason the HLAPI DeletePolicy method is overloaded with three options.

Examples

These C# examples show how to use the DeletePolicy method to delete System Defense policies from the Intel AMT device.

Deleting a policy by name

Use the DeletePolicy(policyName) option when you know that the Intel AMT device does not contain third-party policies. For example:

amt.SystemDefense.PolicyStore.DeletePolicy("myPolicy1")

Deleting a policy by ID

Use the DeletePolicy(policyID) option to delete a policy with the handle supplied in policyID. For example:

amt.SystemDefense.PolicyStore.DeletePolicy(policyID)

Deleting a policy by name (supports policies with identical names)

Use the DeletePolicy(policyName, forceDeleteAll) option when you suspect that the Intel AMT device might contain third-party policies. For example:

amt.SystemDefense.PolicyStore.DeletePolicy("myPolicy1",true)

Note:

The forceDeleteAll parameter enables you to define what will happen if the HLAPI encounters two policies in the Intel AMT device with the same name. Valid values:

• true – Delete all policies with the name supplied in the policyName parameter.

• false – If only one policy exists, delete the policy. If more than one policy exists with the name supplied in the policyName parameter, throw an exception.