Advertise Task Sequence
Applies To: System Center 2012 - Orchestrator, System Center 2012 R2 Orchestrator, System Center 2012 SP1 - Orchestrator
The Advertise Task Sequence activity is used in a runbook that creates a new Configuration Manager Advertisement that assigns an existing task sequence to a collection. This enables you to deploy an operating system and software applications to one or more destination computers.
For the procedure to configure this object, see: Configuring the Advertise Task Sequence Activity
Properties and Published Data
The following tables list the properties and published data for this activity.
Advertise Task Sequence Properties
| Property Name | Description | Valid Values | Look up |
|---|---|---|---|
Advertisement Name |
The name of the advertisement to be created by this activity |
String |
No |
Available to Boot Media and PXE |
Enables the use of an Operating System Deployment Task Sequence that starts from a CD, from USB, or from PXE |
True or False When set to True and Content Access is set to Download all content before starting, Configuration Manager will automatically modify the Content Access option to Download when needed. |
Yes |
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 |
Download when needed Download all content before starting Access directly from distribution point |
Yes |
Include Sub-collections |
Defines if the advertisement will be advertised to all sub-collections of the specified collection |
True or False |
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 |
Task Sequence Name |
The task sequence name to be advertised |
String |
Yes |
Advertise Task Sequence Optional Properties
| Property Name | 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). Default is 6 months after the current date. |
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 Window |
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 |
Advertise Task Sequence 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 unique identifier for the advertisement |
String (for example, C0720001) |
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 |
Priority |
Specifies the advertisement’s sending priority when replicated to child sites |
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 Advertise Task Sequence Activity
To configure the Advertise Task Sequence activity
From the Activities pane, drag an Advertise Task Sequence activity to the active runbook.
Double-click the Advertise Task Sequence activity icon. The Properties dialog box opens.
Configure the settings in 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.
Configure the settings in 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. 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 contains the following additional activities.