get-managementpack operation

The get-managementpack operation retrieves all the management packs that are filtered by the specified search criterion.

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

Adapter request elements for the get-managementpack operation

Element

Definition

Required

<operation-name>

Specifies the operation name: get-managementpack

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

<filters>

Specifies the parent element that contains the search criterion

No

<filter>

Specifies the parent element for a single search criterion

You can specify more than one filter criterion by using multiple <filter> elements.

Conditional; required if the <filters> element is specified

<managementpack-prop-key>

Specifies the name or key of the management pack property used in the search

Valid values:

  • Name
  • KeyToken
  • Version
  • Id
  • VersionId
  • References
  • Sealed
  • ContentReadable
  • FriendlyName
  • DisplayName
  • Description
  • DefaultLanguageCode
  • LockObject

Conditional; required if the <filters> element is specified

<managementpack-prop-val>

Specifies the value of the property specified in the <managementpack-prop-key> element

Conditional; required if the <filters> element is specified

<operand>

Specifies the operation that is performed by using the values specified in the <managementpack-prop-key> and <managementpack-prop-val> elements

Valid values:

  • equals
  • not equals
  • matches

Conditional; required if the <filters> element is specified

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 operation: 

Sample adapter request for the get-managementpack operation

<scom-request>
  <operation-name>get-managementpack</operation-name>
  <command-request>
    <timeout-secs>120</timeout-secs>
    <command-parameters>
      <filters>
        <filter>
          <managementpack-prop-key>Sealed</managementpack-prop-key>
          <managementpack-prop-val>true</managementpack-prop-val>
          <operand>equals</operand>
        </filter>
        <filter>
          <managementpack-prop-key>DisplayName</managementpack-prop-key>
          <managementpack-prop-val>Health</managementpack-prop-val>
          <operand>matches</operand>
        </filter>
      </filters>
    </command-parameters>
  </command-request>
</scom-request>



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

Sample adapter response for the get-managementpack 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 | where-object {$_.Sealed -eq $True} |
         where-object {$_.DisplayName -match 'Health'}</command>
        <execution-milliseconds>5250</execution-milliseconds>
        <exit-code>0</exit-code>
        <status>success</status>
        <count>2</count>
      </metadata>
      <output>
        <item>
          <Name>System.Health.Internal</Name>
          <TimeCreated>1/8/2009 10:13:09 AM</TimeCreated>
          <LastModified>1/8/2009 10:13:09 AM</LastModified>
          <KeyToken>31bf3856ad364e35</KeyToken>
          <Version>6.0.6278.0</Version>
          <Id>9395a1eb-6322-1c8b-71ad-7ab6955c7e11</Id>
          <VersionId>a55ebf8e-6400-bd52-4b94-4128f736e499</VersionId>
          <References>{System.Library, System.Health.Library}</References>
          <Sealed>True</Sealed>
          <ContentReadable>False</ContentReadable>
          <FriendlyName>System Health Internal Library</FriendlyName>
          <DisplayName>Health Internal Library</DisplayName>
          <Description>System Health Interal Library: This Management Pack
           contains definitions for the System Health types that are no visible
           via the UI or the SDK client.</Description>
          <DefaultLanguageCode>ENU</DefaultLanguageCode>
          <LockObject>System.Object</LockObject>
        </item>
        <item>
          <Name>System.Health.Library</Name>
          <TimeCreated>1/8/2009 10:11:47 AM</TimeCreated>
          <LastModified>1/8/2009 10:11:47 AM</LastModified>
          <KeyToken>31bf3856ad364e35</KeyToken>
          <Version>6.0.6278.0</Version>
          <Id>0abff86f-a35e-b08f-da0e-ff051ab2840c</Id>
          <VersionId>9fe93a57-4b34-578e-c3bd-c649ac2de94f</VersionId>
          <References>{System.Library}</References>
          <Sealed>True</Sealed>
          <ContentReadable>True</ContentReadable>
          <FriendlyName>System Health Library</FriendlyName>
          <DisplayName>Health Library</DisplayName>
          <Description>System Health Library: This Management Pack contains
           definitions for the core System Health types.</Description>
          <DefaultLanguageCode>ENU</DefaultLanguageCode>
          <LockObject>System.Object</LockObject>
        </item>
        ...
      </output>
    </command-output>
  </commands-output>
</scom-response>
Was this page helpful? Yes No Submitting... Thank you

Comments