Add-CMDeviceCollectionQueryMembershipRule
Fügen Sie einer Gerätesammlung eine Abfragemitgliedschaftsregel hinzu.
Syntax
Add-CMDeviceCollectionQueryMembershipRule
-CollectionId <String>
[-PassThru]
-QueryExpression <String>
-RuleName <String>
[-ValidateQueryHasResult]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMDeviceCollectionQueryMembershipRule
-CollectionName <String>
[-PassThru]
-QueryExpression <String>
-RuleName <String>
[-ValidateQueryHasResult]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMDeviceCollectionQueryMembershipRule
-InputObject <IResultObject>
[-PassThru]
-QueryExpression <String>
-RuleName <String>
[-ValidateQueryHasResult]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Beschreibung
Verwenden Sie dieses Cmdlet, um einer Gerätesammlung 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. Der nächste Befehl fügt der Gerätesammlung mit dem Namen Windows 10-Geräte eine Mitgliedschaftsregel namens TPM hinzu. Der QueryExpression-Parameter verwendet die wql-Variable und gibt die Abfrage an, die die Mitgliedschaftsregel definiert.
$wql = "select SMS_R_System.ResourceId, SMS_R_System.ResourceType, SMS_R_System.Name, SMS_R_System.SMSUniqueIdentifier, SMS_R_System.ResourceDomainORWorkgroup, SMS_R_System.Client from SMS_R_System inner join SMS_G_System_TPM on SMS_G_System_TPM.ResourceID = SMS_R_System.ResourceId"
Add-CMDeviceCollectionQueryMembershipRule -CollectionName "Windows 10 devices" -QueryExpression $wql -RuleName "TPM"Parameter
-CollectionId
Geben Sie die ID der Gerätesammlung 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 Gerätesammlung 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 Gerätesammlung an, um die Regel hinzuzufügen. Verwenden Sie zum Abrufen dieses Objekts die Cmdlets Get-CMCollection oder Get-CMDeviceCollection .
| 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-Abfragespracheausdruck (WQL) an, den die Website zum Aktualisieren der Gerätesammlung verwendet.
| 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