Freigeben über

Get-CMCollectionExcludeMembershipRule

  • Referenz
Modul:
ConfigurationManager

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

Syntax

Get-CMCollectionExcludeMembershipRule
   -CollectionName <String>
   [-ExcludeCollectionName <String>]
   [<CommonParameters>]
Get-CMCollectionExcludeMembershipRule
   -CollectionName <String>
   -ExcludeCollection <IResultObject>
   [<CommonParameters>]
Get-CMCollectionExcludeMembershipRule
   -CollectionName <String>
   -ExcludeCollectionId <String>
   [<CommonParameters>]
Get-CMCollectionExcludeMembershipRule
   -CollectionId <String>
   -ExcludeCollection <IResultObject>
   [<CommonParameters>]
Get-CMCollectionExcludeMembershipRule
   -CollectionId <String>
   -ExcludeCollectionId <String>
   [<CommonParameters>]
Get-CMCollectionExcludeMembershipRule
   -CollectionId <String>
   [-ExcludeCollectionName <String>]
   [<CommonParameters>]
Get-CMCollectionExcludeMembershipRule
   -InputObject <IResultObject>
   -ExcludeCollection <IResultObject>
   [<CommonParameters>]
Get-CMCollectionExcludeMembershipRule
   -InputObject <IResultObject>
   -ExcludeCollectionId <String>
   [<CommonParameters>]
Get-CMCollectionExcludeMembershipRule
   -InputObject <IResultObject>
   [-ExcludeCollectionName <String>]
   [<CommonParameters>]

Beschreibung

Verwenden Sie dieses Cmdlet, um eine oder mehrere Ausschlussmitgliedschaftsregeln für eine Geräte- oder Benutzersammlung abzurufen. Eine Ausschlussmitgliedschaftsregel schließt die Elemente einer anderen Auflistung aus den Auflistungen aus, in denen die Regel angewendet wird.

Configuration Manager aktualisiert die Mitgliedschaft der Sammlung dynamisch nach einem Zeitplan, wenn sich die Mitgliedschaft der ausgeschlossenen 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 der Ausschlussmitgliedschaftsregeln für eine Sammlung

Dieser Befehl ruft die Regeln ab, die die Elemente der Auflistung mit id SMSDM001 aus der Auflistung mit id XYZ00012 ausschließen.

Get-CMCollectionExcludeMembershipRule -CollectionId "XYZ00012" -ExcludeCollectionId "SMSDM001"

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 Ausschlussmitgliedschaftsregeln aufweisen, 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

-ExcludeCollection

Geben Sie ein Objekt für die ausgeschlossene 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

-ExcludeCollectionId

Geben Sie die ID der ausgeschlossenen Auflistung an, um die Regel abzurufen. Dieser Wert ist die CollectionID-Eigenschaft , z. B XYZ00012. . Sie können Standardsammlungen ausschließ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

-ExcludeCollectionName

Geben Sie den Namen der ausgeschlossenen 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-CMDeviceCollectionExcludeMembershipRule und Get-CMUserCollectionExcludeMembershipRule, die für den Sammlungstyp spezifisch sind. Dieses Cmdlet kann mit Geräte- oder Benutzersammlungen verwendet werden.