Admin: Enumerate all Registered Applications

Intel AMT Features > Storage Administration and Operations > Use Cases > Admin: Enumerate all Registered Applications

Admin: Enumerate all Registered Applications

For display or lookup purposes, it is helpful to have a list of all registered applications. The following steps describe how to retrieve the application handles, and then the information associated with each entry.

1. Retrieve the instance of AMT_ThirdPartyDataStorageAdministrationService, where the “Name” key equals “Intel(r) AMT Third Party Data Storage Administration Service”.

2. Invoke AMT_ThirdPartyDataStorageAdministrationService.AdminGetRegisteredApplications to retrieve an array of application handles.

3. If you need information about each handle, use a loop over the array. For each handle, use AMT_ThirdPartyDataStorageService.AdminGetApplicationAttributes to retrieve the information.

• Pass the handle as an input parameter.

• As output parameters, the method returns the following:

Parameter	Description/Value
AttrType	The Attribute Type: Should always be 1.
UUID	The UUID associated with this instance of the application.
ApplicationName	The name of the application. 64 characters maximum.
Vendorname	The name of the vendor: 64 characters maximum.
EnterpriseName	The name of the enterprise. 64 characters maximum.
CurrentAllocationSize	The number of bytes that the application is currently using.
ActiveSession	Will be true if this application has an active session with Intel AMT, false otherwise.
Partner	Will be true or false, respectively, for partner and non-partner applications.

Note:

Information about all registered applications is returned; both partner and non-partner applications.

4. Display or otherwise make use of the retrieved data as needed.

Click here for a snippet demonstrating this step

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

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

$inputObject = $thirdPartyDataStorageAdministrationServiceRef.CreateMethodInput("AdminGetRegisteredApplications")

$outputObject = $thirdPartyDataStorageAdministrationServiceRef.InvokeMethod($inputObject)

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

if($returnValue -like "0")

{

$applicationHandles = $outputObject.GetProperty("ApplicationHandles")

for($i = 0; $i -lt $applicationHandles.Count; $i++)

{

$inputObject = $thirdPartyDataStorageAdministrationServiceRef.CreateMethodInput("AdminGetApplicationAttributes")

$inputObject.SetProperty("Handle", $applicationHandles.Item($i).ToString())

$outputObject = $thirdPartyDataStorageAdministrationServiceRef.InvokeMethod($inputObject)

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

if($returnValue -like "0")

{

$attrType = $outputObject.GetProperty("AttrType")

$uuid = $outputObject.GetProperty("UUID")

$applicationName = $outputObject.GetProperty("ApplicationName")

$vendorName = $outputObject.GetProperty("VendorName")

$enterpriseName = $outputObject.GetProperty("EnterpriseName")

$currentAllocationSize = $outputObject.GetProperty("CurrentAllocationSize")

$activeSession = $outputObject.GetProperty("ActiveSession")

$partner = $outputObject.GetProperty("Partner")

}

Instance Diagram

Not applicable

Classes Used in This Flow

• AMT_ThirdPartyDataStorageAdministrationService

SDK Sample

Located at:<SDK_root>\Windows\Intel_AMT\Samples\WS-Management\StorageAdministration