Partager via

Add-CMDeviceCollectionDirectMembershipRule

  • Référence
Module:
ConfigurationManager

Ajouter une règle d’appartenance directe à une collection d’appareils.

Syntax

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 cmdlet pour ajouter une règle d’appartenance directe à une collection d’appareils. Une règle d’appartenance directe vous permet de choisir explicitement les membres de la collection d’appareils. 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 . 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’appartenance directe

Cette commande ajoute une règle d’appartenance directe à la collection d’appareils avec l’ID XYZ00056. Il ajoute la ressource avec ident 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’cmdlet Get-CMCollection pour obtenir l’objet de collection nommé testCollection. Il utilise ensuite l’opérateur de pipeline pour transmettre l’objet à l’cmdlet Add-CMDeviceCollectionDirectMembershipRule, qui ajoute la règle d’appartenance directe à l’objet de collection d’appareils. Il ajoute l’appareil avec un ID 16777219 à la collection.

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

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’appareils pour ajouter la règle. Cette valeur est la propriété CollectionID, par XYZ00012 exemple. Étant donné que vous ne pouvez pas ajouter de règles d’appartenance à des collections par défaut, cet ID commence par le code de site et non SMS par .

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

-CollectionName

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

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

-DisableWildcardHandling

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

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

-InputObject

Spécifiez un objet pour la collection d’appareils pour ajouter la règle. Pour obtenir cet objet, utilisez les cmdlets Get-CMCollection ou Get-CMDeviceCollection.

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

-Resource

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

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

-ResourceId

Spécifiez un tableau d’ID des ressources à ajouter à la collection d’appareils 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
Accept pipeline input:False
Accept wildcard characters:False

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

System.Object