Get Collection Member

  • Article

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

The Get Collection Member activity is used in a runbook that queries an existing Configuration Manager collection for its member computers. This lets you specify computers individually to obtain status or perform other activities.

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

Properties and Published Data

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

Get Collection Member Properties

Element Description Valid Values Look up

Collection Name

The name of an existing collection

String

Yes

Include Members of Sub-collections

Defines if members of sub-collections will be returned in the results

True or False

Yes

Get Collection Member Published Data

Element Description Value Type

Collection ID

The site-specific identifier for the collection or sub-collection to which the computer belongs

String

Collection Member

The name of the collection member computer

String

Collection Name

The name of the collection or sub-collection to which the computer belongs

String

Connection

Specifies the connection to the Configuration Manager server

String

Include Members of Sub-Collections

Defines if members of sub-collections will be returned in the results

True or False

Member Resource Type

The type of resource associated with the computer

String

Configuring the Get Collection Member Activity

To configure the Get Collection Member activity

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

  2. Double-click the Get Collection Member 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 Run Behavior tab:

    This activity will return multi-value published data if the collection contains more than one member computer. If you select Flatten, the following properties will contain a string with multiple values:

    • Collection ID

    • Collection Member

    • Member Resource Type

    For more 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: