通过

用于应用程序池回收的定期重启设置 <periodicRestart>

  • 项目

概述

<periodicRestart> 元素包含配置设置，可用于控制何时回收应用程序池。 可指定 Internet Information Services (IIS) 7 在一定时间间隔后（以分钟为单位）或在每天的特定时间回收应用程序池。 还可以将 IIS 配置为基于应用程序池中辅助进程正在使用的虚拟内存或物理内存量进行回收，或将 IIS 配置为在工作进程处理特定数量的请求后回收应用程序池。

兼容性

版本 说明
IIS 10.0 <periodicRestart> 元素在 IIS 10.0 中未进行修改。
IIS 8.5 <periodicRestart> 元素在 IIS 8.5 中未进行修改。
IIS 8.0 <periodicRestart> 元素在 IIS 8.0 中未进行修改。
IIS 7.5 <periodicRestart> 元素未在 IIS 7.5 中进行修改。
IIS 7.0 <periodicRestart> 元素在 IIS 7.0 中引入。
IIS 6.0 <periodicRestart> 元素替换了 IIS 6.0 IIsApplicationPools 配置数据库属性的部分内容。

安装

<applicationPools> 集合包含在 IIS 7 的默认安装中。

操作方式

如何为应用程序池设置定期回收

  1. 打开 Internet Information Services (IIS) 管理器：

    • 如果使用的是 Windows Server 2012 或 Windows Server 2012 R2：

      • 在任务栏上，单击“服务器管理器”，单击“工具”，然后单击“Internet Information Services (IIS)管理器”。

    • 如果使用的是 Windows 8 或 Windows 8.1：

      • 按住 Windows 键，按字母 X，然后单击“控制面板”。
      • 单击“管理工具”，然后双击“Internet 信息服务(IIS)管理器”。

    • 如果使用的是 Windows Server 2008 或 Windows Server 2008 R2：

      • 在任务栏上，单击“开始”，指向“管理工具”，然后单击“Internet Information Services (IIS)管理器”。

    • 如果使用的是 Windows Vista 或 Windows 7：

      • 在任务栏上，单击“开始”，然后单击“控制面板”。
      • 双击“管理工具”，然后双击“Internet 信息服务(IIS)管理器”。

  2. 在“连接”窗格中，展开服务器名称，然后单击“应用程序池”。

  3. 在“应用程序池”窗格中，选择要编辑的应用程序池。

  4. 在“操作”窗格中，单击“回收…”
    Screenshot of the Actions pane. Under Edit Application Pool, Recycling is highlighted.

  5. 在编辑应用程序池回收设置向导的“回收条件”页上，至少选择“固定间隔”部分中的一个选项，在相应的文本框中输入值，然后单击“下一步”。
    Screenshot of the Edit Application Pool Recycling Settings page. The Fixed Intervals section is located at the top.

  6. （可选）在编辑应用程序池回收设置向导的“将回收事件到日志”页上，选择希望 IIS 在其发生时发送到事件日志的可配置回收事件和运行时回收事件，然后单击“完成”。
    Screenshot of the Edit Application Pool Recycling Settings page. The scheduled times option is selected.

配置

<periodicRestart> 元素可在 ApplicationHost.config 文件中在服务器级别进行配置。

特性

属性 说明
memory 可选 uint 属性。

指定工作进程在被回收之前可使用的虚拟内存量（以 KB 为单位）。

默认值为 0，这会禁用该特性。
privateMemory 可选 uint 属性。

指定工作进程在被回收之前可使用的专用内存量（以 KB 为单位）。

默认值为 0，这会禁用该特性。
requests 可选 uint 属性。

指定应在回收工作进程处理了特定数量的请求后将其回收。

默认值为 0，这会禁用该特性。
time 可选的 timeSpan 特性。

指定应在经过指定时间后将工作进程回收。

默认值为 29:00:00（29 小时）。

子元素

元素 说明
schedule 可选元素。

指定定期重启应用程序池的计划。

配置示例

以下配置示例使用应用程序池 <add> 元素创建名为 Contoso 的新应用程序池。 <recycling> 元素配置应用程序池重启的日志记录，<periodicRestart> 元素配置应用程序池重启的时间，<processModel> 配置 shutdownTimeLimit 和 startupTimeLimit 属性，用于关闭和启动应用程序池中的工作进程，各 30 秒。 如果超出这些时间限制，IIS 将终止工作进程。

<add name="Contoso">
   <recycling logEventOnRecycle="Schedule">
      <periodicRestart>
         <schedule>
            <clear />
            <add value="03:00:00" />
         </schedule>
      </periodicRestart>
   </recycling>
   <processModel identityType="NetworkService" shutdownTimeLimit="00:00:30" startupTimeLimit="00:00:30" />
</add>

代码示例

下面的代码示例将名为 Contoso 的应用程序池添加到 IIS 7 服务器，然后将应用程序池设置为每天在凌晨 3:00 回收。

