Freigeben über


Get-CMCollectionIncludeMembershipRule

Ruft eine Includemitgliedschaftsregel für ein Gerät oder eine Benutzersammlung ab.

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 Include-Mitgliedschaftsregeln für eine Geräte- oder Benutzersammlung abzurufen. Eine Includemitgliedschaftsregel schließt die Elemente einer anderen Auflistung zu den Auflistungen ein, 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 auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Abrufen aller Includemitgliedschaftsregeln

Dieser Befehl ruft alle Includemitgliedschaftsregeln für die Sammlung mit dem Namen Device ab.

Get-CMCollectionIncludeMembershipRule -CollectionName "Device"

Beispiel 2: Abrufen von Include-Mitgliedschaftsregeln mithilfe der Pipeline

Dieser Befehl verwendet zunächst get-CMCollection , um das Auflistungsobjekt mit dem Namen Users abzurufen. Anschließend wird der Pipelineoperator verwendet, um das Objekt an das Cmdlet Get-CMCollectionIncludeMembershipRule zu übergeben, das alle Includemitgliedschaftsregeln für das Auflistungsobjekt abruft.

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

Parameter

-CollectionId

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

Typ:String
Aliase:Id
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CollectionName

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

Typ:String
Aliase:Name
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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 .

Typ:IResultObject
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IncludeCollectionId

Geben Sie die ID der enthaltenen Sammlung an, um die Regel abzurufen. Dieser Wert ist die CollectionID-Eigenschaft , z. B XYZ00012. . Sie können Standardsammlungen einschließen, sodass dieser Wert entweder mit dem Standortcode oder SMSbeginnen kann.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IncludeCollectionName

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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 .

Typ:IResultObject
Aliase:Collection
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren: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.