Add-CMUserCollectionQueryMembershipRule
Fügen Sie einer Benutzersammlung eine Abfragemitgliedschaftsregel hinzu.
Syntax
Add-CMUserCollectionQueryMembershipRule
-InputObject <IResultObject>
[-PassThru]
-QueryExpression <String>
-RuleName <String>
[-ValidateQueryHasResult]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMUserCollectionQueryMembershipRule
-CollectionId <String>
[-PassThru]
-QueryExpression <String>
-RuleName <String>
[-ValidateQueryHasResult]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMUserCollectionQueryMembershipRule
-CollectionName <String>
[-PassThru]
-QueryExpression <String>
-RuleName <String>
[-ValidateQueryHasResult]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Beschreibung
Verwenden Sie dieses Cmdlet, um einer Benutzersammlung eine Abfragemitgliedschaftsregel hinzuzufügen.
Mit einer Abfrageregel können Sie die Mitgliedschaft einer Sammlung basierend auf einer Abfrage, die nach einem Zeitplan ausgeführt wird, dynamisch aktualisieren.
Sie können Den Standardsammlungen keine Mitgliedschaftsregeln hinzufügen. 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: Hinzufügen einer Abfragemitgliedschaftsregel
In diesem Beispiel wird zuerst die WMI Query Language (WQL)-Anweisung in der wql-Variablen gespeichert. Mit dem nächsten Befehl wird der Benutzersammlung remote users by domain eine Mitgliedschaftsregel namens Remote users by domainhinzugefügt. Der QueryExpression-Parameter verwendet die wql-Variable und gibt die Abfrage an, die die Mitgliedschaftsregel definiert.
$wql = "select SMS_R_USER.ResourceID,SMS_R_USER.ResourceType,SMS_R_USER.Name,SMS_R_USER.UniqueUserName,SMS_R_USER.WindowsNTDomain from SMS_R_User"
Add-CMUserCollectionQueryMembershipRule -CollectionName "Remote Users" -QueryExpression $wql -RuleName "Remote users by domain"Parameter
-CollectionId
Geben Sie die ID der Benutzersammlung an, um die Regel hinzuzufügen. Dieser Wert ist die CollectionID-Eigenschaft , z. B XYZ00012. . Da Sie Den Standardsammlungen keine Mitgliedschaftsregeln hinzufügen können, beginnt diese ID mit dem Websitecode und nicht SMSmit .
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CollectionName
Geben Sie den Namen der Benutzersammlung an, um die Regel hinzuzufügen.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
| Typ: | SwitchParameter |
| Aliase: | cf |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DisableWildcardHandling
Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ForceWildcardHandling
Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-InputObject
Geben Sie ein Objekt für die Benutzerauflistung an, um die Regel hinzuzufügen. Verwenden Sie zum Abrufen dieses Objekts die Cmdlets Get-CMCollection oder Get-CMUserCollection .
| Typ: | IResultObject |
| Aliase: | Collection |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-PassThru
Fügen Sie diesen Parameter hinzu, um ein Objekt zurückzugeben, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig generiert dieses Cmdlet möglicherweise keine Ausgabe.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-QueryExpression
Geben Sie den WMI-Ausdruck der Abfragesprache (WMI Query Language, WQL) an, der von der Website zum Aktualisieren der Benutzersammlung verwendet wird.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-RuleName
Geben Sie den Namen der Abfrageregel an, die der Auflistung hinzugefügt werden soll.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ValidateQueryHasResult
Fügen Sie diesen Parameter hinzu, um den Abfrageausdruck vor dem Hinzufügen der Regel zu testen. Wenn das Cmdlet mit diesem Parameter ausgeführt wird und der Abfrageausdruck keine Ergebnisse aufweist, gibt das Cmdlet die folgende Fehlermeldung zurück: No object corresponds to the specified parameters. In diesem Fall wird die Abfrage nicht zur Auflistung hinzugefügt.
Wenn Sie wissen, dass die Abfrage derzeit null Ergebnisse zurückgibt, aber trotzdem die Regel hinzufügen möchten, verwenden Sie diesen Parameter nicht.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Typ: | SwitchParameter |
| Aliase: | wi |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
Eingaben
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Ausgaben
System.Object