Get-CMDeviceCollectionIncludeMembershipRule
Get-CMDeviceCollectionIncludeMembershipRule
Gets the include membership rules from one or more device collections in the Configuration Manager hierarchy.
Syntax
Parameter Set: ByCollectionNameAndIncludeCollectionName
Get-CMDeviceCollectionIncludeMembershipRule -CollectionName <String> -IncludeCollectionName <String> [ <CommonParameters>]
Parameter Set: ByCollectionIdAndIncludeCollectionId
Get-CMDeviceCollectionIncludeMembershipRule -CollectionId <String> -IncludeCollectionId <String> [ <CommonParameters>]
Parameter Set: ByCollectionIdAndIncludeCollectionName
Get-CMDeviceCollectionIncludeMembershipRule -CollectionId <String> -IncludeCollectionName <String> [ <CommonParameters>]
Parameter Set: ByCollectionNameAndIncludeCollectionId
Get-CMDeviceCollectionIncludeMembershipRule -CollectionName <String> -IncludeCollectionId <String> [ <CommonParameters>]
Parameter Set: ByCollectionValueAndIncludeCollectionId
Get-CMDeviceCollectionIncludeMembershipRule -Collection <IResultObject> -IncludeCollectionId <String> [ <CommonParameters>]
Parameter Set: ByCollectionValueAndIncludeCollectionName
Get-CMDeviceCollectionIncludeMembershipRule -Collection <IResultObject> -IncludeCollectionName <String> [ <CommonParameters>]
Detailed Description
The Get-CMDeviceCollectionIncludeMembershipRule cmdlet retrieves rules that include the members of another collection in the device collections where the rule is applied. You can specify the device collections where the rule is applied by using their names, Ids, or by specifying an object that represents the collections.
Configuration Manager dynamically updates the membership of the device collection if the membership of the included collection changes. For more information about membership rules, see Introduction to Collections in Configuration Manager.
Parameters
-Collection<IResultObject>
Specifies a Configuration Manager device collection object. To obtain a device collection object, use the Get-CMDeviceCollection cmdlet.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-CollectionId<String>
Specifies the ID of the device collection where the rule is applied.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-CollectionName<String>
Specifies the name of the device collection where the rule is applied.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-IncludeCollectionId<String>
Specifies the ID of the collection whose members are included in the device collection.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-IncludeCollectionName<String>
Specifies the name of the collection whose members are included in the device collections.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
Examples
Example 1: Get the include membership rules from a device collection
This command gets the include membership rules for the collection that has the Id SMSDM001 from the device collection that has the Id 9990000D.
PS C:\> Get-CMDeviceCollectionIncludeMembershipRule –CollectionId "9990000D" –IncludeCollectionId "SMSDM001"
Related topics
Add-CMDeviceCollectionIncludeMembershipRule