AppCmd.exe

appcmd.exe set config -section:system.applicationHost/applicationPools /+"[name='Contoso']" /commit:apphost

appcmd.exe set config -section:system.applicationHost/applicationPools /+"[name='Contoso'].recycling.periodicRestart.schedule.[value='03:00:00']" /commit:apphost

还可以使用以下语法：

appcmd.exe add apppool /name:"Contoso"

appcmd.exe set config -section:system.applicationHost/applicationPools /+"[name='Contoso'].recycling.periodicRestart.schedule.[value='03:00:00']" /commit:apphost

注意

使用 AppCmd.exe 配置这些设置时，必须确保将 commit 参数设置为 apphost。 这会将配置设置提交到 ApplicationHost.config 文件中的相应位置部分。

C#

using System;
using System.Text;
using Microsoft.Web.Administration;

internal static class Sample
{
   private static void Main()
   {
      using (ServerManager serverManager = new ServerManager())
      {
         Configuration config = serverManager.GetApplicationHostConfiguration();
         ConfigurationSection applicationPoolsSection = config.GetSection("system.applicationHost/applicationPools");
         ConfigurationElementCollection applicationPoolsCollection = applicationPoolsSection.GetCollection();
         ConfigurationElement addElement = applicationPoolsCollection.CreateElement("add");
         addElement["name"] = @"Contoso";
         ConfigurationElement recyclingElement = addElement.GetChildElement("recycling");
         ConfigurationElement periodicRestartElement = recyclingElement.GetChildElement("periodicRestart");
         ConfigurationElementCollection scheduleCollection = periodicRestartElement.GetCollection("schedule");
         ConfigurationElement addElement1 = scheduleCollection.CreateElement("add");
         addElement1["value"] = TimeSpan.Parse("03:00:00");
         scheduleCollection.Add(addElement1);
         applicationPoolsCollection.Add(addElement);
         serverManager.CommitChanges();
      }
   }
}

VB.NET

Imports System
Imports System.Text
Imports Microsoft.Web.Administration

Module Sample
   Sub Main()
      Dim serverManager As ServerManager = New ServerManager
      Dim config As Configuration = serverManager.GetApplicationHostConfiguration
      Dim applicationPoolsSection As ConfigurationSection = config.GetSection("system.applicationHost/applicationPools")
      Dim applicationPoolsCollection As ConfigurationElementCollection = applicationPoolsSection.GetCollection
      Dim addElement As ConfigurationElement = applicationPoolsCollection.CreateElement("add")
      addElement("name") = "Contoso"
      Dim recyclingElement As ConfigurationElement = addElement.GetChildElement("recycling")
      Dim periodicRestartElement As ConfigurationElement = recyclingElement.GetChildElement("periodicRestart")
      Dim scheduleCollection As ConfigurationElementCollection = periodicRestartElement.GetCollection("schedule")
      Dim addElement1 As ConfigurationElement = scheduleCollection.CreateElement("add")
      addElement1("value") = TimeSpan.Parse("03:00:00")
      scheduleCollection.Add(addElement1)
      applicationPoolsCollection.Add(addElement)
      serverManager.CommitChanges()
   End Sub
End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";
var applicationPoolsSection = adminManager.GetAdminSection("system.applicationHost/applicationPools", "MACHINE/WEBROOT/APPHOST");
var applicationPoolsCollection = applicationPoolsSection.Collection;

var addElement = applicationPoolsCollection.CreateNewElement("add");
addElement.Properties.Item("name").Value = "Contoso";
var recyclingElement = addElement.ChildElements.Item("recycling");
var periodicRestartElement = recyclingElement.ChildElements.Item("periodicRestart");
var scheduleCollection = periodicRestartElement.ChildElements.Item("schedule").Collection;
var addElement1 = scheduleCollection.CreateNewElement("add");
addElement1.Properties.Item("value").Value = "03:00:00";
scheduleCollection.AddElement(addElement1);
applicationPoolsCollection.AddElement(addElement);

adminManager.CommitChanges();

VBScript

Set adminManager = createObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set applicationPoolsSection = adminManager.GetAdminSection("system.applicationHost/applicationPools", "MACHINE/WEBROOT/APPHOST")
Set applicationPoolsCollection = applicationPoolsSection.Collection

Set addElement = applicationPoolsCollection.CreateNewElement("add")
addElement.Properties.Item("name").Value = "Contoso"
Set recyclingElement = addElement.ChildElements.Item("recycling")
Set periodicRestartElement = recyclingElement.ChildElements.Item("periodicRestart")
Set scheduleCollection = periodicRestartElement.ChildElements.Item("schedule").Collection
Set addElement1 = scheduleCollection.CreateNewElement("add")
addElement1.Properties.Item("value").Value = "03:00:00"
scheduleCollection.AddElement(addElement1)
applicationPoolsCollection.AddElement(addElement)

adminManager.CommitChanges()