通过

SMS_Advertisement 服务器 WMI 类

  • 项目

SMS_Advertisement Windows Management Instrumentation (WMI) 类是Configuration Manager中的 SMS 提供程序服务器类，它表示用于播发可用于在客户端上运行的软件包程序的播发。

以下语法在托管对象格式 (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 的方法。

方法 说明
类SMS_Advertisement中的 GetAdvertisements 方法 获取面向资源的播发 ID。
类SMS_Advertisement中的 GetNextID 方法 检索将用于下一个创建的播发的 ID 号。
类SMS_Advertisement中的 RiskyDeploymentStatusMessage 方法 将有关用户部署的警告状态消息发送到有风险的集合。
类SMS_Advertisement中的 SetNextID 方法 设置将用于下一个创建的播发的 ID 号。
类SMS_Advertisement中的 SetSourceSite 方法 设置播发的源站点代码。
类SMS_Advertisement中的 Unlock 方法 将源站点设置为当前站点，从而解锁播发。 警告： 此方法已弃用。

属性

ActionInProgress

数据类型UInt32

访问类型：只读

限定符：[read， 枚举]

Configuration Manager对包执行的当前操作。 可能的值是：

值 说明
0 没有
1 更新
2 添加

AdvertFlags

数据类型UInt32

访问类型：读/写

限定符：[bits]

指示应如何向用户宣布播发的标志。 下面列出了可能的值。 默认值为 0。

十六进制 (位) 说明
0x00000020 (5) 立即。 立即向用户宣布播发。
0x00000100 (8) ONSYSTEMSTARTUP。 在系统启动时向用户宣布播发。
0x00000200 (9) ONUSERLOGON。 在登录时向用户宣布播发。
0x00000400 (10) ONUSERLOGOFF。 在注销时向用户宣布播发。
0x00001000 (12) OPTIONALPREDOWNLOAD。 如果所选体系结构和语言与客户端的体系结构和语言匹配，则会提前下载包内容
0x00008000 (15) WINDOWS_CE。 播发适用于设备客户端。
0x00010000 (16) ENABLE_PEER_CACHING。 此信息适用于 System Center 2012 Configuration Manager 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。 向启用了 LAN 唤醒的用户宣布播发。
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 标志。 如果标志设置不匹配，则不会播发程序。 有关详细信息，请参阅 SMS_Program 服务器 WMI 类。

设置 IMMEDIATE、ONUSERLOGON 或 ONUSERLOGOFF 或提供值 AssignedSchedule 使播发的程序成为必需程序。 客户端收到播发后，将自动运行强制程序。 客户端无法拒绝或推迟安装。

仅当设置了 IMMEDIATE、ONUSERLOGON 或 ONUSERLOGOFF 位或程序具有 AssignedSchedule 值时，才设置NO_DISPLAY位和 ONSLOWNET 位。

如果不希望用户独立于分配运行程序，请设置NO_DISPLAY。 如果未设置此标志，播发将显示在播发列表中，并且可以独立于分配运行。 该程序仍可能是必需的。

当必须通过慢速网络连接分配时（例如，当计算机使用调制解调器进行连接时）时，设置 ONSLOWNET。

AdvertisementID

数据类型String

访问类型：读/写

限定符：[key、ResID (801) 、ResDLL (“SMS_RSTT.dll”) ]

用于标识播发的唯一自动生成密钥。 默认值为“”。

AdvertisementName

数据类型String

访问类型：读/写

限定符：[Not_null]

广告的唯一用户友好名称。

AssignedSchedule
数据类型： SMS_ScheduleToken 数组

访问类型：读/写

限定符：[最大 (15) ，延迟]

SMS_ScheduleToken服务器 WMI 类 对象，用于指示播发在客户端上变为强制播发的时间。

AssignedScheduleEnabled

数据类型Boolean

访问类型：读/写

限定符：[延迟]

true 如果 属性中 AssignedSchedule 定义的计划处于活动状态，则为 。 默认值为 false。

AssignedScheduleIsGMT

数据类型Boolean

访问类型：读/写

限定符：[延迟]

true 如果 属性中 AssignedSchedule 定义的计划在通用指标时 (UMT) 。 默认值为 false。

AssignmentID

数据类型UInt32

访问类型：只读

限定符：[read]

与播发关联的分配的 ID。

CollectionID

数据类型String

访问类型：读/写

限定符：[Not_null]

播发目标到的现有集合。

Comment

数据类型String

访问类型：读/写

限定符：无

有关播发的简单说明或说明。 默认值为“”。

DeviceFlags

数据类型UInt32

访问类型：读/写

限定符：无

描述设备的标志。 下面列出了可能的值。 默认值为 0。

十六进制 (位) 说明
0x01000000 (24) 始终将程序分配给客户端。
0x02000000 (25) 仅当设备当前连接到高带宽连接 (默认高于 60 KBps) 时分配。
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 数组

访问类型：读/写

限定符：[大型、延迟]

允许单个 ISV 存储与实例相关的 SMS_Program 数据的信息。 此数据没有限制或定义格式。 但是，在建立其 ISV 所有权后，不要覆盖属性，这一点很重要。 因此，调用应用程序应首先读取此属性中的现有数据。 如果数据不属于应用程序，则不应对其进行修改。 使用此属性的任何 ISV 或应用程序所有者都应在数据中包含标识符，以便可以轻松建立所有权。

ISVDataSize

数据类型UInt32

访问类型：读/写

限定符：[延迟]

属性表示 ISVData 的数据的大小。 默认值为 0。

ISVString

数据类型String

访问类型：读/写

限定符：无

合作伙伴扩展性的字符串。

MandatoryCountdown

数据类型UInt32

访问类型：读/写

限定符：无

显示操作系统部署用户通知强制计划倒计时的持续时间（以分钟为单位）。 默认值为 0。

OfferType

数据类型UInt32

访问类型：读/写

限定符：[枚举]

指示播发面向用户的播发类型。

值 说明
0 必需
2 可用

PackageID

数据类型String

访问类型：读/写

限定符：[Not_null]

与播发关联的现有包的 ID。 该值必须以大写形式。

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

访问类型：读/写

限定符：[bits]

指定客户端在本地或远程连接到分发点时程序应如何运行的标志。 下面列出了可能的值。 默认值为 48。

十六进制 (位) 说明
0x00000001 (0) BATTERY_POWER。 使用电池电源运行程序。 此值当前未使用。
0x00000002 (1) RUN_FROM_CD。 从 CD 运行程序。 此值当前未使用。
0x00000004 (2) DOWNLOAD_FROM_CD。 从 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 SP1 或更高版本，以及 System Center 2012 R2 Configuration Manager 或更高版本。
0x00020000 (17) 请勿T_FALLBACK

此信息适用于 System Center 2012 Configuration Manager SP1 或更高版本，以及 System Center 2012 R2 Configuration Manager 或更高版本。
0x00040000 (18) DP_ALLOW_METERED_NETWORK

此信息适用于 System Center 2012 Configuration Manager SP1 或更高版本，以及 System Center 2012 R2 Configuration Manager 或更高版本。

SourceSite

数据类型String

访问类型：只读

限定符：[read]

播发地网站的三个字母站点代码。

TimeFlags

数据类型UInt32

访问类型：只读

限定符：[read， bits]

仅供内部使用。 在与时间相关的属性中复制信息的标志。 下面列出了可能的值。 例如，当 等于 true时PresentTimeEnabled设置ENABLE_PRESENT。

十六进制 (位) 说明
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服务器开发要求。