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
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:
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.
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
Right-click the property value box, click Subscribe, and then click Published Data.
Click the Activity drop-down box and select the activity from which you want to obtain the data.
To view additional data elements common across the runbook, select Show Common Published Data.
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: