Storage: Remove a Block's Permission Group

Intel AMT Features > Storage Administration and Operations > Use Cases > Storage: Remove a Block's Permission Group

Storage: Remove a Block’s Permission Group

If a permissions group is no longer needed, it can be removed.

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

2. Retrieve the block handle for the block of interest, as described in the Storage: Get the Block Handles for an Application flow.

3. Retrieve the permissions group handle of interest, as described in the Storage: Retrieve all Permission Groups Associated with a Block flow.

4. Remove the permissions group of interest by invoking AMT_ThirdPartyDataStorageService.RemovePermissionsGroup with the following input parameters:

Parameter	Description/Value
SessionHandle	The session handle.
BlockHandle	The handle of the block.
GroupHandle	The permissions group handle.

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("RemovePermissionsGroup")

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

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

# $blockHandle is the block handle returned by 'Create a block for the registered application' use case.

$inputObject.SetProperty("BlockHandle",$blockHandle.ToString())

# $groupHandle is the group handle returned by 'AddPermissionsGroup' method.

$inputObject.SetProperty("GroupHandle",$groupHandle.ToString())

$outputObject =$thirdPartyDataStorageServiceRef.InvokeMethod($inputObject)

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

5. Unregister the application when done. See Storage: Register Application, Perform Task, Unregister Application.

Instance Diagram

Not applicable

Classes Used in This Flow

• AMT_ThirdPartyDataStorageService

SDK Sample

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