Add-CMUserCollectionExcludeMembershipRule

Ссылка

Модуль:: ConfigurationManager

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

Синтаксис

Add-CMUserCollectionExcludeMembershipRule
   -CollectionName <String>
   -ExcludeCollectionName <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMUserCollectionExcludeMembershipRule
   -CollectionName <String>
   -ExcludeCollection <IResultObject>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMUserCollectionExcludeMembershipRule
   -CollectionName <String>
   -ExcludeCollectionId <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMUserCollectionExcludeMembershipRule
   -CollectionId <String>
   -ExcludeCollection <IResultObject>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMUserCollectionExcludeMembershipRule
   -CollectionId <String>
   -ExcludeCollectionId <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMUserCollectionExcludeMembershipRule
   -CollectionId <String>
   -ExcludeCollectionName <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMUserCollectionExcludeMembershipRule
   -InputObject <IResultObject>
   -ExcludeCollection <IResultObject>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMUserCollectionExcludeMembershipRule
   -InputObject <IResultObject>
   -ExcludeCollectionId <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMUserCollectionExcludeMembershipRule
   -InputObject <IResultObject>
   -ExcludeCollectionName <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

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

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

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

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

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

Примечание

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

Примеры

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

Эта команда исключает членов **** коллекции удаленных пользователей, которая имеет ID XYZ00017, из коллекции пользователей с ID XYZ00012.

Add-CMUserCollectionExcludeMembershipRule -CollectionId "XYZ00012" -ExcludeCollectionId "XYZ00017"

Параметры

-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

-ExcludeCollection

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

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

-ExcludeCollectionId

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

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

-ExcludeCollectionName

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

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

-InputObject

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

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