Share via


Get Collection Member

Applies To: System Center 2012 - Orchestrator, System Center 2012 - Orchestrator Release Candidate, 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.

This activity returns the properties associated with the SMS_FullCollectionMembership WMI class scoped to the collection specified.

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

Collection Name

The display name or ID of an existing collection

Note

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 activity will fail.

Collection Value Type

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

  1. ID (default): the value is a collection ID

  2. Name: the value is a collection name

Get Collection Member Published Data

The following values are published in addition to the input values above:

Element Description

Connection

Specifies the name of the connection to the Configuration Manager server

Collection ID

Provides the Collection ID value for the collection targeted for this activity (in case the collection name was specified for the input property).

AMTFullVersion

Provides the Intel Active Management Technology (Intel AMT) firmware version of this computer. The format is: MAJOR.MINOR.MICRO

AMTStatus

Status of the Intel AMT component of this computer. Possible values are:

  • NULL: Unknown

  • 0: Computer is not supported

  • 1: Computer is detected

  • 2: Computer is not provisioned

  • 3: Computer is provisioned

ClientCertType

Type of certificate used by the client. Possible values are:

  1. Self-signed

  2. Issued by CA

ClientType

Type of client. Possible values are:

  1. Client

  2. Device

ClientVersion

The version ID of the client

Domain

Domain to which the resource belongs.

Is Always Internet

True or False. True if this is an Internet-facing client.

Is Approved

True or False. True if the client is approved.

Is Assigned

True or False. True if the client is assigned to any site.

Is Blocked

True or False. True if the client is blocked.

Is Client

True or False. True if this is a client.

Is Decommissioned

True or False. True if the record is deleted.

Is Direct

True or False. True if the client is a member through a direct rule, represented by SMS_CollectionRuleDirect Server WMI Class; otherwise false or null.

Is Internet Enabled

True or False. True if the client can be Internet-enabled.

Is Obsolete

True or False. True if this is an obsolete record.

Is Virtual Machine

True or False. True if this is a virtual machine.

Member Name

Name of the resource.

Member Resource Type

Type of resource. Possible values are:

  • System

  • User group

  • User

Resource ID

Unique ID supplied by Configuration Manager for the resource. This ID is not unique across sites.

Site Code

Site code of the site that created the collection.

SMSID

Configuration Manager unique ID

Suppress Auto Provision

True or False. When set to true and when this resource belongs to a collection configured for automatic provisioning, prevents the resource from being automatically provisioned by an Out of Band service point.

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.

  4. 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: