使用配置编辑器编辑集合:复杂部分

作者:Crystal Hoyer

演练目标

使用配置编辑器模块中的集合编辑器,添加新的失败请求跟踪规则,用于跟踪返回状态代码 401 和/或需要超过一分钟才能响应的 aspx 请求。 此任务可以使用当前用户界面完成,但执行的步骤将在新的管理包配置编辑器模块中公开一项重要功能。

先决条件

本演练要求满足以下先决条件:

访问 system.webServer/tracing/traceFailedRequests 节

  1. 打开 IIS 管理器

  2. 在“连接树”视图中选择服务器

  3. 打开配置编辑器用户界面模块

    Screenshot of the I I S Manager window. The server home features is in the main pane.

  4. 在“配置编辑器节”组合框中,选择“system.webServer – tracing - traceFailedRequests”或输入“system.webServer/tracing/traceFailedRequests”

    Screenshot showing the Configuration Editor with the section input box.

使用集合编辑器添加新的失败跟踪请求规则

  1. 在配置编辑器中选择“(集合)”条目,然后单击… “(Count=0)”旁边的按钮。 这将打开集合编辑器,以用于编辑 tracefailedRequests 集合。

    Screenshot showing the Configuration Editor. Collection is highlighted and shows Count = 0.

  2. 在右侧的“操作任务”窗格中,单击“添加”。 现在,“项”部分中将显示新条目以及属性列表。

    Screenshot of the Collection Editor window with settings in the Properties section.

  3. 集合编辑器的“属性”部分预填充了定义集合的架构默认值。 在这种情况下,你将获取 system.webServer/tracing/traceFailedRequests 集合元素的架构默认值。

  4. “path”属性条目旁边有一个键。 这表示这是此集合项的唯一键。 如果键为黄色,则表示此键对于集合中的每个项必须是唯一的。 如果键为银色,则表示这是共享键。 在这种情况下,共享键的组合对于集合项必须是唯一的。

  5. 将“path”条目更改为“*.aspx”,将为所有 asp.net 路径创建规则。

  6. 将“statusCodes”条目更改为“401”

  7. 将“timeTaken”条目更改为“00:01:00”

  8. 在集合编辑器中选择“(traceAreas)”条目,然后单击… “(Count=0)”旁边的按钮。 这将打开集合编辑器,以用于编辑 traceAreas 集合。

    Screenshot of the Collection Editor window. Trace areas is selected in the Properties section.

  9. 在右侧的“操作任务”窗格中,单击“添加”。 现在,“项”部分中将显示新条目以及属性列表。

    Screenshot of the Collection Editor window. The Item pane shows a warning. The properties pane shows a warning.

  10. 集合编辑器的“属性”部分预填充了定义集合的架构默认值。 在这种情况下,你将获取 system.webServer/tracing/traceFailedRequests/add/traceAreas 集合元素的架构默认值。

  11. “provider”属性条目旁边有一个键。 这表示这是此集合项的唯一键。 如果键为黄色,则表示此键对于集合中的每个项必须是唯一的。 如果键为银色,则表示这是共享键。 在这种情况下,共享键的组合对于集合项必须是唯一的。

  12. 将“provider”条目更改为“ASPNET”

  13. 将“areas”条目更改为“基础结构、模块、页面、AppServices”[注意:可以从 system.webServer/tracing/traceProviderDefinitions 部分获取提供程序名称和相应区域]

  14. 将“verbosity”条目设置为“警告”

  15. 关闭 traceAreas 的集合编辑器

  16. 关闭 traceFailedRequests 的集合编辑器

  17. 若要设置更改,必须在“操作任务”窗格中单击“应用”。 执行此操作之前,请单击“操作任务”窗格中的“生成脚本”。 现在,你拥有了有脚本代码,可以为返回 401 或需要一分钟以上的响应的 aspx 请求添加失败跟踪请求规则

  18. 在“操作任务”窗格中单击“应用”,对配置进行更改。

  19. 可转到“失败请求跟踪规则”功能页,快速验证添加的新失败请求跟踪规则

    Screenshot of the I I S Manager window. The site home features are in the main pane. The Failed Request Tracing Rules icon is highlighted.

  20. 刚刚使用配置编辑器功能添加的规则,应该列在失败的请求跟踪规则页上

    Screenshot of the I I S Manager window. Failed Request Tracing Rules displays in the main pane.

  21. [额外步骤] 如果不想保留创建的任何失败跟踪请求规则,请再次编辑 tracefailedRequests 集合,然后在“操作任务”窗格中单击“全部清除”。 在配置编辑器中单击“应用”,然后将移除新添加的规则。

总结

现在,已经使用配置编辑器的集合编辑器工具创建了新的失败跟踪请求规则。 集合编辑器会公开给定集合的所有配置设置。