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

Класс SMS_Advertisement инструментария управления Windows (WMI) — это класс сервера поставщика SMS в Configuration Manager, который представляет объявление, используемое для объявления программ программного пакета, доступных для запуска на клиентах.

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

Синтаксис

Class SMS_Advertisement : SMS_BaseClass  
{  
      UInt32 ActionInProgress;  
      UInt32 AdvertFlags;  
      String AdvertisementID;  
      String AdvertisementName;  
      SMS_ScheduleToken AssignedSchedule[];  
      Boolean AssignedScheduleEnabled;  
      Boolean AssignedScheduleIsGMT;  
      UInt32 AssignmentID;  
      String CollectionID;  
      String Comment;  
      UInt32 DeviceFlags;  
      DateTime ExpirationTime;  
      Boolean ExpirationTimeEnabled;  
      Boolean ExpirationTimeIsGMT;  
      String HierarchyPath;  
      Boolean IncludeSubCollection;  
      UInt8 ISVData[];  
      UInt32 ISVDataSize;  
      String ISVString;  
      UInt32 MandatoryCountdown;  
      UInt32 OfferType;  
      String PackageID;  
      DateTime PresentTime;  
      Boolean PresentTimeEnabled;  
      Boolean PresentTimeIsGMT;  
      UInt32 Priority;  
      String ProgramName;  
      UInt32 RemoteClientFlags;  
      String SourceSite;  
      UInt32 TimeFlags;  
};  

Методы

В следующей таблице перечислены методы в SMS_Advertisement классе .

Метод	Описание
Метод GetAdvertisements в классе SMS_Advertisement	Возвращает идентификаторы объявлений, предназначенные для ресурса.
Метод GetNextID в классе SMS_Advertisement	Извлекает идентификатор, который будет использоваться для следующего созданного объявления.
Метод RiskyDeploymentStatusMessage в классе SMS_Advertisement	Отправляет предупреждающее сообщение о состоянии развертывания пользователя в коллекцию рискованных данных.
Метод SetNextID в SMS_Advertisement класса	Задает идентификатор, который будет использоваться для следующего созданного объявления.
Метод SetSourceSite в классе SMS_Advertisement	Задает исходный код сайта для объявления.
Метод Разблокировки в SMS_Advertisement класса	Задает исходный сайт для текущего сайта, разблокируя объявление. Предупреждение: Этот метод является устаревшим.

Свойства

ActionInProgress

Тип данных: UInt32

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

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

Текущее действие, выполняеме с пакетом Configuration Manager. Возможные значения:

Значение	Описание
0	Ни один
1	UPDATE
2	Добавить

AdvertFlags

Тип данных: UInt32

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

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

Флаги, указывающие, как объявление должно быть объявлено пользователю. Ниже перечислены возможные значения. Значение по умолчанию равно 0.

