---
sourceDocument: Capacidades da Now Platform da Yokohama
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/servicenow-platform

 Release :

    - yokohama

ft:locale :

    - pt-BR

ft:publication_title :

    - Capacidades da Now Platform da Yokohama

ft:clusterId :

    - platcap

bundleId :

    - platcap

workflow :

    - Platform


---

# Atividade Obter coleções de usuário

# Atividade Obter coleções de usuário {#ariaid-title1}

* Versão de lançamento: Yokohama
* 
* Atualizado 30 de jan. de 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 min. de leitura

A atividade Obter coleções de usuário retorna uma lista de coleções de usuário disponíveis em um host do Microsoft System Center Configuration Manager (SCCM).
A atividade Obter coleção de usuários usa o [modelo de atividade Powershell](https://servicenow-prod.fluidtopics.net/Ar2KgjX9yZB1xQDKNXQuVw#t_CreateAPowershellActivity "Crie uma atividade PowerShell personalizada para retornar dados a um fluxo de trabalho a partir de um host usando o Microsoft PowerShell.") para acessar as coleções no servidor SCCM. A atividade está configurada para usar um MID Server com recursos PowerShell e para executar um script de MID Server chamado GetUserCollection.ps1 para retornar a coleção de usuários no host. Este script filtra os resultados do GET, para que somente atributos específicos sejam retornados para as coleções de usuários no servidor SCCM. Filtrar os resultados dessa maneira controla o tamanho da carga e fornece os dados de coleção de usuários mais desejáveis. A lista de coleções disponíveis é retornada como uma matriz em um objeto JSON.{#r_GetUserCollectionsActivity__p_AccessSSHCustomActivities}

Para acessar esta atividade no Editor de fluxo de trabalho, selecione Personalizado e navegue até Atividades PersonalizadasSystem Center Configuration Manager (SCCM).  
Nota:  
A atividade Obter coleção de usuários não usa um script de pré-processamento.

## Variáveis de entrada

{#r_GetUserCollectionsActivity__table_jhr_xbd_3s__entry__2}

| Variável | Descrição |
|-|-|
| sccmServer | Nome de domínio totalmente qualificado (FQDN) do servidor SCCM. |
[Tabela 1. Variáveis de entrada para Obter coleções de usuário]

{#r_GetUserCollectionsActivity__table_jhr_xbd_3s}

## Variáveis de saída

{#r_GetUserCollectionsActivity__table_pkz_csm_xs__entry__2}

| Variável | Descrição |
|-|-|
| userCollections | A matriz userCollections contém estes atributos: * id: Chave primária da coleção de usuários SCCM. * name: Nome da coleção de usuários SCCM. * collectionType: Nome da coleção de dispositivos SCCM. Nesse caso, o valor é usuário. * localMemberCount: Contagem de membros da coleção de usuários visíveis no SCCM local. * memberCount: Contagem de todos os membros da coleção de usuários. * userCollection: Objeto que contém o conjunto de dados de atributos listados aqui para esta coleção de usuários. Use o script de pós-processamento para analisar dados adicionais desse conjunto de que você pode precisar. {#r_GetUserCollectionsActivity__ul_t2p_xpy_3t} |
| error | Variável que contém a mensagem de erro de saída da atividade. |
[Tabela 2. Variáveis de saída para Obter coleções de usuário]

{#r_GetUserCollectionsActivity__table_pkz_csm_xs}

## Condições

{#r_GetUserCollectionsActivity__table_dfl_gsm_xs__entry__2}

| Condição | Descrição |
|-|-|
| Êxito | A atividade conseguiu recuperar a lista de coleções de usuários disponíveis no host SCCM. |
| Falha | A atividade não conseguiu recuperar a lista de coleções de usuários disponíveis no host SCCM. |
[Tabela 3. Condições para Obter coleções de usuários]

{#r_GetUserCollectionsActivity__table_dfl_gsm_xs}