Create Advertisement
Applies To: System Center 2012 - Orchestrator, System Center 2012 R2 Orchestrator, System Center 2012 SP1 - Orchestrator
The Create Advertisement activity is used in a runbook that assigns Advertisements to a Collection to deploy software to one or more target computers based on a schedule that you specify. By default, advertisements are made available to sub-collections.
For the procedure to configure this object, see: Configuring the Create Advertisement Activity
Properties and Published Data
The following tables list the properties and published data for this activity.
Create Advertisement Properties
| Element | Description | Valid Values | Look up |
|---|---|---|---|
Advertisement Name |
The name of the advertisement to be created by this activity |
String |
No |
Collection Name |
The name of the collection to which the task sequence will be advertised |
String |
Yes |
Content Access |
Specifies how the content will be accessed or downloaded by the client for use by the task sequence |
Run from distribution point Download and run locally |
Yes |
Include Sub-collections |
Defines if the advertisement will be advertised to all sub-collections of the specified collection |
True or False |
Yes |
Package |
The unique name of an existing package, containing one or more programs to be distributed |
String |
Yes |
Program |
The unique name of an existing program contained in the specified package |
String |
Yes |
Start Time |
The date and time that the advertisement will be made available to clients |
String (mm/dd/yyyy hh:mm:ss AM or PM) |
Yes |
Create Advertisement Optional Properties
| Element | Description | Valid Values | Look up |
|---|---|---|---|
Advertisement Expiry Date |
The date and time after which the program advertisement is no longer available to run on clients in their respective time zones |
String (mm/dd/yyyy hh:mm:ss AM or PM). Defaults to 6 months after today. |
Yes |
Advertisement Expiry Date is UTC |
Causes the expiration date and time to be set as UTC, ignoring time zones |
True or False If you set this to True, then the advertisement will expire on all clients simultaneously. |
Yes |
Allow System Restart Outside of Maintenance Windows |
Allows the advertised program to restart the client even if the restart would occur outside of a maintenance window |
True or False |
Yes |
Comment |
An optional comment associated with the advertisement |
String |
No |
Enable Wake on LAN |
Specifies whether the Configuration Manager server will send a Wake On LAN packet to the computer prior to the advertised program |
True or False |
Yes |
Ignore Maintenance Windows When Running Program |
Specifies whether to allow the advertised program to ignore maintenance window settings while the program is running |
True or False |
Yes |
Priority |
Specifies the advertisement’s sending priority when replicated to child sites |
Low Medium High |
Yes |
Program Rerun Behavior |
Specifies whether the advertised program will be rerun on the client computer and under what conditions |
Never rerun advertised program Always rerun program Rerun if failed previous attempt Rerun if succeeded on previous attempt |
Yes |
Start Time is UTC |
Sets the Start Time as UTC, ignoring time zones |
True or False If you set this to True, then the advertisement will start on all clients simultaneously. |
Yes |
Create Advertisement Published Data
| Element | Description | Value Type |
|---|---|---|
Advertisement Expiry Date |
The date and time after which the program advertisement is no longer available to run on clients in their respective time zones |
String (mm/dd/yyyy hh:mm:ss AM or PM) |
Advertisement Expiry Date is UTC |
Causes the expiration date and time to be set as UTC, ignoring time zones |
True or False |
Advertisement ID |
The site-specific identifier for the advertisement |
String |
Advertisement Name |
The name of the advertisement that was created by this activity |
String |
Allow System Restart Outside of Maintenance Window |
Allows the advertised program to restart the client even if the restart would occur outside of a maintenance window |
True or False |
Collection Name |
The name of the collection to which the task sequence will be advertised |
String |
Comment |
An optional comment associated with the advertisement |
String |
Connection |
Specifies the name of the connection to the Configuration Manager server |
String |
Content Access |
Specifies how the content will be accessed or downloaded by the client for use by the task sequence. |
String |
Enable Wake on LAN |
Specifies whether the Configuration Manager server will send a Wake On LAN packet to the computer prior to the advertised program |
True or False |
Ignore Maintenance Windows When Running Program |
Specifies whether to allow the advertised program to ignore maintenance window settings while the program is running |
True or False |
Include Sub-collections |
Defines if the advertisement will be advertised to all sub-collections of the specified collection |
True or False |
Package |
The unique name of an existing package, containing one or more programs to be distributed |
String |
Priority |
Specifies the advertisement’s sending priority when replicated to child sites |
String |
Program |
The unique name of an existing program contained in the specified package |
String |
Program Rerun Behavior |
Specifies whether the advertised program will be rerun on the client computer and under what conditions |
String |
Start Time |
The date and time that the advertisement will be made available to clients |
String (mm/dd/yyyy hh:mm:ss AM or PM) |
Start Time is UTC |
Sets the Start Time as UTC, ignoring time zones |
True or False |
Configuring the Create Advertisement Activity
To configure the Create Advertisement activity
From the Activities pane, drag a Create Advertisement activity to the active runbook.
Double-click the Create Advertisement activity icon. The Properties dialog box opens.
Configuring the Details tab:
In the Connection section, click the ellipsis button (...), and then select the Configuration Manager server connection that you want to use for this activity. Click OK.
In the Fields section, enter a value for each of the required properties. If the property is Lookup-enabled, you can click the ellipsis (…) button next to the text box to browse for a value.
You can also use published data to automatically populate the value of the property from the data output by a previous activity in the runbook.
To use published data
Right-click the property value box, click Subscribe, and then click Published Data.
Click the Activity drop-down box and select the activity from which you want to obtain the data.
To view additional data elements common across the runbook, select Show Common Published Data.
Click the published data element you want to use, and then click OK.
For a list of the data elements published by each activity, see the Published Data tables in the activity topic. For information about the Common Published Data items, see Published Data in the System Center Orchestrator 2012 Runbook Guide.
Configuring the Schedule tab:
The Schedule tab allows you to define a mandatory assignment for the advertisement as well as options for slow links and interaction. Mandatory assignment schedules cause Configuration Manager to automatically run the program at a specific time or according to a specific event, such as user Logon/Logoff. The settings on this tab are optional.
When a mandatory assignment is defined for this advertisement, client computers will use the Advertisement Start Time to determine when to start downloading the package.
To add a mandatory assignment
Click Add. The Mandatory Schedule dialog box opens.
To schedule the advertisement at a specified date and time select Use the following schedule.
To schedule the event, click the ellipsis (…) button to open the Date Time Selection dialog box. Modify the date and time according to your needs, and then click OK.
If you want all clients to run the program at the same time regardless of time zone, select the UTC check box.
If you want the advertisement to run on a recurring schedule, select one of the options: Weekly, Monthly or Custom Interval and set the properties according to your needs.
To run the advertisement after an event, select Assign immediately after this event. Select the applicable option As soon as possible, Logoff, or Logon.
Click OK to save the schedule.
Select Assignments are not mandatory over slow links if you want the advertised program or task sequence to run only when the target computer is connected by a high-speed (LAN) network.
Select Allow the user to run the program independently of assignments if you want to allow users to be able to run the program whether or not it has actually been assigned to the target computer.
For information about the settings on the General and Run Behavior tabs, see Common Configuration Instructions for All Activities.
Click Finish.
Other Activities
The Integration Pack for System Center Configuration Manager integration contains the following additional activities: