get-managementpack-by-name operation

The get-managementpack-by-name operation retrieves the details of the management pack that is identified by the specified name.

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

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

Element	Definition	Required
`<operation-name>`	Specifies the operation name: `get-managementpack-by-name`	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-name>`	Specifies the name of the management pack that you want to retrieve Note If the name contains spaces, enclose it in single quotation marks.	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-name operation:

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

<scom-request>
  <operation-name>get-managementpack-by-name</operation-name>
  <command-request>
    <timeout-secs>120</timeout-secs>
    <command-parameters>
      <managementpack-name>Microsoft.Windows.Client.BusinessCritical</managementpack-name>
    </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-name 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 -name
         Microsoft.Windows.Client.BusinessCritical</command>
        <execution-milliseconds>4844</execution-milliseconds>
        <exit-code>0</exit-code>
        <status>success</status>
        <count>1</count>
      </metadata>
      <output>
        <item>
          <Name>Microsoft.Windows.Client.BusinessCritical</Name>
          <TimeCreated>1/27/2009 12:05:30 PM</TimeCreated>
          <LastModified>1/27/2009 12:05:30 PM</LastModified>
          <KeyToken />
          <Version>6.0.6278.0</Version>
          <Id>d6319b70-2cc9-2a12-83b3-0f585cbd5d39</Id>
          <VersionId>0ee13224-c4f8-4a84-a94c-5eb811ffbd48</VersionId>
          <References>{Microsoft.Windows.Library, Microsoft.Windows.Client.Library,
           Microsoft.SystemCenter.InstanceGroup.Library, System.Library...}</References>
          <Sealed>False</Sealed>
          <ContentReadable>True</ContentReadable>
          <FriendlyName>Microsoft Windows Client Business Critical MP</FriendlyName>
          <DisplayName>Windows Client Business Critical Operating Systems</DisplayName>
          <Description>Microsoft Windows Client Business Critical Operating
           Systems Management Pack: This management pack discovers and monitors
           Business Critical Windows Client Operating Systems.</Description>
          <DefaultLanguageCode>ENU</DefaultLanguageCode>
          <LockObject>System.Object</LockObject>
        </item>
      </output>
    </command-output>
  </commands-output>
</scom-response>

get-managementpack-by-name operation

Comments