Add-CMUserCollectionIncludeMembershipRule

  • Ссылка
Модуль:
ConfigurationManager

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

Синтаксис

Add-CMUserCollectionIncludeMembershipRule
   -CollectionName <String>
   -IncludeCollectionName <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMUserCollectionIncludeMembershipRule
   -CollectionName <String>
   -IncludeCollection <IResultObject>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMUserCollectionIncludeMembershipRule
   -CollectionName <String>
   -IncludeCollectionId <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMUserCollectionIncludeMembershipRule
   -CollectionId <String>
   -IncludeCollection <IResultObject>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMUserCollectionIncludeMembershipRule
   -CollectionId <String>
   -IncludeCollectionId <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMUserCollectionIncludeMembershipRule
   -CollectionId <String>
   -IncludeCollectionName <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMUserCollectionIncludeMembershipRule
   -InputObject <IResultObject>
   -IncludeCollection <IResultObject>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMUserCollectionIncludeMembershipRule
   -InputObject <IResultObject>
   -IncludeCollectionId <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMUserCollectionIncludeMembershipRule
   -InputObject <IResultObject>
   -IncludeCollectionName <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

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

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

Configuration Manager динамически обновляет членство в коллекции пользователей по расписанию, если членство в включенной коллекции меняется.

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

Дополнительные сведения см. в статье Создание коллекций в Configuration Manager.

Примечание.

Выполните командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>. Дополнительные сведения см. в статье Начало работы.

Примеры

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

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

Add-CMUserCollectionIncludeMembershipRule -CollectionName "Users" -IncludeCollectionName "All Users"

Параметры

-CollectionId

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

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

-CollectionName

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

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

-Confirm

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

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

-IncludeCollection

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

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

-IncludeCollectionId

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

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

-IncludeCollectionName

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

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

-InputObject

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

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

-PassThru

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

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

-WhatIf

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

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

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

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

System.Object