Класс WMI сервера SMS_Collection

Класс SMS_Collection WMI — это класс сервера поставщика SMS в Configuration Manager. Он представляет коллекцию ресурсов, логически связанных правилами, а также сведения о сборе.

Следующий синтаксис упрощен в коде MOF и включает все унаследованные свойства.

Синтаксис

Class SMS_Collection : SMS_BaseClass
{
   String CollectionID;
   SMS_CollectionRule CollectionRules[];
   UInt32 CollectionType;
   SInt32 CollectionVariablesCount;
   String Comment;
   UInt32 CurrentStatus;
   Uint32 FullEvaluationRunTime;
   Uint32 FullEvaluationMemberChanges;
   DateTime FullEvaluationMemberChangeTime;
   DateTime FullEvaluationLastRefreshTime;
   DateTime FullEvaluationNextRefreshTime;
   Boolean HasProvisionedMember;
   SInt32 IncludeExcludeCollectionsCount;
   Uint32 IncrementalEvaluationRunTime;
   Uint32 IncrementalEvaluationMemberChanges;
   DateTime IncrementalEvaluationMemberChangeTime;
   DateTime IncrementalEvaluationLastRefreshTime;
   Boolean IsBuiltIn;
   Boolean IsReferenceCollection;
   UInt8 ISVData[];
   UInt32 ISVDataSize;
   String ISVString;
   DateTime LastChangeTime;
   DateTime LastMemberChangeTime;
   DateTime LastRefreshTime;
   String LimitToCollectionID;
   String LimitToCollectionName;
   SInt32 LocalMemberCount;
   String MemberClassName;
   SInt32 MemberCount;
   UInt32 MonitoringFlags;
   String Name;
   Boolean OwnedByThisSite;
   SInt32 PowerConfigsCount;
   SMS_ScheduleToken RefreshSchedule[];
   UInt32 RefreshType;
   Boolean ReplicateToSubSites;
   SInt32 ServiceWindowsCount;
   Boolean UseCluster;
};

Методы

В классе доступны следующие методы SMS_Collection :

• Метод AddMembershipRule: добавляет одно новое правило в CollectionRules свойство SMS_Collection.
• Метод AddMembershipRules: добавляет несколько новых правил в CollectionRules свойство SMS_Collection.
• Метод ApproveClients: утверждает указанные клиентские компьютеры для присоединения к сайту.
• Метод BlockClients: блокирует взаимодействие указанных клиентских компьютеров с сайтом.
• Метод ChangeOwnership: изменяет владельца компьютеров на владельца устройства.
• Метод ClearDeploymentLocksForCollection: очищает блокировки развертывания для выбранной коллекции.
• Метод ClearDeviceCategory. Очищает категорию из набора устройств.
• Метод ClearLastNBSAdvForCollection: очищает последнее развертывание PXE для выбранной коллекции.
• Метод ClearLastNBSAdvForMachines: очищает последнее развертывание PXE для выбранных клиентских компьютеров.
• Метод ClientEditions. Извлекает список выпусков клиента.
• Метод CreateCCR. Создает запрос конфигурации клиента (CCR) для определенного ресурса.
• Метод CreateCCR. Создает запросы конфигурации клиента (CCR) для компьютеров в коллекции.
• Метод DeleteAllMembers. Удаляет все члены коллекции, то есть ресурсы и данные обнаружения.
• Метод DeleteMembershipRule: удаляет правило членства из коллекции.
• Метод DeleteMembershipRules: удаляет несколько правил членства из коллекции.
• Метод FindResourceSite: получает сведения о коде сайта для компьютера из базы данных сайта.
• Метод FindMachineSite: возвращает сведения о коде сайта для ресурсов из базы данных сайта.
• Метод GetDependency. Начиная с версии 2010, получите сведения о связях коллекции, от которых зависит входная коллекция.
• Метод GetDependent. Начиная с версии 2010, получите сведения о связях коллекции, которые зависят от входной коллекции.
• Метод GetNumResults. Получает количество всех членов в коллекции, за исключением вложенных сборок.
• Метод GenerateCCRByName: создает запрос конфигурации клиента по имени компьютера.
• Метод GetTotalNumResults: возвращает количество всех элементов в коллекции, включая вложенные коллекции.
• Метод ReassignClientsToSite: переназначает сайт для клиентов в списке.
• Метод RequestRefresh: активирует повторную оценку членства в коллекции компонентом Configuration Manager оценщика коллекции.
• Метод SetDeviceCategory. Назначает категорию набору устройств.
• Метод SetMemberOrder: задает порядок членов коллекции.
• Метод UpdateVisibilityInEPDashBoard. Покажите эту коллекцию на панели мониторинга защиты конечных точек.
• Метод VerifyNoCircularDependencies. Проверяет отсутствие циклических зависимостей, если одна коллекция является родительской для другой.

