Add Computer to Collection

Article
10/24/2013

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

From the Activities pane, drag an Add Computer to Collection activity to the active runbook.
Double-click the Add Computer to Collection activity icon to open the Properties dialog box.
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.
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:

Share via