Atividade Obter coleções de dispositivos

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 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 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.

    Para acessar esta atividade no Editor de fluxo de trabalho, selecione Personalizado e navegue até Atividades Personalizadas > System Center Configuration Manager (SCCM).

    Nota:
    A atividade Obter coleção de dispositivos não usa um script de pré-processamento.

    Variáveis de entrada

    Tabela 1. Variáveis de entrada para Obter coleção de dispositivos
    Variável Descrição
    sccmServer Nome de domínio totalmente qualificado (FQDN) do servidor SCCM.

    Variáveis de saída

    Tabela 2. Variáveis de saída para Obter coleção de dispositivos
    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.
    error Variável que contém a mensagem de erro de saída da atividade.

    Condições

    Tabela 3. Condições para Obter coleção de dispositivos
    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.