---
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 dispositivos

# Atividade Obter coleções de dispositivos {#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 dispositivos retorna uma lista de coleções de dispositivos disponíveis em um host do Microsoft System Center Configuration Manager (SCCM).
A atividade Obter coleção de dispositivos 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 GetDeviceCollection.ps1 para retornar a coleção de dispositivos no servidor. Este script filtra os resultados do GET, para que somente atributos específicos sejam retornados para as coleções de dispositivos no servidor SCCM. Filtrar os resultados dessa maneira controla o tamanho da carga e fornece os dados de coleção de dispositivos mais desejáveis. A lista de coleções disponíveis é retornada como uma matriz em um objeto JSON.{#r_GetDeviceCollectionsActivity__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 dispositivos não usa um script de pré-processamento.

## Variáveis de entrada

{#r_GetDeviceCollectionsActivity__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ção de dispositivos]

{#r_GetDeviceCollectionsActivity__table_jhr_xbd_3s}

## Variáveis de saída

{#r_GetDeviceCollectionsActivity__table_o5d_wpm_xs__entry__2}

| Variável | Descrição |
|-|-|
| deviceCollections | A matriz deviceCollections contém estes atributos: * id: Chave primária da coleção de dispositivos SCCM. * name: Nome da coleção de dispositivos SCCM. * collectionType: Nome da coleção de dispositivos SCCM. Nesse caso, o valor é dispositivo. * localMemberCount: Contagem de membros da coleção de dispositivos visíveis no SCCM local. * memberCount: Contagem de todos os membros da coleção de dispositivos. * deviceCollection: Objeto que contém o conjunto de dados de atributos listados aqui para esta coleção de dispositivos. Use o script de pós-processamento para analisar dados adicionais desse conjunto de que você pode precisar. {#r_GetDeviceCollectionsActivity__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ção de dispositivos]

{#r_GetDeviceCollectionsActivity__table_o5d_wpm_xs}

## Condições

{#r_GetDeviceCollectionsActivity__table_emz_zpm_xs__entry__2}

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

{#r_GetDeviceCollectionsActivity__table_emz_zpm_xs}