Share via


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

  1. From the Activities pane, drag a Create Advertisement activity to the active runbook.

  2. Double-click the Create Advertisement activity icon. The Properties dialog box opens.

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

    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 box. 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 integration contains the following additional activities: