Share via


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.

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

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

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

  1. From the Activities pane, drag an Advertise Task Sequence activity to the active runbook.

  2. Double-click the Advertise Task Sequence activity icon. The Properties dialog box opens.

  3. Configure the settings in the Details tab:

    1. 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.

    2. 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

      1. Right-click the property value box, click Subscribe, and then click Published Data.

      2. Click the Activity drop-down box and select the activity from which you want to obtain the data.

      3. To view additional data elements common across the runbook, select Show Common Published Data.

      4. 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.

  4. 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

    1. Click Add. The Mandatory Schedule dialog box opens.

    2. To schedule the advertisement at a specified date and time select Use the following schedule.

      1. 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.

      2. If you want all clients to run the program at the same time regardless of time zone, select the UTC check box.

      3. 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.

    3. To run the advertisement after an event, select Assign immediately after this event. Select the applicable option As soon as possible, Logoff, or Logon.

    4. Click OK to save the schedule.

    5. 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.

    6. 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.

  5. For information about the settings on the General and Run Behavior tabs, see Common Configuration Instructions for All Activities.

  6. Click Finish.

Other Activities

The Integration Pack for System Center Configuration Manager contains the following additional activities.