get-discovery-by-id operation

The get-discovery-by-id operation retrieves the properties of a monitored object that is identified by the specified globally unique identifier (GUID).

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

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

Element	Definition	Required
`<operation-name>`	Specifies the operation name: `get-discovery-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
`<discovery-id>`	Specifies the GUID of the monitored object whose details are retrieved	Yes

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

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

<scom-request>
  <operation-name>get-discovery-by-id</operation-name>
  <command-request>
    <timeout-secs>120</timeout-secs>
    <command-parameters>
      <discovery-id>f3124f32-cba5-5974-77fd-004e5c2f05ce</discovery-id>
    </command-parameters>
  </command-request>
</scom-request>

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

Sample adapter response for the get-discovery-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-discovery -id f3124f32-cba5-5974-77fd-004e5c2f05ce</command>
        <execution-milliseconds>6172</execution-milliseconds>
        <exit-code>0</exit-code>
        <status>success</status>
        <count>1</count>
      </metadata>
      <output>
        <item>
          <ManagementGroup>M1</ManagementGroup>
          <ManagementGroupId>ae1fcf8a-8088-31d8-93ec-90fe77a32d44</ManagementGroupId>
          <HasNonCategoryOverride>False</HasNonCategoryOverride>
          <Enabled>false</Enabled>
          <Target>ManagementPackElementUniqueIdentifier=6aae6166-5693-98bb-7a34-
          4e8ab3030636</Target>
          <ConfirmDelivery>False</ConfirmDelivery>
          <Remotable>True</Remotable>
          <Priority>Normal</Priority>
          <Category>Discovery</Category>
          <DataSource>DiscoveryDataSource</DataSource>
          <DiscoveryClassCollection>{}</DiscoveryClassCollection>
          <DiscoveryRelationshipCollection>{ManagementPackElementUniqueIdentifie
          r=fdd1eeb6-e022-761c-58f1-8afd88ffaa88}</DiscoveryRelationshipCollection>
          <XmlTag>Discovery</XmlTag>
          <Name>Microsoft.Windows.Server.InstanceGroup.Discovery</Name>
          <Id>f3124f32-cba5-5974-77fd-004e5c2f05ce</Id>
          <DisplayName>Populate Windows Server Instances Group</DisplayName>
          <Description />
          <LanguageCode>ENU</LanguageCode>
          <Comment />
          <Status>Unchanged</Status>
          <LastModified>1/8/2009 10:23:27 AM</LastModified>
          <TimeAdded>1/8/2009 10:23:29 AM</TimeAdded>
        </item>
      </output>
    </command-output>
  </commands-output>
</scom-response>

get-discovery-by-id operation

Comments