Partager via

Add-CMDeviceCollectionDirectMembershipRule

  • Référence
Module:
ConfigurationManager

Ajoutez une règle d’appartenance directe à un regroupement d’appareils.

Syntaxe

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

Description

Utilisez cette applet de commande pour ajouter une règle d’appartenance directe à un regroupement d’appareils. Une règle d’appartenance directe vous permet de choisir explicitement les membres du regroupement d’appareils. 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 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’appartenance directe

Cette commande ajoute une règle d’appartenance directe au regroupement d’appareils avec l’ID XYZ00056. Il ajoute la ressource avec l’ID 16777219 à la collection.

Add-CMDeviceCollectionDirectMembershipRule -CollectionId "XYZ00056" -ResourceId 16777219

Exemple 2 : Ajouter une règle d’appartenance directe à l’aide du pipeline

Cette commande utilise d’abord l’applet de commande Get-CMCollection pour obtenir l’objet de collection nommé testCollection. Il utilise ensuite l’opérateur de pipeline pour passer l’objet à l’applet de commande Add-CMDeviceCollectionDirectMembershipRule , qui ajoute la règle d’appartenance directe à l’objet de collection d’appareils. Il ajoute l’appareil avec l’ID 16777219 au regroupement.

Get-CMCollection -Name "testCollection" | Add-CMDeviceCollectionDirectMembershipRule -ResourceId 16777219

Paramètres

-CollectionId

Spécifiez l’ID du regroupement d’appareils 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
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 du regroupement d’appareils 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

-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

-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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InputObject

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

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

-Resource

Spécifiez un tableau d’objets de ressource à ajouter au regroupement d’appareils avec cette règle d’appartenance directe. Pour obtenir cet objet, utilisez l’applet de commande Get-CMResource ou l’applet de commande Get-CMDevice avec le -Resource paramètre .

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

-ResourceId

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

Type:Int32[]
Alias:ResourceIds
Position:Named
Valeur par défaut:None
Obligatoire:True
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