Get User Collections activity

  • Release version: Zurich
  • Updated July 31, 2025
  • 1 minute to read

    • 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 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 data set of attributes listed here 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.