Add-CMDeviceCollectionIncludeMembershipRule

Ссылка

Модуль:: ConfigurationManager

Добавьте правило членства в коллекцию устройств.

Синтаксис

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>]

Описание

Используйте этот список, чтобы добавить правило о включаемом членстве в коллекцию устройств. Правило членства включает членов другой коллекции в коллекцию устройств, в которой применяется это правило.

Нельзя добавлять правила членства в коллекции по умолчанию. В любой коллекции, на которую вы нацелены, должен быть ID, который начинается с кода сайта, а не SMS . Вы можете включить коллекцию по умолчанию, чтобы начать с ID включенной SMS коллекции.

Диспетчер конфигурации динамически обновляет членство в коллекции устройств по расписанию, если меняется членство в включенной коллекции.

При добавлении правила членства в коллекцию ресурсы могут стать членами коллекции. Это действие может привести к тому, что любое развертывание программного обеспечения или конфигурации будет применяться к устройствам в включенной коллекции.

Дополнительные сведения см. в подборке How to create collections in Configuration Manager.

Примечание

Запустите команды диспетчера конфигурации из диска веб-сайта Configuration Manager, например PS XYZ:\> . Дополнительные сведения см. в дополнительных сведениях о том, как начать работу.

Примеры

Пример 1. Добавление правила о включаемом членстве

Эта команда добавляет коллекцию устройств с именем All Systems с правилом членства. Правило добавляется в коллекцию устройств с именем Device.

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

Пример 2. Добавление правила членства в коллекцию с помощью конвейера

Эта команда сначала использует командлет Get-CMCollection для получения объекта целевой коллекции с именем Device. Затем оператор конвейера передает объект в кодлет Add-CMDeviceCollectionIncludeMembershipRule, который добавляет правило членства для коллекции устройств с именем All Systems.

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

Параметры

-CollectionId

Укажите ID коллекции устройств, чтобы добавить правило. Это значение является свойством CollectionID, XYZ00012 например. Так как в коллекциях по умолчанию нет правил членства, этот код начинается с кода сайта, а не SMS .

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

-CollectionName

Укажите имя коллекции устройств, чтобы добавить правило.

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

-Confirm

Перед запуском командлет запросит подтверждение.

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

-IncludeCollection

Укажите объект для включенной коллекции, чтобы добавить в правило. Чтобы получить этот объект, используйте cmdlets Get-CMCollection или Get-CMDeviceCollection.

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

-IncludeCollectionId

Укажите ID включенной коллекции, чтобы добавить в правило. Это значение является свойством CollectionID, XYZ00012 например. Вы можете включить коллекции по умолчанию, поэтому это значение может начинаться с кода сайта или SMS .

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

-IncludeCollectionName

Укажите имя включенной коллекции, чтобы добавить в правило.

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

-InputObject

Укажите объект для коллекции устройств, чтобы добавить правило. Чтобы получить этот объект, используйте cmdlets Get-CMCollection или Get-CMDeviceCollection.

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

-PassThru

Добавьте этот параметр, чтобы вернуть объект, который представляет элемент, с которым вы работаете. По умолчанию этот комдлет может не создавать выходных данных.

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

-WhatIf

Показывает, что произойдет при запуске этого командлета. Этот комдлет не работает.

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

Входные данные

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Выходные данные

System.Object