DeleteMembershipRule Method in Class SMS_Collection

Article
05/03/2011

Applies To: System Center Configuration Manager 2007, System Center Configuration Manager 2007 R2, System Center Configuration Manager 2007 R3, System Center Configuration Manager 2007 SP1, System Center Configuration Manager 2007 SP2

In Configuration Manager, the DeleteMembershipRule Windows Management Instrumentation (WMI) class method deletes a membership rule from the collection.

The following syntax is simplified from Managed Object Format (MOF) code and is intended to show the definition of the method.

SInt32 DeleteMembershipRule(
     SMS_CollectionRule collectionRule
);

Parameters

collectionRule
Data type: SMS_CollectionRule

Qualifiers: [in]

SMS_CollectionRule Server WMI Class object to delete.

Return Values

An SInt32 data type that is 0 to indicate success or non-zero to indicate failure.

For information about handling returned errors, see About Configuration Manager Errors.

Example Code

The following example shows how to delete both a direct rule and a query rule.

    Dim instCollection As SWbemObject            'Instance of SMS_Collection
    Dim instQueryRule As SWbemObject             'Instance of SMS_CollectionRuleQuery
    Dim instDirectRule As SWbemObject            'Instance of SMS_CollectionRuleDirect
    Set instCollection = Services.Get("SMS_Collection.CollectionID=""<collectionid>""")
    
    ' Identify and delete the query rule.
    Set instQueryRule = Services.Get("SMS_CollectionRuleQuery").SpawnInstance_
    instQueryRule.QueryID = <id number>
    instCollection.DeleteMembershipRule instQueryRule
    
    ' Identify and delete the direct rule.
    Set instDirectRule = Services.Get("SMS_CollectionRuleDirect").SpawnInstance_
    instDirectRule.ResourceID = <resource id>
    instCollection.DeleteMembershipRule instDirectRule

Remarks

To delete multiple rules, use DeleteMembershipRules Method in Class SMS_Collection.

Requirements

Runtime Requirements

For more information, see Configuration Manager Server Runtime Requirements.

Development Requirements

For more information, see Configuration Manager Server Development Requirements.

Partager via