Add-CMDeviceCollectionQueryMembershipRule
Ajouter une règle d’appartenance à une requête à une collection d’appareils.
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>]
Description
Utilisez cette cmdlet pour ajouter une règle d’appartenance à une requête à une collection d’appareils.
Une règle de requête vous permet de mettre à jour dynamiquement l’appartenance d’une collection en fonction d’une requête qui est exécuté selon une planification.
Vous ne pouvez pas ajouter de règles d’appartenance aux collections par défaut. Toute collection que vous ciblez doit avoir un ID qui commence par le code de site, et non SMS
.
Pour plus d’informations, voir Comment créer des collections dans Configuration Manager.
Notes
Exécutez les cmdlets Configuration Manager à partir du lecteur de site Configuration Manager, par PS XYZ:\>
exemple. Pour plus d’informations, voir la mise en place.
Exemples
Exemple 1 : Ajouter une règle d’appartenance à une requête
Cet exemple stocke d’abord l’instruction WMI Query Language (WQL) dans la variable wql. La commande suivante ajoute une règle d’appartenance nommée TPM à la collection d’appareils Windows 10 appareils. Le paramètre QueryExpression utilise la variable wql et spécifie la requête qui définit la règle d’appartenance.
$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"
Paramètres
- Confirmer
Une invite de confirmation apparaît avant d’exécuter le cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
- WhatIf
Présente ce qui se produit si le cmdlet s’exécute. La cmdlet ne s’exécute pas.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionId
Spécifiez l’ID de la collection d’appareils pour ajouter la règle. Cette valeur est la propriété CollectionID, par XYZ00012
exemple. Étant donné que vous ne pouvez pas ajouter de règles d’appartenance à des collections par défaut, cet ID commence par le code de site et non SMS
par .
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
Spécifiez le nom de la collection d’appareils pour ajouter la règle.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Ce paramètre traite les caractères génériques comme des valeurs littérales. Vous ne pouvez pas la combiner avec ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Spécifiez un objet pour la collection d’appareils pour ajouter la règle. Pour obtenir cet objet, utilisez les cmdlets Get-CMCollection ou Get-CMDeviceCollection.
Type: | IResultObject |
Aliases: | Collection |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PassThru
Ajoutez ce paramètre pour renvoyer un objet qui représente l’élément avec lequel vous travaillez. Par défaut, cette cmdlet peut ne pas générer de sortie.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-QueryExpression
Spécifiez l’expression WQL (WMI Query Language) que le site utilise pour mettre à jour la collection d’appareils.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RuleName
Spécifiez le nom de la règle de requête à ajouter à la collection.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ValidateQueryHasResult
Ajoutez ce paramètre pour tester l’expression de requête avant d’ajouter la règle. Lorsque l’cmdlet s’exécute avec ce paramètre, si l’expression de requête n’a aucun résultat, elle renvoie le message d’erreur suivant : Dans ce cas, la requête n’est pas ajoutée à la No object corresponds to the specified parameters.
collection.
Si vous savez que la requête renvoie actuellement zéro résultat, mais que vous souhaitez quand même ajouter la règle, n’utilisez pas ce paramètre.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entrées
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Sorties
System.Object