Configure o registro em log para a etapa PowerShell

Adicione mensagens de log aos scripts na etapa do PowerShell. Use níveis de log para melhorar o registro em log e a depuração.

Antes de Iniciar

Para adicionar mensagens de log ao script, você precisará usar SNCLog de gravação função. Esta função é definida no módulo IH/Logging.psm1. Use PSScript.ps1 para importar este módulo para que os scripts em linha tenham acesso ao SNCLog de gravação . Para obter mais informações, consulte Arquivos PowerShell do MID Server .

Função necessária: administrador

Procedimento

1. Navegar até Tudo > MID Server > Propriedades.
2. Definido mid.property.powershell.log_info. verdadeiro .
   Esta propriedade habilita ou desabilita o registro em log. Para obter mais informações, consulte Propriedade de log do PowerShell .
3. Definido mid.property.powershell.ih.log_levelpara o nível de log desejado.
   O nível de log especifica o limite necessário para registrar uma mensagem em log. As mensagens são registradas no nível especificado ou superior. Por exemplo, se esta propriedade estiver definida como AVISAR, as mensagens com um nível de AVISO ou ERRO serão registradas em log. Mensagens com um nível de INFORMAÇÕES, DEPURAÇÃO ou RASTREAMENTO não são registradas em log. Os níveis, listados de baixo para alto, são:

   • TRACE
   • DEBUG
   • INFORMAÇÕES
   • WARN
   • ERRO

   O valor padrão é INFO.
4. Opcional: Configure uma propriedade do sistema para que você possa exibir os logs na instância.
   1. Navegar até Tudo > Automação de Processo > Flow Designer > Propriedades.
   2. Localizar Especifique o nível de log das entradas de log do sistema a serem replicadas para o log de fluxo. O sistema replica somente entradas de log do nível especificado ou superior e defina como INFORMAÇÕES ou DEPURAÇÃO .

   Após criar e executar o script PowerShell, os logs estarão disponíveis no log do MID Agent. Configurar esta propriedade também permite exibi-los diretamente na instância.

   . com.glide.hub.flow_engine.listener_trace.thresholdpropriedade. Replica os logs para a tabela Entradas de log do mecanismo de fluxo [sys_flow_log].

5. Em seu script PowerShell, adicione mensagens de log e níveis com SNCLog de gravação função.

   Tabela 1. Função e parâmetros Write-SNCLog

   Nome	Descrição
   SNCLog de gravação função	Registre uma mensagem para a etapa do PowerShell. SNCLog de gravação tem dois parâmetros, -Levele. -Message. Ambos os parâmetros são obrigatórios, mas os nomes dos parâmetros não. Se os nomes forem omitidos, a posição será usada para determinar o nível e a mensagem. Exemplos: Write-SNCLog -AVISO DE nível -Mensagem "aviso de log" Write-SNCLog WARN "aviso de log" Ambos os exemplos são registrados em log AVISO: Aviso de log .
   Parâmetro -Level	Especifique o nível da mensagem de log. Os valores válidos são: ERRO WARN INFORMAÇÕES DEBUG TRACE Este parâmetro é obrigatório.
   Parâmetro -Message	Especifique a mensagem a ser registrada. Inserido como uma cadeia de caracteres. Este parâmetro é obrigatório.

6. Continue criando sua ação ou fluxo e, em seguida, teste e execute-o.

O que Fazer Depois

Os novos logs estão disponíveis no log do MID Agent e podem ser baixados do MID Server. Para obter mais informações, consulte Baixe os arquivos DO MID Server .

Se você definir a propriedade do sistema para exibir os logs na instância do , poderá vê-los no Entradas de log do mecanismo de fluxo Do registro de contexto do mecanismo de fluxo. Para obter mais informações, consulte Detalhes da execução do fluxo .

Tarefas relacionadas

• Teste uma credencial para a etapa do PowerShell