get-discovery operation

The get-discovery operation retrieves all the available discoveries. You can filter the result by specifying a filter criterion.

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

Adapter request elements for the get-discovery operation

Element	Definition	Required
`<operation-name>`	Specifies the operation name: `get-discovery`	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	Conditional; required if the `<filters>` element is specified
`<discovery-prop-key>`	Specifies the name of the discovery entity property used in the search Valid values: Enabled Name DisplayName Description Category HasNonCategoryOverride Priority ManagementGroup ManagementGroupId Remotable DataSource Id Status LanguageCode XmlTag	Conditional; required if the `<filters>` element is specified
`<discovery-prop-val>`	Specifies the value of the property specified in the `<discovery-prop-key>` element Note When specifying values like true, false, and enabled, enclose them in single quotation marks so that they are treated as strings and not as Boolean entities.	Conditional; required if the `<filters>` element is specified
`<operand>`	Specifies the operation that is performed by using the values specified in the `<discovery-prop-key>` and `<discovery-prop-val>` elements Valid values: equals not equals matches	Conditional; required if the `<filters>` element is specified

Note

The Name attribute of the Microsoft System Center Operations Manager 2007 application is mapped to the DisplayName attribute of discovery entity in the Microsoft System Center Operations Manager 2007 API.

The following figure illustrates a sample adapter request for the get-discovery operation:

Sample adapter request for the get-discovery operation

<scom-request>
  <operation-name>get-discovery</operation-name>
  <command-request>
    <timeout-secs>120</timeout-secs>
    <command-parameters>
      <filters>
        <filter>
          <discovery-prop-key>Enabled</discovery-prop-key>
          <discovery-prop-val>'true'</discovery-prop-val>
          <operand>equals</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-discovery operation

<scom-response>
  <metadata>
    <status>success</status>
    <count>1</count>
  </metadata>
  <commands-output>
    <command-output>
      <metadata>
        <command>./Microsoft.EnterpriseManagement.OperationsManager.ClientShell.
        Startup.ps1;get-discovery | where-object {$_.Enabled -eq 'true'}</command>
        <execution-milliseconds>13468</execution-milliseconds>
        <exit-code>0</exit-code>
        <status>success</status>
        <count>90</count>
      </metadata>
      <output>
        <item>
          <ManagementGroup>M1</ManagementGroup>
          <ManagementGroupId>ae1fcf8a-8088-31d8-93ec-90fe77a32d44</ManagementGroupId>
          <HasNonCategoryOverride>False</HasNonCategoryOverride>
          <Enabled>true</Enabled>
          <Target>ManagementPackElementUniqueIdentifier=ea99500d-8d52-fc52-b5a5-
          10dcd1e9d2bd</Target>
          <ConfirmDelivery>True</ConfirmDelivery>
          <Remotable>True</Remotable>
          <Priority>Normal</Priority>
          <Category>Discovery</Category>
          <DataSource>DS</DataSource>
          <DiscoveryClassCollection>{ManagementPackElementUniqueIdentifier=7337a
          aee-2045-5d32-0aa8-fb6e9c58078f}</DiscoveryClassCollection>
          <DiscoveryRelationshipCollection>{}</DiscoveryRelationshipCollection>
          <XmlTag>Discovery</XmlTag>
          <Name>Microsoft.SystemCenter.ACS.Collector.Discovery</Name>
          <Id>5b73d0a7-9eb3-d08f-901e-03e95e1850b4</Id>
          <DisplayName>Microsoft Audit Collection Services Collector Discovery
           Rule</DisplayName>
          <Description>This rule discovers the Microsoft Audit Collection Service
           Collector service</Description>
          <LanguageCode>ENU</LanguageCode>
          <Comment />
          <Status>Unchanged</Status>
          <LastModified>1/8/2009 10:12:53 AM</LastModified>
          <TimeAdded>1/8/2009 10:12:54 AM</TimeAdded>
        </item>
        ...
      </output>
    </command-output>
  </commands-output>
</scom-response>

get-discovery operation

Comments