Свойства

CollectionID

Тип данных: String

Тип доступа: только для чтения

Квалификаторы: [ключ, чтение]

Уникальный автоматически созданный идентификатор для этой коллекции, содержащий восемь символов.

Формат идентификатора коллекции — это код сайта, создавший коллекцию, за которым следует пятизначный шестнадцатеричный серийный номер, например JAX0002C. В коллекциях по умолчанию Configuration Manager используется префикс SMS, например SMS00001.

CollectionRules

Тип данных: SMS_CollectionRule array

Тип доступа: чтение и запись

Квалификаторы: [ленивый]

SMS_CollectionRule объекты класса WMI сервера, определяющие критерии членства для коллекции.

CollectionType

Тип данных: UInt32

Тип доступа: только для чтения

Квалификаторы: [чтение, перечисление]

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

Значение	Тип коллекции
0	Прочее
1	User
2	Device

CollectionVariablesCount

Тип данных: SInt32

Тип доступа: только для чтения

Квалификаторы: [read]

Количество переменных коллекции.

Comment

Тип данных: String

Тип доступа: чтение и запись

Квалификаторы: Нет

Общий комментарий или примечание, что документирует коллекцию.

CurrentStatus

Тип данных: UInt32

Тип доступа: только для чтения

Квалификаторы: [чтение, перечисление]

Текущее состояние коллекции. Возможные значения:

Значение	Текущее состояние
0	Нет
1	Ready
2	Обновление
3	Сохранение
4	Оценки
5	Ожидание обновления
6	Удаление
7	Добавление элемента
8	Запрос

FullEvaluationRunTime

Тип данных: Uint32

Тип доступа: только для чтения

Квалификаторы: [read]

Начиная с версии 2010, время выполнения полной оценки в секундах.

FullEvaluationMemberChanges

Тип данных: Uint32

Тип доступа: только для чтения

Квалификаторы: [read]

Начиная с версии 2010 количество элементов изменяется после полной оценки.

FullEvaluationMemberChangeTime

Тип данных: Datetime

Тип доступа: только для чтения

Квалификаторы: [read]

Начиная с версии 2010, в последний раз, когда членство изменялось с полной оценки.

FullEvaluationLastRefreshTime

Тип данных: Datetime

Тип доступа: только для чтения

Квалификаторы: [read]

Начиная с версии 2010, время последнего обновления полной оценки.

FullEvaluationNextRefreshTime

Тип данных: Datetime

Тип доступа: только для чтения

Квалификаторы: [read]

Начиная с версии 2010, время следующего обновления полной оценки.

HasProvisionedMember

Тип данных: Boolean

Тип доступа: только для чтения

Квалификаторы: [read]

true Значение , если в этой коллекции есть подготовленные члены.

IncludeExcludeCollectionsCount

Тип данных: SInt32

Тип доступа: только для чтения

Квалификаторы: [read]

Количество коллекций, включенных и исключенных из этой коллекции.

IncrementalEvaluationRunTime

Тип данных: Uint32

Тип доступа: только для чтения

Квалификаторы: [read]

Начиная с версии 2010, время выполнения добавочной оценки в секундах.

IncrementalEvaluationMemberChanges

Тип данных: Uint32

Тип доступа: только для чтения

Квалификаторы: [read]

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

IncrementalEvaluationMemberChangeTime

Тип данных: Datetime

Тип доступа: только для чтения

Квалификаторы: [read]

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

IncrementalEvaluationLastRefreshTime

Тип данных: Datetime

Тип доступа: только для чтения

Квалификаторы: [read]

Начиная с версии 2010, время последнего обновления добавочной оценки.

IsBuiltIn

Тип данных: Boolean

Тип доступа: Read-Only

Квалификаторы: [read]

Если это значение равно true, коллекция встроена. Например, Все системы.

IsReferenceCollection

Тип данных: Boolean

Тип доступа: только для чтения

Квалификаторы: [read]

Если это значение равно true, коллекция не ограничивается другой коллекцией.

ISVData

Тип данных: UInt8[]

Тип доступа: чтение и запись

Квалификаторы: [большой, ленивый]

Пространство данных для расширения партнера.

ISVDataSize

Тип данных: UInt32

