配置消息记录
本主题介绍了如何使用 AppFabric cmdlet 来为应用程序或服务配置消息记录。可用于配置消息记录的 cmdlet 包括 Set-ASAppMessageLogging、Get-ASAppMessageLogging、Enable-ASAppMessageLogging 和 Disable-ASAppMessageLogging。
要以交互方式执行 AppFabric cmdlet，请打开 AppFabric 的 Windows PowerShell 控制台，输入相应的 cmdlet，然后按 Enter。有关执行 cmdlet 的详细信息，请参阅运行 Windows Server AppFabric Cmdlet。
设置应用程序的消息记录
在 Windows PowerShell 控制台中，执行 Set-ASAppMessageLogging cmdlet，以更改应用程序的消息记录属性。
Set-ASAppMessageLogging 的语法选项包括：
语法 1
Set-ASAppMessageLogging [SiteName] <String> [[-VirtualPath] <String>] [-FilePath <string>] [-LogEntireMessage] [-LogMalformedMessages] [-LogMessagesAtServiceLevel] [-LogMessagesAtTransportLevel] [-MaxMessagesToLog Number] [-MaxSizeOfMessageToLog Number]
语法 2
Set-ASAppMessageLogging [-Uri] <Uri> [-FilePath <string>] [-LogEntireMessage] [-LogMalformedMessages] [-LogMessagesAtServiceLevel] [-LogMessagesAtTransportLevel] [-MaxMessagesToLog Number] [-MaxSizeOfMessageToLog Number]
语法 3
Set-ASAppMessageLogging -ApplicationObject <ApplicationInfo> -FilePath <string>] [-LogEntireMessage] [-LogMalformedMessages] [-LogMessagesAtServiceLevel] [-LogMessagesAtTransportLevel] [-MaxMessagesToLog Number] [-MaxSizeOfMessageToLog Number]
语法 4
Set-ASAppMessageLogging -Root [-FilePath <string>] [-LogEntireMessage] [-LogMalformedMessages] [-LogMessagesAtServiceLevel] [-LogMessagesAtTransportLevel] [-MaxMessagesToLog Number] [-MaxSizeOfMessageToLog Number]
| 参数 | 描述 |
|---|---|
[-SiteName] <String> [[-VirtualPath] <String>]。[-Uri] <Uri>、-ApplicationObject <ApplicationInfo> 或 -Root |
cmdlet 的操作作用域 |
-FilePath <string> |
必需。日志应存储的位置。 |
-LogEntireMessage |
可选。指定 /configuration/system.serviceModel/diagnostics/messageLogging[@logEntireMessage] 属性的值。如果缺少，则不会更改该属性。 |
-LogMalformedMessages |
可选。指定 /configuration/system.serviceModel/diagnostics/messageLogging[@logMalformedMessages] 属性的值。如果缺少，则不会更改该属性。 |
-LogMessagesAtServiceLevel |
可选。指定 /configuration/system.serviceModel/diagnostics/messageLogging[@logMessagesAtServiceLevel] 属性的值。如果缺少，则不会更改该属性。 |
-LogMessagesAtTransportLevel |
可选。指定 /configuration/system.serviceModel/diagnostics/messageLogging[@logMessagesAtTransportLevel] 属性的值。如果缺少，则不会更改该属性。 |
-MaxMessagesToLog Number |
可选。指定 /configuration/system.serviceModel/diagnostics/messageLogging[@maxMessagesToLog] 属性的值。如果缺少，则不会更改该属性。 |
-MaxSizeOfMessageToLog Number |
可选。指定 /configuration/system.serviceModel/diagnostics/messageLogging[@maxSizeOfMessageToLog] 属性的值。如果缺少，则不会更改该属性。 |
获取来自应用程序的消息记录
在 Windows PowerShell 控制台中，执行 Get-ASAppMessageLogging cmdlet，以获取某个应用程序的消息记录属性，并将其加入 ApplicationMessageLoggingInfo 对象。
Get-ASAppMessageLogging 的语法选项包括：
语法 1
Get-ASAppMessageLogging [-SiteName] <String> [[-VirtualPath] <String>]
语法 2
Get-ASAppMessageLogging [-Uri] <Uri>
语法 3
Get-ASAppMessageLogging -ApplicationObject <ApplicationInfo>
语法 4
Get-ASAppMessageLogging -Root
| 参数 | 描述 |
|---|---|
[-SiteName] <String> [[-VirtualPath] <String>]、[-Uri] <Uri>、-ApplicationObject <ApplicationInfo> 或 -Root |
cmdlet 的操作作用域 |
启用应用程序的消息记录
在 Windows PowerShell 控制台中，执行 Enable-ASAppMessageLogging cmdlet，以为特定的应用程序启用消息记录。
Enable-ASAppMessageLogging 的语法选项包括：
语法 1
Enable-ASAppMessageLogging [-SiteName] <String> [[-VirtualPath] <String>] [-FilePath <string>] [-LogEntireMessage] [-LogMalformedMessages] [-LogMessagesAtServiceLevel] [-LogMessagesAtTransportLevel] [-MaxMessagesToLog Number] [-MaxSizeOfMessageToLog Number]
语法 2
Enable-ASAppMessageLogging [-Uri] <Uri> [-FilePath <string>] [-LogEntireMessage] [-LogMalformedMessages] [-LogMessagesAtServiceLevel] [-LogMessagesAtTransportLevel] [-MaxMessagesToLog Number] [-MaxSizeOfMessageToLog Number]
语法 3
Enable-ASAppMessageLogging -ApplicationObject <ApplicationInfo> [-FilePath <string>] [-LogEntireMessage] [-LogMalformedMessages] [-LogMessagesAtServiceLevel] [-LogMessagesAtTransportLevel] [-MaxMessagesToLog Number] [-MaxSizeOfMessageToLog Number]
语法 4
Enable-ASAppMessageLogging -Root [-FilePath <string>] [-LogEntireMessage] [-LogMalformedMessages] [-LogMessagesAtServiceLevel] [-LogMessagesAtTransportLevel] [-MaxMessagesToLog Number] [-MaxSizeOfMessageToLog Number]
| 参数 | 描述 |
|---|---|
[-SiteName] <String> [[-VirtualPath] <String>]、[-Uri] <Uri>、-ApplicationObject <ApplicationInfo> 或 -Root |
cmdlet 的操作作用域 |
-FilePath <string> |
必需。日志应存储的位置。 |
-LogEntireMessage |
可选。指定 /configuration/system.serviceModel/diagnostics/messageLogging[@logEntireMessage] 属性的值。如果缺少，则不会更改该属性。 |
-LogMalformedMessages |
可选。指定 /configuration/system.serviceModel/diagnostics/messageLogging[@logMalformedMessages] 属性的值。如果缺少，则不会更改该属性。 |
-LogMessagesAtServiceLevel |
可选。指定 /configuration/system.serviceModel/diagnostics/messageLogging[@logMessagesAtServiceLevel] 属性的值。如果缺少，则不会更改该属性。 |
-LogMessagesAtTransportLevel |
可选。指定 /configuration/system.serviceModel/diagnostics/messageLogging[@logMessagesAtTransportLevel] 属性的值。如果缺少，则不会更改该属性。 |
-MaxMessagesToLog Number |
可选。指定 /configuration/system.serviceModel/diagnostics/messageLogging[@maxMessagesToLog] 属性的值。如果缺少，则不会更改该属性。 |
-MaxSizeOfMessageToLog Number |
可选。指定 /configuration/system.serviceModel/diagnostics/messageLogging[@maxSizeOfMessageToLog] 属性的值。如果缺少，则不会更改该属性。 |
禁用应用程序的消息记录
在 Windows PowerShell 控制台中，执行 Disable-ASAppMessageLogging cmdlet，以在当前诊断会话的上下文中禁用消息记录。
Disable-ASAppMessageLogging 的语法选项包括：
语法 1
Disable-ASAppMessageLogging [-SiteName] <String> [[-VirtualPath] <String>] [-Confirm]
语法 2
Disable-ASAppMessageLogging [-Uri] <Uri> [-Confirm]
语法 3
Disable-ASAppMessageLogging -ApplicationObject <ApplicationInfo> [-Confirm]
语法 4
Disable-ASAppMessageLogging [-Confirm] -Root
| 参数 | 描述 |
|---|---|
[-SiteName] <String> [[-VirtualPath] <String>]、[-Uri] <Uri>、-ApplicationObject <ApplicationInfo> 或 -Root |
cmdlet 的操作作用域 |
2011-12-05