Share via


Refresh Collection

Applies To: System Center 2012 - Orchestrator, System Center 2012 R2 Orchestrator, System Center 2012 SP1 - Orchestrator

The Refresh Collection activity is used in a runbook to initiate collection evaluation. It ensures that the membership of a collection is current before other activities are performed on the collection or its members.

For the procedure to configure this object, see: Configuring the Refresh Collection Activity

Properties and Published Data

The following tables list the properties and published data for this activity.

Refresh Client Properties

Element Description Valid Values Look up

Collection

The name or ID of an existing collection

When you use the browse feature to look up a collection name or enter a collection name manually or from published data, you must set the Collection Value Type property to Name or the action will fail.

String

Yes (for Collection Names)

Collection Value Type

Specifies whether the value in the Collection property is a collection name or a collection ID

ID

Name

Yes

Wait for Refresh Completion

Specifies whether the runbook should pause and poll the status of the collection refresh until the collection refresh is complete

True

False

Yes

Polling Interval (seconds)

The number of seconds to wait between polling attempts to determine refresh status

Integer

No

Refresh Collection Published Data

Element Description Value Type

Collection

The name or ID of an existing collection

String

Collection Value Type

Specifies whether the value in the Collection property is a collection name or a collection ID.

ID

Name

Connection

Specifies the name of the connection to the Configuration Manager server

String

Polling Interval (seconds)

Specifies whether the runbook should pause and poll the status of the collection refresh until the collection refresh is complete

True

False

Wait for Refresh Completion

The number of seconds to wait between polling attempts to determine the refresh status

Integer

Configuring the Refresh Collection Activity

To configure the Refresh Collection activity

  1. From the Activities pane, drag a Refresh Collection activity to the active runbook.

  2. Double-click the Refresh Collection 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. For information about the settings on the General and Run Behavior tabs, see Common Configuration Instructions for all Activities.

  5. Click Finish.

Other Activities

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