Add-CMUserCollectionExcludeMembershipRule
Ajoutez une règle d’appartenance d’exclusion à une collection d’utilisateurs.
Syntax
Add-CMUserCollectionExcludeMembershipRule
-CollectionName <String>
-ExcludeCollectionName <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMUserCollectionExcludeMembershipRule
-CollectionName <String>
-ExcludeCollection <IResultObject>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMUserCollectionExcludeMembershipRule
-CollectionName <String>
-ExcludeCollectionId <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMUserCollectionExcludeMembershipRule
-CollectionId <String>
-ExcludeCollection <IResultObject>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMUserCollectionExcludeMembershipRule
-CollectionId <String>
-ExcludeCollectionId <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMUserCollectionExcludeMembershipRule
-CollectionId <String>
-ExcludeCollectionName <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMUserCollectionExcludeMembershipRule
-InputObject <IResultObject>
-ExcludeCollection <IResultObject>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMUserCollectionExcludeMembershipRule
-InputObject <IResultObject>
-ExcludeCollectionId <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMUserCollectionExcludeMembershipRule
-InputObject <IResultObject>
-ExcludeCollectionName <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Utilisez cette cmdlet pour ajouter une règle d’exclusion d’appartenance à une collection d’utilisateurs. Une règle d’exclusion d’appartenance exclut les membres d’une autre collection des collections d’utilisateurs où la règle est appliquée.
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
. Vous pouvez exclure une collection par défaut, afin que l’ID d’une collection exclue puisse commencer par SMS
.
Configuration Manager met à jour dynamiquement l’appartenance à la collection d’utilisateurs selon une planification si l’appartenance à la collection exclue change.
Lorsque vous ajoutez une règle d’appartenance d’exclusion à une collection, il se peut qu’une ressource ne soit plus membre de la collection d’utilisateurs. Cette action peut entraîner le non-application d’un déploiement de logiciel ou de configuration à un utilisateur.
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’exclusion de collection à une collection d’utilisateurs
Cette commande exclut les membres de la collection Utilisateurs distants, dont l’ID est XYZ00017, de la collection d’utilisateurs avec l’ID XYZ00012.
Add-CMUserCollectionExcludeMembershipRule -CollectionId "XYZ00012" -ExcludeCollectionId "XYZ00017"
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 ajouter la règle. Cette valeur est la propriété CollectionID, par XYZ00012
exemple. Étant donné que les collections par défaut n’ont pas d’exclure les règles d’appartenance, 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 ajouter la règle.
Type: | String |
Aliases: | Name |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExcludeCollection
Spécifiez un objet pour la collection exclue pour ajouter la règle. Pour obtenir cet objet, utilisez les cmdlets Get-CMCollection ou Get-CMUserCollection.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExcludeCollectionId
Spécifiez l’ID de la collection exclue pour ajouter la règle. Cette valeur est la propriété CollectionID, par XYZ00012
exemple. Vous pouvez exclure les collections par défaut, afin que cette valeur puisse commencer par le code du site ou SMS
.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExcludeCollectionName
Spécifiez le nom de la collection exclue pour ajouter la règle.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Spécifiez un objet pour la collection d’utilisateurs pour ajouter 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 |
-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 |
Entrées
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Sorties
System.Object