Add-CMUserCollectionDirectMembershipRule

  • Référence
Module:
ConfigurationManager

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

Syntax

Add-CMUserCollectionDirectMembershipRule
   -InputObject <IResultObject>
   [-PassThru]
   -Resource <IResultObject[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMUserCollectionDirectMembershipRule
   -CollectionId <String>
   [-PassThru]
   -ResourceId <Int32[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMUserCollectionDirectMembershipRule
   -CollectionId <String>
   [-PassThru]
   -Resource <IResultObject[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMUserCollectionDirectMembershipRule
   -CollectionName <String>
   [-PassThru]
   -ResourceId <Int32[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMUserCollectionDirectMembershipRule
   -CollectionName <String>
   [-PassThru]
   -Resource <IResultObject[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMUserCollectionDirectMembershipRule
   -InputObject <IResultObject>
   [-PassThru]
   -ResourceId <Int32[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Utilisez cette applet de commande pour ajouter une règle d’appartenance directe à un regroupement d’utilisateurs. Une règle d’appartenance directe vous permet de choisir explicitement les membres de la collection d’utilisateurs. 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. Pour plus d’informations, consultez How to create collections in Configuration Manager.

Remarque

Exécutez Configuration Manager applets de commande à 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’appartenance directe à un regroupement d’utilisateurs

Cette commande ajoute une règle d’appartenance directe à la collection d’utilisateurs avec l’ID XYZ00057. Il ajoute la ressource avec l’ID 16777210 à la collection.

Add-CMUserCollectionDirectMembershipRule -CollectionId "XYZ00057" -ResourceId "16777210"

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 vous ne pouvez pas ajouter de règles d’appartenance aux collections par défaut, cet ID commence par le code de site et non SMSpar .

Type:String
Position:Named
Default value:None
Required:True
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
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Aliases:Collection
Position:Named
Default value:None
Required:True
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 applet de commande peut ne pas générer de sortie.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Resource

Spécifiez un tableau d’objets de ressource à ajouter à la collection d’utilisateurs avec cette règle d’appartenance directe. Pour obtenir cet objet, utilisez les applets de commande Get-CMResource ou Get-CMUser .

Type:IResultObject[]
Aliases:Resources
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceId

Spécifiez un tableau d’ID des ressources à ajouter à la collection d’utilisateurs avec cette règle d’appartenance directe. Cette valeur est la propriété ResourceID , par exemple 16777219.

Type:Int32[]
Aliases:ResourceIds
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Sorties

System.Object