Partilhar via


Configurar Registro de Mensagem

Este tópico descreve como usar cmdlets do AppFabric para configurar o log de mensagens de um aplicativo ou serviço. Os cmdlets que você pode usar para configurar log de mensagens são Set-ASAppMessageLogging, Get-ASAppMessageLogging, Enable-ASAppMessageLogging e Disable-ASAppMessageLogging.

Para executar interativamente um cmdlet de AppFabric, abra o console do Windows PowerShell para AppFabric, insira o cmdlet adequado e pressione ENTER. Para obter mais informações sobre a execução de cmdlets, consulte Executando cmdlets do Windows Server AppFabric.

Para definir o log de mensagens de um aplicativo

No console do Windows PowerShell, execute o cmdlet Set-ASAppMessageLogging para alterar as propriedades do log de mensagens de um aplicativo.

Opções de sintaxe para Set-ASAppMessageLogging:

Sintaxe 1

Set-ASAppMessageLogging [SiteName] <String> [[-VirtualPath] <String>] [-FilePath <string>] [-LogEntireMessage] [-LogMalformedMessages] [-LogMessagesAtServiceLevel] [-LogMessagesAtTransportLevel] [-MaxMessagesToLog Number] [-MaxSizeOfMessageToLog Number]

Sintaxe 2

Set-ASAppMessageLogging [-Uri] <Uri> [-FilePath <string>] [-LogEntireMessage] [-LogMalformedMessages] [-LogMessagesAtServiceLevel] [-LogMessagesAtTransportLevel] [-MaxMessagesToLog Number] [-MaxSizeOfMessageToLog Number]

Sintaxe 3

Set-ASAppMessageLogging -ApplicationObject <ApplicationInfo> -FilePath <string>] [-LogEntireMessage] [-LogMalformedMessages] [-LogMessagesAtServiceLevel] [-LogMessagesAtTransportLevel] [-MaxMessagesToLog Number] [-MaxSizeOfMessageToLog Number]

Sintaxe 4

Set-ASAppMessageLogging -Root [-FilePath <string>] [-LogEntireMessage] [-LogMalformedMessages] [-LogMessagesAtServiceLevel] [-LogMessagesAtTransportLevel] [-MaxMessagesToLog Number] [-MaxSizeOfMessageToLog Number]
Parâmetro Descrição

[-SiteName] <String> [[-VirtualPath] <String>]. [-Uri] <Uri>, -ApplicationObject <ApplicationInfo> ou -Root

Escopo operacional do cmdlet

-FilePath <string>

Obrigatório. Onde os logs devem ser armazenados.

-LogEntireMessage

Opcional. Especifica o valor do atributo /configuration/system.serviceModel/diagnostics/messageLogging[@logEntireMessage]. Se estiver faltando, o atributo não será alterado.

-LogMalformedMessages

Opcional. Especifica o valor do atributo /configuration/system.serviceModel/diagnostics/messageLogging[@logMalformedMessages]. Se estiver faltando, o atributo não será alterado.

-LogMessagesAtServiceLevel

Opcional. Especifica o valor do atributo /configuration/system.serviceModel/diagnostics/messageLogging[@logMessagesAtServiceLevel]. Se estiver faltando, o atributo não será alterado.

-LogMessagesAtTransportLevel

Opcional. Especifica o valor do atributo /configuration/system.serviceModel/diagnostics/messageLogging[@logMessagesAtTransportLevel]. Se estiver faltando, o atributo não será alterado.

-MaxMessagesToLog Number

Opcional. Especifica o valor do atributo /configuration/system.serviceModel/diagnostics/messageLogging[@maxMessagesToLog]. Se estiver faltando, o atributo não será alterado.

-MaxSizeOfMessageToLog Number

Opcional. Especifica o valor do atributo /configuration/system.serviceModel/diagnostics/messageLogging[@maxSizeOfMessageToLog]. Se estiver faltando, o atributo não será alterado.

Para obter o log de mensagens de um aplicativo

No console do Windows PowerShell, execute o cmdlet Get-ASAppMessageLogging para obter as propriedades do log de mensagens de um aplicativo em um objeto ApplicationMessageLoggingInfo.

Opções de sintaxe para Get-ASAppMessageLogging:

Sintaxe 1

Get-ASAppMessageLogging [-SiteName] <String> [[-VirtualPath] <String>]

Sintaxe 2

Get-ASAppMessageLogging [-Uri] <Uri>

Sintaxe 3

Get-ASAppMessageLogging -ApplicationObject <ApplicationInfo>

