Freigeben über

Get-CMCollectionDirectMembershipRule

  • Referenz
Modul:
ConfigurationManager

Ruft eine Regel für die direkte Mitgliedschaft für ein Gerät oder eine Benutzersammlung ab.

Syntax

Get-CMCollectionDirectMembershipRule
   -CollectionName <String>
   [-ResourceName <String>]
   [<CommonParameters>]
Get-CMCollectionDirectMembershipRule
   -CollectionName <String>
   -Resource <IResultObject>
   [<CommonParameters>]
Get-CMCollectionDirectMembershipRule
   -CollectionName <String>
   -ResourceId <String>
   [<CommonParameters>]
Get-CMCollectionDirectMembershipRule
   -CollectionId <String>
   -Resource <IResultObject>
   [<CommonParameters>]
Get-CMCollectionDirectMembershipRule
   -CollectionId <String>
   -ResourceId <String>
   [<CommonParameters>]
Get-CMCollectionDirectMembershipRule
   -CollectionId <String>
   [-ResourceName <String>]
   [<CommonParameters>]
Get-CMCollectionDirectMembershipRule
   -InputObject <IResultObject>
   -Resource <IResultObject>
   [<CommonParameters>]
Get-CMCollectionDirectMembershipRule
   -InputObject <IResultObject>
   -ResourceId <String>
   [<CommonParameters>]
Get-CMCollectionDirectMembershipRule
   -InputObject <IResultObject>
   [-ResourceName <String>]
   [<CommonParameters>]

Beschreibung

Verwenden Sie dieses Cmdlet, um eine oder mehrere Direkte Mitgliedschaftsregeln für ein Gerät oder eine Benutzersammlung abzurufen. Mit einer Direkten Mitgliedschaftsregel können Sie die Mitglieder der Gerätesammlung explizit auswählen. Standardsammlungen verfügen nicht über Direkte Mitgliedschaftsregeln. Jede Sammlung, auf die Sie abzielen, sollte über eine ID verfügen, die mit dem Websitecode beginnt, nicht SMS. 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 Direkten Mitgliedschaftsregeln für eine Sammlung anhand des Namens

Dieser Befehl ruft die Regeln für die direkte Mitgliedschaft für die Sammlung mit dem Namen Device01 ab.

Get-CMCollectionDirectMembershipRule -CollectionName "Device01"

Beispiel 2: Abrufen aller Regeln für direkte Mitgliedschaften mithilfe der Pipeline

Dieser Befehl verwendet das Cmdlet Get-CMCollection , um das Sammlungsobjekt mit dem Namen User02 abzurufen. Anschließend wird der Pipelineoperator verwendet, um das Objekt an das Cmdlet Get-CMCollectionDirectMembershipRule zu übergeben.

Get-CMCollection -Name "User02" | Get-CMCollectionDirectMembershipRule

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 Regeln für die direkte Mitgliedschaft aufweisen können, beginnt diese ID mit dem Websitecode und nicht SMSmit .

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

-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

-Resource

Geben Sie eine Ressource, ein Gerät oder ein Benutzerobjekt an, um die direkte Mitgliedschaftsregel aus der Auflistung abzurufen. Verwenden Sie zum Abrufen dieses Objekts die Cmdlets Get-CMResource, Get-CMDevice oder Get-CMUser .

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

-ResourceId

Geben Sie die ID der Ressource an, um die Regel für die direkte Mitgliedschaft aus der Sammlung abzurufen. Dieser Wert ist die ResourceID-Eigenschaft , z. B 16777219. .

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

-ResourceName

Geben Sie den Namen des Geräts oder Benutzers an, um die Regel für die direkte Mitgliedschaft aus der Sammlung abzurufen.

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

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object

Hinweise

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