Тип доступа: чтение и запись

Квалификаторы: [ленивый]

Размер ISVData.

ISVString

Тип данных: String

Тип доступа: чтение и запись

Квалификаторы: нет

Строка для расширяемости партнера.

LastChangeTime

Тип данных: DateTime

Тип доступа: чтение и запись

Квалификаторы: Нет

Дата и время последнего изменения коллекции.

LastMemberChangeTime

Тип данных: DateTime

Тип доступа: чтение и запись

Квалификаторы: Нет

Дата и время последнего изменения членства в коллекции.

LastRefreshTime

Тип данных: DateTime

Тип доступа: чтение и запись

Квалификаторы: Нет

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

LimitToCollectionID

Тип данных: String

Тип доступа: чтение и запись

Квалификаторы: Нет

Идентификатор ограничивающей коллекции.

LimitToCollectionName

Тип данных: DateTime

Тип доступа: чтение и запись

Квалификаторы: Нет

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

LocalMemberCount

Тип данных: SInt32

Тип доступа: только для чтения

Квалификаторы: [read]

Количество участников, видимых на локальном сайте.

MemberClassName

Тип данных: String

Тип доступа: только для чтения

Квалификаторы: [read]

Имя класса, содержащего члены этой коллекции. Configuration Manager не хранит члены коллекции в SMS_Collection. Сайт динамически создает имя класса-члена и является производным от SMS_CM_RES_COLL_CollectionID класса WMI сервера.

MemberCount

Тип данных: SInt32

Тип доступа: только для чтения

Квалификаторы: [read]

Количество элементов коллекции.

MonitoringFlags

Тип данных: UInt32

Тип доступа: только для чтения

Квалификаторы: [read]

Включает коллекцию для определенных видов мониторинга.

Name

Тип данных: String

Тип доступа: чтение и запись

Квалификаторы: [Not_null]

Имя коллекции. Это значение представляет коллекцию в консоли Configuration Manager и должно быть уникальным.

OwnedByThisSite

Тип данных: Boolean

Тип доступа: чтение и запись

Квалификатор: None

trueЗначение , если коллекция возникла на локальном сайте Configuration Manager. Значение по умолчанию — false.

PowerConfigsCount

Тип данных: SInt32

Тип доступа: только для чтения

Квалификатор: [чтение]

Количество конфигураций питания.

RefreshSchedule

Тип данных: SMS_ScheduleToken array

Тип доступа: чтение и запись

Квалификаторы: [max(15), ленивый]

SMS_ScheduleToken объекты класса WMI сервера , указывающие на расписание обновления или обновления для коллекции. Сайт обновляет членство в коллекции только в том случае, если приложение задает расписание или вызывает метод RequestRefresh в классе SMS_Collection . Чтобы средство оценки коллекции использовало расписание, задайте RefreshType для свойства значение periodic (2).

RefreshType

Тип данных: UInt32

Тип доступа: чтение и запись

Квалификаторы: [ленивый, перечисление]

Это значение указывает, как Configuration Manager обновляет коллекцию. Значение по умолчанию — manual (1). Возможные значения:

Значение	Тип обновления
1	Manual
2	Периодические
4	Обновление константы

Чтобы обновление основывалось на расписании, указанном в RefreshSchedule, присвойте этому свойству значение периодическое (2). Если для этого свойства задано значение вручную (1), обновите коллекцию с помощью метода RequestRefresh.

ReplicateToSubSites

Это свойство не реализовано.

ServiceWindowsCount

Тип данных: SInt32

Тип доступа: только для чтения

Квалификаторы: [read]

Количество периодов обслуживания для этой коллекции.

UseCluster

Тип данных: Boolean

Тип доступа: только для чтения

Квалификаторы: [read]

Указывает, что эта коллекция является группой серверов.

Замечания

Квалификаторы классов для этого класса включают:

• Защищенная

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

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

При выполнении запроса к динамической коллекции, представленной SMS_Collection, убедитесь, что поставщик SMS загружен или что другой метод или запрос уже выполнен.

Приложение должно использовать SMS_Collection методы для добавления, обновления или удаления правил членства, определенных свойством CollectionRules . Это свойство не извлекается, когда приложение перечисляет SMS_Collection. Чтобы получить правила сбора для коллекции, приложение должно использовать IWbemServices::GetObject или SWbemServices::Get. Дополнительные сведения см. в разделе квалификаторы контекста Configuration Manager.

Требования

Требования к среде выполнения

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

Требования к разработке

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

См. также

Класс WMI сервера SMS_CollectionRule