Partager via


Add-CMUserCollectionExcludeMembershipRule

Ajouter une règle d’appartenance d’exclusion à un regroupement d’utilisateurs.

Syntaxe

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 applet de commande pour ajouter une règle d’exclusion d’appartenance à un regroupement d’utilisateurs. Une règle d’exclusion d’appartenance exclut les membres d’une autre collection des regroupements d’utilisateurs où la règle est appliquée.

Vous ne pouvez pas ajouter de règles d’appartenance aux regroupements 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, de sorte que l’ID d’une collection exclue peut commencer par SMS.

Configuration Manager met à jour dynamiquement l’appartenance du regroupement d’utilisateurs selon une planification si l’appartenance du regroupement exclu change.

Lorsque vous ajoutez une règle d’appartenance d’exclusion à une collection, une ressource peut ne plus être membre de la collection d’utilisateurs. Cette action peut empêcher tout déploiement de logiciels ou de configuration de s’appliquer à un utilisateur.

Pour plus d’informations, consultez Guide pratique pour créer des regroupements dans Configuration Manager.

Remarque

Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1 : Ajouter une règle d’exclusion de regroupement à un regroupement d’utilisateurs

Cette commande exclut les membres de la collection Utilisateurs distants , qui a l’ID XYZ00017, de la collection d’utilisateurs avec l’ID XYZ00012.

Add-CMUserCollectionExcludeMembershipRule -CollectionId "XYZ00012" -ExcludeCollectionId "XYZ00017"

Paramètres

-CollectionId

Spécifiez l’ID de la collection d’utilisateurs pour ajouter la règle. Cette valeur est la propriété CollectionID, par exemple . XYZ00012 Étant donné que les collections par défaut n’ont pas de règles d’exclusion d’appartenance, cet ID commence par le code de site et non SMSpar .

Type:String
Alias:Id
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-CollectionName

Spécifiez le nom de la collection d’utilisateurs pour ajouter la règle.

Type:String
Alias:Name
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ExcludeCollection

Spécifiez un objet pour la collection exclue afin d’ajouter la règle. Pour obtenir cet objet, utilisez les applets de commande Get-CMCollection ou Get-CMUserCollection .

Type:IResultObject
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ExcludeCollectionId

Spécifiez l’ID de la collection exclue pour ajouter la règle. Cette valeur est la propriété CollectionID, par exemple . XYZ00012 Vous pouvez exclure les collections par défaut, de sorte que cette valeur peut commencer par le code de site ou SMS.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ExcludeCollectionName

Spécifiez le nom de la collection exclue pour ajouter la règle.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InputObject

Spécifiez un objet pour la collection d’utilisateurs afin d’ajouter la règle. Pour obtenir cet objet, utilisez les applets de commande Get-CMCollection ou Get-CMUserCollection .

Type:IResultObject
Alias:Collection
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-PassThru

Ajoutez ce paramètre pour renvoyer un objet qui représente l’élément avec lequel vous travaillez. Par défaut, cette applet de commande peut ne pas générer de sortie.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

System.Object