New-CMUserCollection
Создание коллекции пользователей.
Синтаксис
New-CMUserCollection
[-Comment <String>]
-LimitingCollectionName <String>
-Name <String>
[-RefreshSchedule <IResultObject>]
[-RefreshType <CollectionRefreshType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMUserCollection
[-Comment <String>]
-InputObject <IResultObject>
-Name <String>
[-RefreshSchedule <IResultObject>]
[-RefreshType <CollectionRefreshType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMUserCollection
[-Comment <String>]
-LimitingCollectionId <String>
-Name <String>
[-RefreshSchedule <IResultObject>]
[-RefreshType <CollectionRefreshType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
С помощью этого комлета создается коллекция пользователей на основе определенной лимитирующей коллекции. Ограничивающая коллекция определяет, какие пользователи могут быть членами создаемой вами коллекции пользователей. Например, при использовании коллекции "Все пользователи" в качестве ограничивающей коллекции новая коллекция может включать любого пользователя в иерархию Configuration Manager.
Затем можно добавить пользователей в коллекцию с правилами членства. Чтобы добавить членов в коллекцию пользователей, используйте один из следующих правил членства:
- Add-CMUserCollectionDirectMembershipRule
- Add-CMUserCollectionExcludeMembershipRule
- Add-CMUserCollectionIncludeMembershipRule
- Add-CMUserCollectionQueryMembershipRule
Дополнительные сведения см. в подборке How to create collections in Configuration Manager.
Примечание
Запустите команды диспетчера конфигурации из диска веб-сайта Configuration Manager, например PS XYZ:\>
. Дополнительные сведения см. в дополнительных сведениях о том, как начать работу.
Примеры
Пример 1. Создание коллекции пользователей
Эта команда создает коллекцию для всех пользователей отдела продаж. Указание всех пользователей для параметра LimitingCollectionName указывает на то, что новая коллекция может включать любого пользователя в иерархию Configuration Manager.
New-CMUserCollection -Name "Sales" -LimitingCollectionName "All Users"
Параметры
-Comment
Укажите необязательный комментарий для описания и определения этой коллекции.
Type: | String |
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 |
-InputObject
Укажите объект для ограничивающего сбора. Чтобы получить этот объект, используйте cmdlets Get-CMCollection или Get-CMUserCollection.
Type: | IResultObject |
Aliases: | LimitingCollection |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LimitingCollectionId
Укажите ID ограничивающего сбора. Это значение является свойством CollectionID, например, XYZ00012
или SMS00001
.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LimitingCollectionName
Укажите имя лимита коллекции.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Укажите имя новой коллекции пользователей.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RefreshSchedule
Если параметр RefreshType задан либо или, используйте этот Periodic
параметр для Both
заданного расписания. Укажите объект расписания для того, когда на сайте выполняется полное обновление членства в коллекции. Чтобы получить этот объект, используйте cmdlet New-CMSchedule.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RefreshType
Укажите, как обновляется членство в коллекции:
Manual
(1). Администратор вручную запускает обновление членства в консоли Configuration Manager или с помощью команды Invoke-CMCollectionUpdate.Periodic
(2). Сайт делает полное обновление по расписанию. Он не использует дополнительные обновления. Если вы не указываете тип, это значение является по умолчанию.Continuous
(4): Сайт периодически оценивает новые ресурсы, а затем добавляет новых участников. Этот тип также известен как постепенное обновление. Он не обновляется в полном объеме по расписанию.Both
(6): сочетание как дополнительных обновлений, так и полного обновленияPeriodic
Continuous
по расписанию.
Если вы указываете Periodic
или Both
используете параметр RefreshSchedule, чтобы задать расписание.
Примечание
Значение None
(0) функционально такое же, как Manual
.
Type: | CollectionRefreshType |
Accepted values: | None, Manual, Periodic, Continuous, Both |
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