Add-CMUserCollectionExcludeMembershipRule

Référence

Module:: ConfigurationManager

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