Класс 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.
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по