Remove-CMUserCollectionQueryMembershipRule
Supprimer une règle d’appartenance à une requête d’une collection d’utilisateurs.
Syntax
Remove-CMUserCollectionQueryMembershipRule
-InputObject <IResultObject>
-RuleName <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMUserCollectionQueryMembershipRule
-CollectionName <String>
-RuleName <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMUserCollectionQueryMembershipRule
-CollectionId <String>
-RuleName <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Utilisez cette cmdlet pour supprimer une règle d’appartenance à une requête d’une collection d’utilisateurs.
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 supprimer les règles de requête des 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.
Lorsque vous supprimez une règle d’appartenance à une requête d’une collection, plusieurs ressources peuvent ne plus être membres de la collection. Cette action peut entraîner le non-application d’un déploiement de logiciel ou de configuration aux utilisateurs.
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 : Supprimer une règle d’une collection à l’aide du nom de la collection
Cette commande supprime la règle nommée Utilisateurs distants par domaine de la collection nommée Utilisateurs distants.
Remove-CMUserCollectionQueryMembershipRule -CollectionName "Remote Users" -RuleName "Remote Users by Domain"
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’utilisateurs pour supprimer la règle. Cette valeur est la propriété CollectionID, par XYZ00012
exemple. Étant donné que vous ne pouvez pas supprimer les règles de requête des collections par défaut, cet ID commence par le code du site et non SMS
par .
Type: | String |
Aliases: | Id |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
Spécifiez le nom de la collection d’utilisateurs pour supprimer la règle.
Type: | String |
Aliases: | Name |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Exécutez la commande sans demander confirmation.
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 afin de supprimer la règle. Pour obtenir cet objet, utilisez les cmdlets Get-CMCollection ou Get-CMUserCollection.
Type: | IResultObject |
Aliases: | Collection |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RuleName
Spécifiez le nom de la règle de requête à supprimer de la collection.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entrées
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Sorties
System.Object