Set-CMCollection

Ссылка

Модуль:: ConfigurationManager

Настройка коллекции устройств или пользователей.

Синтаксис

Set-CMCollection
   [-Comment <String>]
   -InputObject <IResultObject>
   [-LimitingCollection <IResultObject>]
   [-LimitingCollectionId <String>]
   [-LimitingCollectionName <String>]
   [-NewName <String>]
   [-PassThru]
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-VariablePriority <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMCollection
   -CollectionId <String>
   [-Comment <String>]
   [-LimitingCollection <IResultObject>]
   [-LimitingCollectionId <String>]
   [-LimitingCollectionName <String>]
   [-NewName <String>]
   [-PassThru]
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-VariablePriority <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMCollection
   [-Comment <String>]
   [-LimitingCollection <IResultObject>]
   [-LimitingCollectionId <String>]
   [-LimitingCollectionName <String>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-VariablePriority <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Используйте этот командлет для настройки коллекции устройств или пользователей.

Ограничивающая коллекция определяет, какие ресурсы могут входить в коллекцию. Например, при использовании коллекции All Systems в качестве ограничивающей коллекции новая коллекция может включать любое устройство в иерархию Configuration Manager.

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

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

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

Примечание.

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

Примеры

Пример 1. Переименование коллекции

Первая команда получает объект коллекции с именем testUser и сохраняет его в переменной $userCollection .

Вторая команда обновляет имя коллекции.

$userCollection = Get-CMCollection -Name "testUser"
Set-CMCollection -InputObject $userCollection -NewName "newTestUser"

Параметры

-CollectionId

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

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Comment

Укажите необязательный комментарий для описания и идентификации этой коллекции.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Confirm

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

Тип:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DisableWildcardHandling

Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ForceWildcardHandling

Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-InputObject

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

Тип:	IResultObject
Aliases:	Collection
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-LimitingCollection

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

Тип:	IResultObject
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-LimitingCollectionId

Укажите идентификатор ограничивающей коллекции. Это значение является свойством CollectionID , например или XYZ00012SMS00001.

Тип:	String
Aliases:	LimitToCollectionId
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-LimitingCollectionName

Укажите имя ограничивающей коллекции.

Тип:	String
Aliases:	LimitToCollectionName
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Name

Укажите имя настраиваемой коллекции.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-NewName

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

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-PassThru

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

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-RefreshSchedule

Если для параметра RefreshType задано значение Periodic или Both, используйте этот параметр, чтобы задать расписание. Укажите объект расписания для, когда сайт выполняет полное обновление членства в коллекции. Чтобы получить этот объект, используйте командлет New-CMSchedule .

Тип:	IResultObject
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-RefreshType

Укажите способ обновления членства в коллекции:

Manual (1). Администратор вручную активирует обновление членства в консоли Configuration Manager или с помощью командлета Invoke-CMCollectionUpdate .
Periodic (2) Сайт выполняет полное обновление по расписанию. В нем не используются добавочные обновления. Если тип не указан, это значение будет использоваться по умолчанию.
Continuous (4). Сайт периодически оценивает новые ресурсы, а затем добавляет новых участников. Этот тип также называется добавочным обновлением. Он не выполняет полное обновление по расписанию.
Both (6): сочетание и PeriodicContinuous, с добавочными обновлениями и полным обновлением по расписанию.

Если указать или PeriodicBoth, используйте параметр RefreshSchedule , чтобы задать расписание.

Примечание.

Значение None (0) функционально совпадает с значением Manual.

Тип:	CollectionRefreshType
Допустимые значения:	None, Manual, Periodic, Continuous, Both
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-VariablePriority

Укажите целочисленное значение от 1 до 9 для приоритета переменных коллекции устройств. 1 — самый низкий приоритет, а 9 — самый высокий.

Чтобы настроить переменные в коллекции устройств, используйте командлет Set-CMDeviceCollectionVariable .

Чтобы просмотреть текущий приоритет переменной, используйте командлет Get-CMCollectionSetting .

Тип:	Int32
Aliases:	DeviceCollectionVariablePrecedence
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-WhatIf

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

Тип:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

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

System.Object

Поделиться через

Set-CMCollection

Синтаксис

Описание

Примеры

Пример 1. Переименование коллекции

Параметры

-CollectionId

-Comment

-Confirm

-DisableWildcardHandling

-ForceWildcardHandling

-InputObject

-LimitingCollection

-LimitingCollectionId

-LimitingCollectionName

-Name

-NewName

-PassThru

-RefreshSchedule

-RefreshType

-VariablePriority

-WhatIf

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

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

Обратная связь

Дополнительные ресурсы

Поделиться через

Set-CMCollection

Синтаксис

Описание

Примеры

Пример 1. Переименование коллекции

Параметры

-CollectionId

-Comment

-Confirm

-DisableWildcardHandling

-ForceWildcardHandling

-InputObject

-LimitingCollection

-LimitingCollectionId

-LimitingCollectionName

-Name

-NewName

-PassThru

-RefreshSchedule

-RefreshType

-VariablePriority

-WhatIf

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

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

Связанные ссылки

Обратная связь

Дополнительные ресурсы