Freigeben über

Get-CMCollectionQueryMembershipRule

  • Referenz
Modul:
ConfigurationManager

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

Syntax

Get-CMCollectionQueryMembershipRule
   -CollectionName <String>
   [-RuleName <String>]
   [<CommonParameters>]
Get-CMCollectionQueryMembershipRule
   -CollectionId <String>
   [-RuleName <String>]
   [<CommonParameters>]
Get-CMCollectionQueryMembershipRule
   -InputObject <IResultObject>
   [-RuleName <String>]
   [<CommonParameters>]

Beschreibung

Verwenden Sie dieses Cmdlet, um eine oder mehrere Abfragemitgliedschaftsregeln für ein Gerät oder eine Benutzersammlung abzurufen. Mit einer Abfrageregel können Sie die Mitgliedschaft einer Sammlung basierend auf einer Abfrage, die nach einem Zeitplan ausgeführt wird, dynamisch aktualisieren. Weitere Informationen finden Sie unter Erstellen von Sammlungen in Configuration Manager.

Weitere Informationen zu Mitgliedschaftsregeln finden Sie unter Einführung in 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 Abfragemitgliedschaftsregeln für die Sammlung "Alle Systeme"

Dieser Befehl ruft die Abfragemitgliedschaftsregeln aus der Standardgerätesammlung mit dem Namen Alle Systeme ab.

Get-CMCollectionQueryMembershipRule -CollectionName "All Systems"

Beispiel 2: Anzeigen des Abfrageausdrucks für eine Regel in der Sammlung Alle Benutzer

Dieser Befehl ruft die Abfragemitgliedschaftsregel mit dem Namen Alle Benutzer aus der Sammlung Alle Benutzer ab und gibt den Abfrageausdruck zurück.

Get-CMCollectionQueryMembershipRule -CollectionId "SMS00002" -RuleName "All Users" | Select-Object QueryExpression

Parameter

-CollectionId

Geben Sie die ID der Sammlung an, um die Regel abzurufen. Dieser Wert ist die CollectionID-Eigenschaft , z. B XYZ00012 . oder SMS00001.

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

-RuleName

Geben Sie den Namen der Abfrageregel an, die aus der Auflistung abgerufen werden soll.

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

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object

Hinweise

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