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>
Was this page helpful? Yes No Submitting... Thank you

Comments