Compartilhar via


Add Computer to Collection

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

The Add Computer to Collection activity is used in a runbook to create a direct membership rule that adds a single computer to an existing collection. Advertisements for Software Deployment and Task Sequences are targeted to collections, not individual computers. This activity enables these actions to be targeted to a single computer.

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

Properties and Published Data

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

Add Computer to Collection 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 name or a collection ID.

ID

Name

Yes

Computer

The name or Resource ID of an existing computer to add to the collection. When you enter a computer name manually or use a computer name from published data, you must set the Computer Value Type property to Name or the action will fail.

String

No

Computer Value Type

Specifies whether the value in the Computer property is a computer name or a Resource ID

ID

Name

Yes

Add Computer to Collection Published Data

Element Description Value Type

Collection

The name or Collection ID of the collection

String

Collection Value Type

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

String

Computer

The name or Resource ID of an existing computer added to the collection

String

Computer Value Type

Specifies whether the value in the Computer property is a computer name or a Resource ID

String

Connection

Specifies the name of the connection to the Configuration Manager server

String

Configuring the Add Computer to Collection Activity

To configure the Add Computer to Collection activity

  1. From the Activities pane, drag an Add Computer to Collection activity to the active runbook.

  2. Double-click the Add Computer to Collection activity icon to open the Properties dialog box.

  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.

      Important

      If you specify a Collection or a Computer that does not exist on the Configuration Manager Site, the activity will return a status of Failed.

      You can also use published data to automatically populate the value of the property from the data output by a previous activity in the workflow.

      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: