Advertisement

An advertisement is an SMS announcement that a software package is available for installation. The Advertisement object type consists of a single class called SMS_Advertisement. This object is not part of the inventory process. This class contains information about SMS advertisements.

Table B.3 Advertisement Object Type (SMS_Advertisement)

PropertyData typeExampleNotes
ActionInProgressuint321Indicates the current action that SMS performs on the package.

Values are:
0=NONE
1=UPDATE
2=ADD
3=DELETE

AdvertFlagsuint32See “Interpreting Bitfield Properties” at the beginning of this appendix.Indicates when to announce an advertisement to the user.

Bit flags are:
Bit 5 = IMMEDIATE
Bit 8 = ONSYSTEMSTARTUP
Bit 9 = ONUSERLOGON
Bit 10 = ONUSERLOGOFF
Bit 25 = NO_DISPLAY
Bit 26 = ONSLOWNET

AdvertisementID string "TTG00001"Describes a unique, autogenerated key.
AdvertisementName string "myAdvert"Indicates the name of the advertisement.
AssignedSchedule[] SMS_ Schedule TokenThis may appear as a lengthy array of object labels.Lazy. Defines an array of schedule tokens when the advertisement will become mandatory on clients.
AssignedScheduleEnabled Boolean FALSELazy. Indicates whether the schedule defined in AssignedSchedule is active.

Values are:
TRUE
FALSE

If the value is TRUE, the schedule is active.

AssignedScheduleIsGMT Boolean FALSELazy. Indicates whether the schedule defined in AssignedSchedule uses Greenwich Mean Time (GMT).

Values are:
TRUE
FALSE

If the value is TRUE, the schedule uses GMT.

CollectionID string "SMS00001"Refers to the collection that the advertisement is targeted to.
Comment string "Any comment."Indicates a comment about the advertisement.
ExpirationTime datetime See “Date and Time Formats” at the beginning of this appendix.Indicates the time the advertisement is no longer available to clients.
ExpirationTimeEnabled Boolean FALSELazy. Indicates whether the advertisement expires at the time defined in ExpirationTime.

Values are:
TRUE
FALSE

If the value is TRUE, the advertisement expires at the time indicated in the ExpirationTime property.

ExpirationTimeIsGMT Boolean FALSELazy. Indicates whether the time defined in the ExpirationTime property is GMT.

Values are:
TRUE
FALSE

If TRUE, the expiration time is expressed in GMT.

HierarchyPathstring  
IncludeSubCollection Boolean TRUEIndicates, when set to TRUE, that the advertisement should be advertised to the subcollections of the selected collection.

Values are:
TRUE
FALSE

PackageID string "TTG00001"Indicates the Package ID associated with this advertisement.
PresentTime datetimeSee “Date and Time Formats” at the beginning of this appendix.Indicates the time that the advertisement is presented to clients.
PresentTimeEnabled Boolean TRUELazy. Denotes, when set to TRUE, that SMS enforces the present time.

Values are:
TRUE
FALSE

PresentTimeIsGMT Boolean FALSELazy. Indicates whether the time defined in PresentTime is GMT.

Values are:
TRUE
FALSE

If the value is TRUE, the PresentTime property is expressed in GMT.

Priority uint32 2Indicates the priority of the advertisement at child sites.

Values are:
1=HIGH
2=NORMAL
3=LOW

ProgramName string "Typical Installation"Indicates the name of the SMS program object associated with this advertisement.
SourceSite string "TTG"Indicates a three-letter site code of the originating site.
TimeFlags uint32See “Interpreting Bitfield Properties” at the beginning of this appendix.Duplicates the information in the time Boolean properties.

Bit flags are:
Bit 0 = ENABLE_PRESENT
Bit 1 = ENABLE_EXPIRATION
Bit 2 = ENABLE_AVAILABLE
Bit 3 = ENABLE_UNAVAILABLE
Bit 4 = ENABLE_MANDATORY
Bit 5 = GMT_PRESENT
Bit 6 = GMT_EXPIRATION
Bit 7 = GMT_AVAILABLE
Bit 8 = GMT_UNAVAILABLE
Bit 9 = GMT_MANDATORY