Sintaxe 4

Get-ASAppMessageLogging -Root
Parâmetro Descrição

[-SiteName] <String> [[-VirtualPath] <String>], [-Uri] <Uri>, -ApplicationObject <ApplicationInfo> ou -Root

Escopo operacional do cmdlet

Para habilitar o log de mensagens de um aplicativo

No console do Windows PowerShell, execute o cmdlet Enable-ASAppMessageLogging para habilitar o registro de mensagens de um aplicativo especificado.

Opções de sintaxe para Enable-ASAppMessageLogging:

Sintaxe 1

Enable-ASAppMessageLogging [-SiteName] <String> [[-VirtualPath] <String>] [-FilePath <string>] [-LogEntireMessage] [-LogMalformedMessages] [-LogMessagesAtServiceLevel] [-LogMessagesAtTransportLevel] [-MaxMessagesToLog Number] [-MaxSizeOfMessageToLog Number]

Sintaxe 2

Enable-ASAppMessageLogging [-Uri] <Uri> [-FilePath <string>] [-LogEntireMessage] [-LogMalformedMessages] [-LogMessagesAtServiceLevel] [-LogMessagesAtTransportLevel] [-MaxMessagesToLog Number] [-MaxSizeOfMessageToLog Number]

Sintaxe 3

Enable-ASAppMessageLogging -ApplicationObject <ApplicationInfo> [-FilePath <string>] [-LogEntireMessage] [-LogMalformedMessages] [-LogMessagesAtServiceLevel] [-LogMessagesAtTransportLevel] [-MaxMessagesToLog Number] [-MaxSizeOfMessageToLog Number]

Sintaxe 4

Enable-ASAppMessageLogging -Root [-FilePath <string>] [-LogEntireMessage] [-LogMalformedMessages] [-LogMessagesAtServiceLevel] [-LogMessagesAtTransportLevel] [-MaxMessagesToLog Number] [-MaxSizeOfMessageToLog Number]
Parâmetro Descrição

[-SiteName] <String> [[-VirtualPath] <String>], [-Uri] <Uri>, -ApplicationObject <ApplicationInfo> ou -Root

Escopo operacional do cmdlet

-FilePath <string>

Obrigatório. Onde os logs devem ser armazenados.

-LogEntireMessage

Opcional. Especifica o valor do atributo /configuration/system.serviceModel/diagnostics/messageLogging[@logEntireMessage]. Se estiver faltando, o atributo não será alterado.

-LogMalformedMessages

Opcional. Especifica o valor do atributo /configuration/system.serviceModel/diagnostics/messageLogging[@logMalformedMessages]. Se estiver faltando, o atributo não será alterado.

-LogMessagesAtServiceLevel

Opcional. Especifica o valor do atributo /configuration/system.serviceModel/diagnostics/messageLogging[@logMessagesAtServiceLevel]. Se estiver faltando, o atributo não será alterado.

-LogMessagesAtTransportLevel

Opcional. Especifica o valor do atributo /configuration/system.serviceModel/diagnostics/messageLogging[@logMessagesAtTransportLevel]. Se estiver faltando, o atributo não será alterado.

-MaxMessagesToLog Number

Opcional. Especifica o valor do atributo /configuration/system.serviceModel/diagnostics/messageLogging[@maxMessagesToLog]. Se estiver faltando, o atributo não será alterado.

-MaxSizeOfMessageToLog Number

Opcional. Especifica o valor do atributo /configuration/system.serviceModel/diagnostics/messageLogging[@maxSizeOfMessageToLog]. Se estiver faltando, o atributo não será alterado.

Para desabilitar o log de mensagens de um aplicativo

No console do Windows PowerShell, execute o cmdlet Disable-ASAppMessageLogging para desabilitar o registro de mensagens no contexto da sessão de diagnóstico atual.

Opções de sintaxe para Disable-ASAppMessageLogging:

Sintaxe 1

Disable-ASAppMessageLogging [-SiteName] <String> [[-VirtualPath] <String>] [-Confirm]

Sintaxe 2

Disable-ASAppMessageLogging [-Uri] <Uri> [-Confirm]

Sintaxe 3

Disable-ASAppMessageLogging -ApplicationObject <ApplicationInfo> [-Confirm]

Sintaxe 4

Disable-ASAppMessageLogging [-Confirm] -Root
Parâmetro Descrição

[-SiteName] <String> [[-VirtualPath] <String>], [-Uri] <Uri>, -ApplicationObject <ApplicationInfo> ou -Root

Escopo operacional do cmdlet

  2011-12-05