get-managementpack-by-id operation

The get-managementpack-by-id operation retrieves the details of the management pack that is identified by the specified globally unique identifier (GUID).

The following table describes the <items> XML and request elements for the get-managementpack-by-id operation:

Adapter request elements for the get-managementpack-by-id operation

Element	Definition	Required
`<operation-name>`	Specifies the operation name: `get-managementpack-by-id`	Yes
`<command-request>`	Specifies the parent element for the command elements	Yes
`<timeout-secs>`	Specifies the duration after which the operation times out Default value: 60 seconds	No
`<command-parameters>`	Specifies the parent element for the command parameters	Yes
`<managementpack-id>`	Specifies the GUID of the management pack that you want to retrieve	Yes

Note

The following naming discrepancies exist between the Microsoft System Center Operations Manager 2007 application and API:

The ID attribute of the application is mapped to the Name attribute of the management pack in the API.
The Name attribute of the application is mapped to the DisplayName attribute of the management pack in the API.

The following figure illustrates a sample adapter request for the get-managementpack-by-id operation:

Sample adapter request for the get-managementpack-by-id operation

<scom-request>
  <operation-name>get-managementpack-by-id</operation-name>
  <command-request>
    <timeout-secs>120</timeout-secs>
    <command-parameters>
      <managementpack-id>66de9512-d446-f46b-bb85-197ec864f1f7</managementpack-id>
    </command-parameters>
  </command-request>
</scom-request>

The following figure illustrates the adapter response for the sample request:

Sample adapter response for the get-managementpack-by-id operation

<scom-response>
  <metadata>
    <status>success</status>
    <count>1</count>
  </metadata>
  <commands-output>
    <command-output>
      <metadata>
        <command>./Microsoft.EnterpriseManagement.OperationsManager.ClientShell.
        Startup.ps1;get-managementpack -id 66de9512-d446-f46b-bb85-197ec864f1f7</command>
        <execution-milliseconds>4844</execution-milliseconds>
        <exit-code>0</exit-code>
        <status>success</status>
        <count>1</count>
      </metadata>
      <output>
        <item>
          <Name>Microsoft.SystemCenter.NetworkDevice.Library</Name>
          <TimeCreated>1/8/2009 10:12:59 AM</TimeCreated>
          <LastModified>1/8/2009 10:12:59 AM</LastModified>
          <KeyToken>31bf3856ad364e35</KeyToken>
          <Version>6.0.6278.0</Version>
          <Id>66de9512-d446-f46b-bb85-197ec864f1f7</Id>
          <VersionId>bf7cb5c6-ca4a-1658-5a0e-801cf2e75c87</VersionId>
          <References>{System.Snmp.Library, Microsoft.Windows.Library,
           System.Performance.Library, System.Library...}</References>
          <Sealed>True</Sealed>
          <ContentReadable>True</ContentReadable>
          <FriendlyName>Microsoft System Center Network Device Library</FriendlyName>
          <DisplayName>Network Device Library</DisplayName>
          <Description>Microsoft System Center Network Device Library: This
           Management Pack contains the definitions that are specific to 
            Network Devices.</Description>
          <DefaultLanguageCode>ENU</DefaultLanguageCode>
          <LockObject>System.Object</LockObject>
        </item>
      </output>
    </command-output>
  </commands-output>
</scom-response>

get-managementpack-by-id operation

Comments