Get User Collections activity

The Get User Collections activity returns the list of available user collections on a Microsoft System Center Configuration Manager (SCCM) server.

The Get User Collections activity uses the Powershell activity designer template to access the user collections on the SCCM server. The activity is configured to use a MID Server with Powershell capabilities and to run a MID Server script called GetUserCollections.ps1 that returns the user collections on the host. This script filters the results of the GET, so that only specific attributes are returned for the user collections on the SCCM server. Filtering the results in this manner controls the size of the payload, while providing the most desirable user collection data. The list of available collections is returned as an array in a JSON object.

To access this activity in the workflow editor, select the Custom tab, and then navigate to Custom Activities > System Center Configuration Manager (SCCM) .

Note: The Get User Collections activity does not use pre-processing scripts.

Input variables

Table 1. Get User Collections input variables
Variable Description
sccmServer The fully qualified domain name (FQDN) of the SCCM server.

Output variables

Table 2. Get User Collections output variables
Variable Description
userCollections The userCollections array contains these attributes:
  • id: Primary key of the SCCM user collection.
  • name: Name of the SCCM user collection.
  • collectionType: Type of SCCM collection. In this case, the value is user.
  • localMemberCount: Count of user collection members visible at the local SCCM site.
  • memberCount: Count of all user collection members.
  • userCollection: Object containing the full data set for this user collection. Use the post-processing script to parse additional data from this set to use.
error Variable that contains the activity output error message.

Conditions

Table 3. Get User Collections conditions
Condition Description
Success Activity successfully retrieved the list of available user collections on an SCCM host.
Failure Activity failed to retrieve the list of available user collections on an SCCM host.