Шестнадцатеричный (бит)	Описание
0x00000020 (5)	НЕМЕДЛЕННОГО. Немедленно объявите объявление пользователю.
0x00000100 (8)	ONSYSTEMSTARTUP. Объявите объявление пользователю при запуске системы.
0x00000200 (9)	ONUSERLOGON. Объявите объявление пользователю при входе в систему.
0x00000400 (10)	ONUSERLOGOFF. Объявите объявление пользователю при выходе из системы.
0x00001000 (12)	НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТРЗАГРУЗИТЬ. Если выбранная архитектура и язык соответствуют архитектуре и языку клиента, содержимое пакета будет скачано заранее.
0x00008000 (15)	WINDOWS_CE. Объявление предназначено для клиента устройства.
0x00010000 (16)	ENABLE_PEER_CACHING. Эта информация относится к System Center 2012 Configuration Manager с пакетом обновления 1 (SP1) или более поздней версии, а также System Center 2012 R2 Configuration Manager или более поздней версии.
0x00020000 (17)	DONOT_FALLBACK. Не возвращайтесь к незащищенным точкам распространения.
0x00040000 (18)	ENABLE_TS_FROM_CD_AND_PXE. Последовательность задач доступна для съемных носителей и точки обслуживания среды выполнения перед загрузкой (PXE).
0x00080000 (19)	APTSINTRANETONLY.
0x00100000 (20)	OVERRIDE_SERVICE_WINDOWS. Переопределите периоды обслуживания при объявлении объявления пользователю.
0x00200000 (21)	REBOOT_OUTSIDE_OF_SERVICE_WINDOWS. Перезагрузите за пределами периодов обслуживания.
0x00400000 (22)	WAKE_ON_LAN_ENABLED. Объявите объявление пользователю с включенным пробуждением по локальной сети.
0x00800000 (23)	SHOW_PROGRESS. Объявите объявление пользователю, показывающее ход выполнения последовательности задач.
0x02000000 (25)	NO_DISPLAY. Пользователь не должен запускать программы независимо от назначения.
0x04000000 (26)	ONSLOWNET. Назначения являются обязательными при медленном сетевом подключении.
0x10000000 (28)	TARGETTOWINPE. Это развертывание предназначено только для WinPE.
0x20000000 (29)	HIDDENINWINPE. Нацеливание этого развертывания только на WinPE, но скрытие в WinPE. Его можно использовать только переменной TS SMSTSPreferredAdvertID.

Эти флаги должны быть согласованы с флагами, указанными в свойстве ProgramFlags объявленной программы. Например, если задать ONUSERLOGOFF, необходимо установить флаг NOUSERLOGGEDIN в программе. Если параметры флага не совпадают, программа не объявляется. Дополнительные сведения см. в разделе класс WMI сервера SMS_Program.

Задание IMMEDIATE, ONUSERLOGON или ONUSERLOGOFF или указание AssignedSchedule значения делает объявленную программу обязательной. Обязательная программа запускается автоматически после того, как клиент получит объявление. Клиент не может отклонить или отложить установку.

Задайте биты NO_DISPLAY и ONSLOWNET, только если задан бит IMMEDIATE, ONUSERLOGON или ONUSERLOGOFF или программа имеет AssignedSchedule значение.

Задайте NO_DISPLAY, если пользователь не хочет запускать программы независимо от назначения. Если этот флаг не задан, объявление отображается в списке объявлений и может выполняться независимо от назначения. Программа по-прежнему может быть обязательной.

Установите ONSLOWNET, если назначения являются обязательными при медленном сетевом подключении, например при подключении компьютера с помощью модема.

AdvertisementID

Тип данных: String

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

Квалификаторы: [key, ResID(801), ResDLL("SMS_RSTT.dll")]

Уникальный автоматически созданный ключ, который идентифицирует объявление. Значение по умолчанию — "".

AdvertisementName

Тип данных: String

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

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

Уникальное понятное имя объявления.

AssignedSchedule
Тип данных: SMS_ScheduleToken Array

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

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

SMS_ScheduleToken объекты класса WMI сервера , указывающие время, когда объявление становится обязательным для клиентов.

AssignedScheduleEnabled

Тип данных: Boolean

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

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

true Значение , если расписание, определенное в свойстве AssignedSchedule , активно. Значение по умолчанию — false.

AssignedScheduleIsGMT

Тип данных: Boolean

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

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

true Значение , если расписание, определенное в свойстве AssignedSchedule , находится в универсальном времени метрик (UMT). Значение по умолчанию — false.

AssignmentID

Тип данных: UInt32

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

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

Идентификатор назначения, связанного с объявлением.

CollectionID

Тип данных: String

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

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

Существующая коллекция, к которой предназначено объявление.

Comment

Тип данных: String

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

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

Простое описание или примечание о объявлении. Значение по умолчанию — "".

DeviceFlags

Тип данных: UInt32

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

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

Флаги, описывающие устройство. Ниже перечислены возможные значения. Значение по умолчанию равно 0.

Шестнадцатеричный (бит)	Описание
0x01000000 (24)	Всегда назначайте программу клиенту.
0x02000000 (25)	Назначьте, только если устройство в настоящее время подключено к подключению с высокой пропускной способностью (по умолчанию более 60 КБ/с).
0x04000000 (26)	Назначьте только в том случае, если устройство закреплено, то есть подключено к рабочему столу, использующим ActiveSync.

ExpirationTime

Тип данных: DateTime

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

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

Дата и время, когда объявление больше не доступно для клиентов. Значение по умолчанию — 19900101000000,000000+***.

ExpirationTimeEnabled

Тип данных: Boolean

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

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

true Значение , если срок действия объявления истекает в момент, указанный свойством ExpirationTime . Значение по умолчанию — false.

ExpirationTimeIsGMT

Тип данных: Boolean

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

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

true Значение , если время, определенное в свойстве ExpirationTime , находится в UMT. Значение по умолчанию — false.

HierarchyPath

Тип данных: String

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

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

Защищены.

IncludeSubCollection

Тип данных: Boolean

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

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

true (по умолчанию), если объявление объявляется во вложенных коллекциях указанной коллекции.

ISVData

Тип данных: Uint8 Array

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

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

Сведения, позволяющие одному isV хранить данные, связанные с экземпляром SMS_Program . Для этих данных нет ограничений или определенных форматов. Однако важно не перезаписывать свойство после того, как оно будет установлено. Поэтому вызывающее приложение сначала должно считывать существующие данные в этом свойстве. Если данные не принадлежат приложению, их не следует изменять. Любой владелец программного обеспечения или приложения, использующий это свойство, должен включать в данные идентификатор, чтобы можно было легко установить владение.

ISVDataSize

Тип данных: UInt32

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

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

Размер данных, представленных свойством ISVData . Значение по умолчанию равно 0.

ISVString

Тип данных: String

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

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

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

MandatoryCountdown

Тип данных: UInt32

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

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

Длительность (в минутах) для отображения уведомления пользователя о развертывании операционной системы обязательного обратного отсчета расписания. Значение по умолчанию равно 0.

OfferType

Тип данных: UInt32

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

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

Тип объявления, указывающий, что объявление предназначено для пользователей.

Значение	Описание
0	Обязательный
2	Доступно

PackageID

Тип данных: String

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

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

Идентификатор существующего пакета, связанного с объявлением. Значение должно быть в верхнем регистре.

PresentTime

Тип данных: DateTime

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

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

Дата и время, когда объявление становится доступным для клиентов. Значение по умолчанию — 19900101000000,000000+***.

PresentTimeEnabled

Тип данных: Boolean

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

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

true(по умолчанию), если текущее время применяется Configuration Manager.

PresentTimeIsGMT

Тип данных: Boolean

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

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

true Значение , если время, определенное в свойстве PresentTime , находится в UMT. Значение по умолчанию — false.

Priority

Тип данных: UInt32

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

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

Приоритет, используемый при репликации объявления на дочерние сайты. Ниже перечислены возможные значения. Значение по умолчанию — NORMAL (2).

Значение	Описание
1	ВЫСОКОЙ
2	НОРМАЛЬНОЙ
3	Низкой

ProgramName

Тип данных: String

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

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

Программа в указанном пакете (PackageID) для объявления.

RemoteClientFlags

Тип данных: UInt32

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

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

Флаги, указывающие, как должна выполняться программа, когда клиент подключен локально или удаленно к точке распространения. Ниже перечислены возможные значения. Значение по умолчанию — 48.

Шестнадцатеричный (бит)	Описание
0x00000001 (0)	BATTERY_POWER. Запустите программу с питанием от аккумулятора. Это значение в настоящее время не используется.
0x00000002 (1)	RUN_FROM_CD. Запустите программу с компакт-диска. Это значение в настоящее время не используется.
0x00000004 (2)	DOWNLOAD_FROM_CD. Скачайте программу с компакт-диска. Это значение в настоящее время не используется.
0x00000008 (3)	RUN_FROM_LOCAL_DISPPOINT. Запустите программу из локальной точки распространения.
0x00000010 (4)	DOWNLOAD_FROM_LOCAL_DISPPOINT. Скачайте программу из локальной точки распространения.
0x00000020 (5)	DONT_RUN_NO_LOCAL_DISPPOINT. Не запускайте программу, если нет локальной точки распространения.
0x00000040 (6)	DOWNLOAD_FROM_REMOTE_DISPPOINT. Скачайте программу из удаленной точки распространения.
0x00000080 (7)	RUN_FROM_REMOTE_DISPPOINT. Запустите программу из удаленной точки распространения.
0x00000100 (8)	DOWNLOAD_ON_DEMAND_FROM_LOCAL_DP. Скачайте программу по запросу из локальной точки распространения. Это применимо только для последовательностей задач.
0x00000200 (9)	DOWNLOAD_ON_DEMAND_FROM_REMOTE_DP. Скачайте программу по запросу из удаленной точки распространения. Это применимо только для последовательностей задач.
x00000400 (10)	BALLOON_REMINDERS_REQUIRED. Требуются напоминания с помощью воздушных шаров.
0x00000800 (11)	RERUN_ALWAYS. Всегда повторно запускайте программу.
0x00001000 (12)	RERUN_NEVER. Никогда не запускайте программу повторно.
0x00002000 (13)	RERUN_IF_FAILED. Повторно запустите программу, если выполнение ранее завершилось сбоем.
0x00004000 (14)	RERUN_IF_SUCCEEDED. Повторно запустите программу, если ранее выполнение прошло успешно.
0x00008000 (15)	PERSIST_ON_WRITE_FILTER_DEVICES Эта информация относится к System Center 2012 Configuration Manager с пакетом обновления 1 (SP1) или более поздней версии, а также System Center 2012 R2 Configuration Manager или более поздней версии.
0x00020000 (17)	НЕ T_FALLBACK Эта информация относится к System Center 2012 Configuration Manager с пакетом обновления 1 (SP1) или более поздней версии, а также System Center 2012 R2 Configuration Manager или более поздней версии.
0x00040000 (18)	DP_ALLOW_METERED_NETWORK Эта информация относится к System Center 2012 Configuration Manager с пакетом обновления 1 (SP1) или более поздней версии, а также System Center 2012 R2 Configuration Manager или более поздней версии.

SourceSite

Тип данных: String

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

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

Трехбуквенный код сайта, на котором показано объявление.

TimeFlags

Тип данных: UInt32

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

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

Зарезервировано для внутреннего использования. Флаги, дублирующие сведения в свойствах, связанных со временем. Ниже перечислены возможные значения. Например, ENABLE_PRESENT задается, если PresentTimeEnabled равен true.

Шестнадцатеричный (бит)	Описание
0x00000001 (0)	ENABLE_PRESENT
0x00000002 (1)	ENABLE_EXPIRATION
0x00000004 (2)	ENABLE_AVAILABLE
0x00000008 (3)	ENABLE_UNAVAILABLE
0x00000010 (4)	ENABLE_MANDATORY
0x00000020 (5)	GMT_PRESENT
0x00000040 (6)	GMT_EXPIRATION
0x00000080 (7)	GMT_AVAILABLE
0x00000100 (8)	GMT_UNAVAILABLE
0x00000200 (9)	GMT_MANDATORY

Замечания

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

• Защищенная

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

  Хотя другие ключевые свойства отсутствуют, необходимо указать свойства AdvertisementName, CollectionID, PackageIDи ProgramName как NOT_NULL и значения. Приложение не может обновить эти свойства после создания экземпляра класса. Чтобы изменить эти значения, приложение должно удалить экземпляр и создать новый экземпляр с правильными значениями.

Требования

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

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

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

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