CollapseAll image

Storage: Remove an Application

A registered application can remove itself from the NVM. This operation removes only the given instance of the application (enterprise/vendor/application/UUID tuple).

1.  Register the application, as described in the Storage: Register Application, Perform Task, Unregister Application flow. You should have the session handle available.

2.  As part of  the “Perform Task” step, invoke AMT_ThirdPartyDataStorage.RemoveApplication with the session handle as an input parameter. As a result of this operation:

   The application and any blocks it owns are removed.

   The application is not removed from the FPACL list if it is a partner application.

   The application is removed from all permissions groups associated with storage blocks that are owned by other applications.

   The session handle is invalidated and should not be used in subsequent storage operations.

Click here for a snippet demonstrating this step

You can execute this snippet by inserting it into the execution template found here.

  

$thirdPartyDataStorageServiceRef =$wsmanConnectionObject.NewReference("SELECT * FROM AMT_ThirdPartyDataStorageService WHERE Name='Intel(r) AMT Third Party Data Storage Service'")

$inputObject =$thirdPartyDataStorageServiceRef.CreateMethodInput("RemoveApplication")

# $sessionHandle is the session handle returned by 'RegisterApplication' method.

$inputObject.SetProperty("SessionHandle",$sessionHandle.ToString())

$outputObject =$thirdPartyDataStorageServiceRef.InvokeMethod($inputObject)

$returnValue =$outputObject.GetProperty("ReturnValue")

 

 

3.  There is no need to unregister the application, since the session handle immediately becomes invalid once the application is removed.

Instance Diagram

Not applicable

Classes Used in This Flow

SDK Sample

If there is a sample demonstrating this flow, it is included in the SDK installation file. See SDK Installation Layout for details.

 

See Also:

   Storage Concepts and Objects

   Application Development Guidelines

   Examples of Using the Storage Feature

Copyright © 2006-2022, Intel Corporation. All rights reserved.