Update Collection Membership operation


The Update Collection Membership operation triggers a re-evaluation of collection membership of the specified collection. It ensures that the membership of a collection is current before other activities are performed on the collection or its members.

The following table describes the <items> XML elements for the Update Collection Membership operation

Elements for the <items> XML element and adapter request for the Update Collection Membership operation

Element

Definition

Required

<operation-name>

Specifies the name of the operation: delete-membership-rule-from-collection

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

<collection-id>

Specifies the collection ID of the user or device collection for which the membership needs to be re-evaluated

Yes

The following figure shows a sample adapter request for the Update Collection Membership operation:

Sample adapter request for the Update Collection Membership operation

<mssccm-request>
    <operation-name>update-collection-membership</operation-name>
       <timeout-secs>120</timeout-secs>
       <arguments>
         <target>config1</target>     
         <collection-id>PRI00033</collection-id>
       </arguments>
</mssccm-request>

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

Sample adapter response for the Update Collection Membership operation

<mssccm-response>
     <metadata>
       <status>success</status>
       <response-count>1</response-count>
     </metadata>
     <responses>
       <response>
         <metadata>
           <target>config1</target>
           <status>success</status>
           <count>1</count>
         </metadata>
         <output>
           <message>Refreshed the Collection with ID - PRI00033 to update its membership.</message>
         </output>
       </response>
     </responses>
</mssccm-response>

 

 

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

TrueSight Orchestration Content 23.1