Freigeben über


Get-CMCollectionIncludeMembershipRule

Dient zum Abrufen einer Include-Mitgliedschaftsregel für ein Gerät oder eine Benutzersammlung.

Syntax

Get-CMCollectionIncludeMembershipRule
   -CollectionName <String>
   [-IncludeCollectionName <String>]
   [<CommonParameters>]
Get-CMCollectionIncludeMembershipRule
   -CollectionName <String>
   -IncludeCollection <IResultObject>
   [<CommonParameters>]
Get-CMCollectionIncludeMembershipRule
   -CollectionName <String>
   -IncludeCollectionId <String>
   [<CommonParameters>]
Get-CMCollectionIncludeMembershipRule
   -CollectionId <String>
   -IncludeCollection <IResultObject>
   [<CommonParameters>]
Get-CMCollectionIncludeMembershipRule
   -CollectionId <String>
   -IncludeCollectionId <String>
   [<CommonParameters>]
Get-CMCollectionIncludeMembershipRule
   -CollectionId <String>
   [-IncludeCollectionName <String>]
   [<CommonParameters>]
Get-CMCollectionIncludeMembershipRule
   -InputObject <IResultObject>
   -IncludeCollection <IResultObject>
   [<CommonParameters>]
Get-CMCollectionIncludeMembershipRule
   -InputObject <IResultObject>
   -IncludeCollectionId <String>
   [<CommonParameters>]
Get-CMCollectionIncludeMembershipRule
   -InputObject <IResultObject>
   [-IncludeCollectionName <String>]
   [<CommonParameters>]

Beschreibung

Verwenden Sie dieses Cmdlet, um eine oder mehrere Mitgliedschaftsregeln für ein Gerät oder eine Benutzersammlung abzurufen. Eine __ Include-Mitgliedschaftsregel enthält die Elemente einer anderen Auflistung auf die Auflistungen, in denen die Regel angewendet wird.

Configuration Manager aktualisiert die Mitgliedschaft der Sammlung dynamisch nach einem Zeitplan, wenn sich die Mitgliedschaft der enthaltenen Sammlung ändert.

Weitere Informationen finden Sie unter Erstellen von Sammlungen in Configuration Manager.

Hinweis

Führen Sie Configuration Manager-Cmdlets beispielsweise vom Configuration Manager-Standortlaufwerk PS XYZ:\> aus. Weitere Informationen finden Sie unter "Erste Schritte".

Beispiele

Beispiel 1: Abrufen aller Include-Mitgliedschaftsregeln

Dieser Befehl ruft alle Mitgliedschaftsregeln für die Sammlung mit dem Namen "Gerät" ab.

Get-CMCollectionIncludeMembershipRule -CollectionName "Device"

Beispiel 2: Abrufen von Mitgliedschaftsregeln mithilfe der Pipeline

Dieser Befehl verwendet zuerst die Get-CMCollection, um das Auflistungsobjekt namens Usersabzurufen. Anschließend wird der Pipelineoperator verwendet, um das Objekt an das Cmdlet "Get-CMCollectionIncludeMembershipRule" zu übergeben, das alle Mitgliedschaftsregeln für das Auflistungsobjekt abruft.

Get-CMCollection -Name "Users" | Get-CMCollectionIncludeMembershipRule

Parameter

-CollectionId

Geben Sie die ID der Auflistung an, um die Regel abzurufen. Dieser Wert ist die CollectionID-Eigenschaft, z. XYZ00012 B. . Da Standardsammlungen keine Mitgliedschaftsregeln enthalten, beginnt diese ID mit dem Websitecode und nicht SMS .

Type:String
Aliases:Id
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-CollectionName

Geben Sie den Namen der Auflistung an, um die Regel abzurufen.

Type:String
Aliases:Name
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-IncludeCollection

Geben Sie ein Objekt für die enthaltene Auflistung an, um die Regel abzurufen. Verwenden Sie zum Abrufen dieses Objekts die Cmdlets "Get-CMCollection", "Get-CMDeviceCollection"oder "Get-CMUserCollection".

Type:IResultObject
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-IncludeCollectionId

Geben Sie die ID der enthaltenen Auflistung an, um die Regel abzurufen. Dieser Wert ist die CollectionID-Eigenschaft, z. XYZ00012 B. . Sie können Standardauflistungen einschließen, sodass dieser Wert entweder mit dem Websitecode oder beginnen SMS kann.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-IncludeCollectionName

Geben Sie den Namen der enthaltenen Auflistung an, um die Regel abzurufen.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Geben Sie ein Objekt für die Auflistung an, um die Regel abzurufen. Verwenden Sie zum Abrufen dieses Objekts die Cmdlets "Get-CMCollection", "Get-CMDeviceCollection"oder "Get-CMUserCollection".

Type:IResultObject
Aliases:Collection
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object

Hinweise

Dieses Cmdlet ähnelt Get-CMDeviceCollectionIncludeMembershipRule und Get-CMUserCollectionIncludeMembershipRule, die für den Sammlungstyp spezifisch sind. Dieses Cmdlet kann mit Geräte- oder Benutzersammlungen verwendet werden.