Find Clients Of Advertisement operation

The Find Clients Of Advertisement operation retrieves all the clients that are associated with the specified advertisement.

The following table describes the <items> XML elements for the Find Clients Of Advertisement operation:

Elements for the <items> XML element and adapter request for the Find Clients Of Advertisement operation

Element

Definition

Required

<operation-name>

Specifies the name of the operation: find-clients-of-advertisement

Yes

<arguments>

Specifies a list of arguments required for this operation

Yes

<target>

Specifies the connection information for the Microsoft System Center Configuration Manager application

Valid values: The value specified for the <target> element must be the same as that specified for the name attribute of the <config> element in the adapter configuration.

Default value: The first configuration defined in the adapter configuration

No

<advertisement-id>

Specifies a string identifier for the advertisement whose clients are to be retrieved

Yes


The following figure shows a sample adapter request for the Find Clients Of Advertisement operation:

Sample adapter request for the Find Clients Of Advertisement operation

<mssccm-request>
    <operation-name>find-clients-of-advertisement</operation-name>
    <arguments>
      <target>config1</target>
      <advertisement-id>45620005</advertisement-id>
    </arguments>
  </mssccm-request>

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

Sample adapter response for the Find Clients Of Advertisement operation

<mssccm-response>
  <metadata>
    <response-count>1</response-count>
    <status>success</status>
  </metadata>
  <responses>
    <response>
      <metadata>
        <target>config1</target>
        <status>success</status>
        <count>2</count>
      </metadata>
      <output>
        <advertisement-id>45620005</advertisement-id>
        <last-acceptance-message-id>10002</last-acceptance-message-id>
        <last-acceptance-message-id-name>Program received
</last-acceptance-message-id-name>
        <last-acceptance-message-id-severity>1073741824
</last-acceptance-message-id-severity>
        <last-acceptance-state>1</last-acceptance-state>
        <last-acceptance-state-name>Accepted</last-acceptance-state-name>
        <last-acceptance-status-time>20110124063951.013000+***
</last-acceptance-status-time>
        <last-execution-context />
        <last-execution-result />
        <last-state>-1</last-state>
        <last-state-name>Accepted - No Further Status</last-state-name>
        <last-status-message-id>65535</last-status-message-id>
        <last-status-message-id-name>Program received - no further status
</last-status-message-id-name>
        <last-status-message-id-severity>-268435456
</last-status-message-id-severity>
        <last-status-time>20110124063951.013000+***</last-status-time>
        <client-id>2</client-id>
      </output>
      <output>
        <advertisement-id>45620005</advertisement-id>
        <last-acceptance-message-id>10002</last-acceptance-message-id>
        <last-acceptance-message-id-name>Program received
</last-acceptance-message-id-name>
        <last-acceptance-message-id-severity>1073741824
</last-acceptance-message-id-severity>
        <last-acceptance-state>1</last-acceptance-state>
        <last-acceptance-state-name>Accepted</last-acceptance-state-name>
        <last-acceptance-status-time>20110124094443.673000+***
</last-acceptance-status-time>
        <last-execution-context />
        <last-execution-result />
        <last-state>-1</last-state>
        <last-state-name>Accepted - No Further Status</last-state-name>
        <last-status-message-id>65535</last-status-message-id>
        <last-status-message-id-name>Program received - no further status
</last-status-message-id-name>
        <last-status-message-id-severity>-268435456
</last-status-message-id-severity>
        <last-status-time>20110124094443.673000+***</last-status-time>
        <client-id>2418</client-id>
      </output>
    </response>
  </responses>
</mssccm-response>
Was this page helpful? Yes No Submitting... Thank you

Comments