Partager via


Get-CMCollectionDirectMembershipRule

Obtenir une règle d’appartenance directe pour un regroupement d’appareils ou d’utilisateurs.

Syntaxe

Get-CMCollectionDirectMembershipRule
   -CollectionName <String>
   [-ResourceName <String>]
   [<CommonParameters>]
Get-CMCollectionDirectMembershipRule
   -CollectionName <String>
   -Resource <IResultObject>
   [<CommonParameters>]
Get-CMCollectionDirectMembershipRule
   -CollectionName <String>
   -ResourceId <String>
   [<CommonParameters>]
Get-CMCollectionDirectMembershipRule
   -CollectionId <String>
   -Resource <IResultObject>
   [<CommonParameters>]
Get-CMCollectionDirectMembershipRule
   -CollectionId <String>
   -ResourceId <String>
   [<CommonParameters>]
Get-CMCollectionDirectMembershipRule
   -CollectionId <String>
   [-ResourceName <String>]
   [<CommonParameters>]
Get-CMCollectionDirectMembershipRule
   -InputObject <IResultObject>
   -Resource <IResultObject>
   [<CommonParameters>]
Get-CMCollectionDirectMembershipRule
   -InputObject <IResultObject>
   -ResourceId <String>
   [<CommonParameters>]
Get-CMCollectionDirectMembershipRule
   -InputObject <IResultObject>
   [-ResourceName <String>]
   [<CommonParameters>]

Description

Utilisez cette applet de commande pour obtenir une ou plusieurs règles d’appartenance directe pour un regroupement d’appareils ou d’utilisateurs. Une règle d’appartenance directe vous permet de choisir explicitement les membres du regroupement d’appareils. Les collections par défaut n’ont pas de règles d’appartenance directe. 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 : Obtenir toutes les règles d’appartenance directe pour une collection par nom

Cette commande obtient les règles d’appartenance directe pour le regroupement nommé Device01.

Get-CMCollectionDirectMembershipRule -CollectionName "Device01"

Exemple 2 : Obtenir toutes les règles d’appartenance directe à l’aide du pipeline

Cette commande utilise l’applet de commande Get-CMCollection pour obtenir l’objet de collection nommé User02. Il utilise ensuite l’opérateur de pipeline pour passer l’objet à l’applet de commande Get-CMCollectionDirectMembershipRule .

Get-CMCollection -Name "User02" | Get-CMCollectionDirectMembershipRule

Paramètres

-CollectionId

Spécifiez l’ID de la collection pour obtenir la règle. Cette valeur est la propriété CollectionID, par exemple . XYZ00012 Étant donné que les collections par défaut ne peuvent pas avoir de règles d’appartenance directe, 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 pour obtenir 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

-InputObject

Spécifiez un objet pour la collection afin d’obtenir la règle. Pour obtenir cet objet, utilisez les applets de commande Get-CMCollection, Get-CMDeviceCollection 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

-Resource

Spécifiez une ressource, un appareil ou un objet utilisateur pour obtenir sa règle d’appartenance directe à partir de la collection. Pour obtenir cet objet, utilisez les applets de commande Get-CMResource, Get-CMDevice ou Get-CMUser .

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

-ResourceId

Spécifiez l’ID de la ressource pour obtenir sa règle d’appartenance directe à partir de la collection. Cette valeur est la propriété ResourceID , par exemple 16777219.

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

-ResourceName

Spécifiez le nom de l’appareil ou de l’utilisateur pour obtenir sa règle d’appartenance directe à partir du regroupement.

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

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

System.Object

Notes

Cette applet de commande est similaire à Get-CMDeviceCollectionDirectMembershipRule et Get-CMUserCollectionDirectMembershipRule, qui sont spécifiques au type de collection. Cette applet de commande fonctionne avec des regroupements d’appareils ou d’utilisateurs.