Add-CMDeviceCollectionIncludeMembershipRule

Référence

Module:: ConfigurationManager

Ajoutez une règle d’appartenance Include à une collection d’appareils.

Syntax

Add-CMDeviceCollectionIncludeMembershipRule
   -CollectionName <String>
   -IncludeCollectionName <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMDeviceCollectionIncludeMembershipRule
   -CollectionName <String>
   -IncludeCollection <IResultObject>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMDeviceCollectionIncludeMembershipRule
   -CollectionName <String>
   -IncludeCollectionId <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMDeviceCollectionIncludeMembershipRule
   -CollectionId <String>
   -IncludeCollection <IResultObject>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMDeviceCollectionIncludeMembershipRule
   -CollectionId <String>
   -IncludeCollectionId <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMDeviceCollectionIncludeMembershipRule
   -CollectionId <String>
   -IncludeCollectionName <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMDeviceCollectionIncludeMembershipRule
   -InputObject <IResultObject>
   -IncludeCollection <IResultObject>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMDeviceCollectionIncludeMembershipRule
   -InputObject <IResultObject>
   -IncludeCollectionId <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMDeviceCollectionIncludeMembershipRule
   -InputObject <IResultObject>
   -IncludeCollectionName <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Utilisez cette cmdlet pour ajouter une règle d’appartenance Include à une collection d’appareils. Une règle d’appartenance Include inclut les membres d’une autre collection de la collection d’appareils dans laquelle 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 inclure une collection par défaut, afin que l’ID d’une collection incluse puisse commencer par SMS .

Configuration Manager met à jour dynamiquement l’appartenance à la collection d’appareils selon une planification si l’appartenance à la collection incluse change.

Lorsque vous ajoutez une règle d’appartenance Include à une collection, les ressources peuvent devenir membres de la collection. Cette action peut entraîner l’application de tout déploiement de logiciel ou de configuration aux appareils de la collection incluse.

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 Include

Cette commande ajoute la collection d’appareils nommée Tous les systèmes avec une règle d’appartenance Include. La règle est ajoutée à la collection d’appareils nommée Device.

Add-CMDeviceCollectionIncludeMembershipRule -CollectionName "Device" -IncludeCollectionName "All Systems"

Exemple 2 : ajouter une règle d’appartenance Include à une collection à l’aide du pipeline

Cette commande utilise d’abord l’cmdlet Get-CMCollection pour obtenir l’objet de collection cible nommé Device. Il utilise ensuite l’opérateur de pipeline pour transmettre l’objet à l’cmdlet Add-CMDeviceCollectionIncludeMembershipRule, qui ajoute une règle d’appartenance Include pour la collection d’appareils nommée All Systems.

Get-CMCollection -Name "Device" | Add-CMDeviceCollectionIncludeMembershipRule -IncludeCollectionName "All Systems"

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 les collections par défaut n’incluent pas de 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’appareils pour ajouter la règle.

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

-IncludeCollection

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

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

-IncludeCollectionId

Spécifiez l’ID de la collection incluse à ajouter à la règle. Cette valeur est la propriété CollectionID, par XYZ00012 exemple. Vous pouvez inclure des 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

-IncludeCollectionName

Spécifiez le nom de la collection incluse à 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’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

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

System.Object