Atividade Obter Aplicações

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 1 min. de leitura
  • A atividade Obter aplicações retorna uma lista de todos as aplicações disponíveis em um servidor do Microsoft System Center Configuration Manager (SCCM).

    A atividade Obter aplicações usa o modelo de atividade Powershell para acessar os aplicaçõ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 GetApplications.ps1. Este script filtra os resultados do GET, para que somente atributos específicos sejam retornados para as aplicações no servidor SCCM. Filtrar os resultados dessa maneira controla o tamanho da carga e fornece os dados de aplicação mais desejáveis. A lista de aplicativos disponíveis é retornada como uma matriz em um objeto JSON.

    Para acessar esta atividade no Editor de fluxo de trabalho, selecione a guia Personalizado e navegue até Atividades Personalizadas > Gerenciador de configuração do System Center (SCCM).

    Nota:
    A atividade Obter aplicações não usa um script de pré-processamento.

    Variáveis de entrada

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

    Variáveis de saída

    As variáveis de saída da atividade Obter aplicações contêm uma matriz de objetos chamada applications e uma mensagem de erro. Cada objeto na matriz contém os atributos nesta tabela.

    Tabela 2. Variáveis de saída para Obter aplicações
    Variáveis Descrição
    aplicativos A matriz applications contém estes atributos:
    • id: Chave primária da aplicação SCCM.
    • ciUniqueId: ID exclusivo da aplicação SCCM.
    • name: Nome da aplicação.
    • manufacturer: Fabricante da aplicação.
    • version: Versão da aplicação.
    • isDeployable: Valor verdadeiro/falso que indica se este aplicativo é implantável.
    • isDeployed: Valor verdadeiro/falso que indica se este aplicativo já está implantada.
    • numberOfUsersWithApp: Contagem de usuários com este aplicativo instalada.
    • numberOfDevicesWithApp: Contagem de dispositivos nos quais esta aplicação está instalada.
    • application: Objeto que contém o conjunto de dados listado acima para este aplicativo. Use o script para analisar dados adicionais 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 aplicações
    Variáveis Descrição
    Êxito A atividade conseguiu recuperar a lista de aplicações disponíveis no host SCCM.
    Falha A atividade não conseguiu recuperar a lista de aplicações disponíveis no host SCCM.