通过

不同于 IIS 元数据库的设置类型

  • 项目

更新：2007 年 11 月

在 ASP.NET 应用程序和 Internet 信息服务 (IIS) Web 服务器上，某些 IIS 设置的系统定义模型 (SDM) 类型与 IIS 元数据库中的类型不同。当在 IIS 元数据库中配置或验证这些设置值时，您需要将它们转换为正确的类型。有关 SDM 的更多信息，请参见系统定义模型 (SDM) 概述。有关 IIS 元数据库属性的更多信息，请参见 IIS 文档 (https://go.microsoft.com/fwlink/?LinkId=54800)。

以下各节包含有关这些类型转换的更多信息：

  • Setting Types that Convert to Simple Types

  • Setting Types that Convert to Integer Type

  • Setting Types that Convert to Hexadecimal Type

  • Setting Types that Convert to String Type

转换为简单类型的设置类型

下表包含其值转换为简单类型的设置类型。

设置类型

IIS 元数据库类型

Boolean

bool

不过，以下设置应转换为“int”类型：

  • AspKeepSessionIDSecure

  • AspExecuteInMTA

DateTime

string

Int

int

String

string

不过，以下设置需要进行指定的更改：

  • NTAuthenticationProviders - 一个以逗号分隔的字符串。

  • DefaultDoc - 一个以逗号和空格分隔的字符串。

  • InProcessIsapiApps - 一个字符串数组。

UnsignedInt

uint

不过，以下设置应转换为“int”类型：

  • AppOopRecoverLimit

  • AspQueueTimeout

  • AspScriptFileCacheSize

  • AspMaxDiskTemplateCacheFiles

  • AspSessionMax

  • AspMaxRequestEntityAllowed

  • PoolIdcTimeout

  • MaxRequestEntityAllowed

  • UploadReadAheadSize

IPSecurity

此字段在 IIS 元数据库中存储为二进制结构。可以使用 System.DirectoryServices 设置该值。有关更多信息，请参见 IIS 文档。

转换为整型类型的设置类型

下表包含转换为 IIS 元数据库中的整数类型的设置值。

设置名称

设置类型（如果不同于设置名称）

IIS 元数据库属性名称（如果不同于设置名称）

设置值

IIS 元数据库值

AppIsolated

InProcess

0

OutOfProcess

1

PooledProcess

2

AZImpersonationLevel

UrlAuthImpersonationLevel

AzImpersonationLevel

UseCurrentUserToken

0

UseProcessToken

1

UseAnonymousToken

2

LoadBalancerCapability

LoadBalancerCapabilities

TerminateConnection

1

ReturnError503

2

LogonMethod

Interactive

0

Batch

1

Network

2

ClearText

3

PassportRequireADMapping

DontEnforce

0

Attempt

1

Require

2

ServerState

Starting

1

Started

2

Stopping

3

Stopped

4

Pausing

5

Paused

6

Continuing

7

UserIsolationMode

None

0

IsolatedLocally

1

IsolatedActiveDirectory

2

转换为十六进制类型的设置类型

下表包含转换为 IIS 元数据库中的十六进制类型的设置值。

说明：

对于允许多个值的设置，必须组合位屏蔽值以创建最终的 DWORD 属性值。有关更多信息，请参见“Using the Metabase Reference Pages”（使用元数据库参考页）主题中的“Bitmask”（位屏蔽）和“Flags”（标志）(https://go.microsoft.com/fwlink/?LinkId=55891)。

设置

设置类型名称（如果不同于设置名称）

IIS 元数据库属性名称（如果不同于设置名称）

设置值

IIS 元数据库值

AccessFlags

AllowAll

0x217

AllowRead

0x1

AllowWrite

0x2

AllowLocalExecute

0x4

AllowAspSource

0x10

AllowScript

0x200

DenyRemoteWrite

0x400

DenyRemoteRead

0x1000

DenyRemoteExecute

0x2000

DenyRemoteScript

0x4000

DenyPhysicalDirAccess

0x8000

AccessSslFlags

AccessSSLFlags

RequireSsl

0x8

NegotiateClientCert

0x20

RequireClientCert

0x40

MapClientCertToWinUser

0x80

RequireSsl128

0x100

AppPoolIdentityType

LocalSystem

0x0

LocalService

0x1

NetworkService

0x2

UserDefined

0x3

AppPoolState

Starting

0x1

Started

0x2

Stopping

0x3

Stopped

0x4

AspAppServiceFlags

EnableTracker

0x1

EnableSxs

0x2

UsePartition

0x4

AuthFlags

None

0x0

Anonymous

0x1

Basic

0x2

Ntlm

0x4

MD5

0x10

Passport

0x40

All

0x57

AuthPersistenceFlags

AuthPersistence

SingleRequest

0x40

CpuAction

NoAction

0x0

KillWwwWorkerProcess

0x1

Trace

0x2

CpuLoggingMask

CpuLoggingFlags

LogEvent

0x1

ProcessType

0x2

UserTime

0x4

KernelTime

0x8

PageFaults

0x10

TotalProcessNumber

0x20

ActiveProcesses

0x40

TerminatedProcesses

0x80

CpuLoggingOptions

LogAllProcesses

0x1

LogCgis

0x2

LogOutOfProcessIsapisAndAsp

0x4

DirBrowseFlags

None

0x0

ShowDate

0x2

ShowTime

0x4

ShowFileSize

0x8

ShowFileExtension

0x10

ShowLongDate

0x20

EnableDefaultDoc

0x40000000

EnableDirBrowsing

对于 Visual C#，请使用 ((int)(0x80000000))。

否则，请使用 unchecked ((int)(0x80000000))。

LogEventsOnRecycleFlags

LogEventOnRecycle

OnRecycleTime

0x1

OnNumberRequests

0x2

OnRecycleSchedule

0x4

OnUnhealthyIsapiDetected

0x10

OnDemand

0x20

OnConfigurationChange

0x40

OnPrivateMemory

0x80

LogExtFileFlags

Date

0x1

Time

0x2

ClientIPAddress

0x4

UserName

0x8

SiteName

0x10

LocalComputerName

0x20

ServerIP

0x40

ProtocolMethod

0x80

UriStem

0x100

UriQuery

0x200

HttpStatus

0x400

Win32ErrorStatus

0x800

TotalBytesSent

0x1000

TotalBytesReceived

0x2000

TimeToCompleteRequest

0x4000

ServerPort

0x8000

UserAgent

0x10000

ClientCookie

0x20000

ClientReferer

0x40000

ProtocolVersion

0x80000

HostServer

0x100000

HttpSubStatus

0x200000

LogFileCreatePeriod

LogFilePeriod

OnMaxSize

0x0

Daily

0x1

Weekly

0x2

Monthly

0x3

Hourly

0x4

PasswordChangeFlags

RequireSsl

0x0

AllowChangeOnNonsecurePorts

0x1

DisablePasswordChange

0x2

DisableAdvanceExpireNotification

0x4

转换为字符串类型的设置类型

下表包含转换为字符串或字符串数组（取决于设置）的设置值。

说明：

您可能需要为某些设置添加资源或导入这些设置，以便可以在“设置和约束编辑器”中查看这些设置并将它们包含在部署报告中。

设置名称

设置类型（如果不同于设置名称）

所需的子设置

IIS 元数据库名称（如果不同于设置名称）

转换

DefaultDocFooter

  • Footer

  • FileName

一个具有“Footer”的值的字符串，如下所示：

  • 如果“FileName”为 True，则为“File:Footer”。

  • 如果“FileName”为 False，则为“String:Footer”

HttpCustomHeaders

HttpCustomHeader

  • Value

  • Header

一个具有以下值的字符串数组：“Header:Value”

HttpExpires

HttpDocumentExpiration

  • RelativeExpiration

  • AbsoluteExpirationGmtTime

  • RelativeExpirationTimespan

一个将值“D”或“S”指定为 HTML 文件头中的值的字符串，该字符串被返回到浏览器并设置为如下格式：

  • 如果“RelativeExpiration”为 True，则为“D, RelativeExpirationTimespan”

    说明：

    需要将“RelativeExpirationTimespan”转换为总秒数（以十六进制格式表示）。另外，如果“RelativeExpirationTimespan”为“-1.00:00:00”，则将其转换为“0xFFFFFFFF”。

  • 如果“RelativeExpiration”为 False，则为“S, AbsoluteExpirationGmtTime”

    说明：

    需要将“AbsoluteExpirationGmtTime”转换为有效的 GMT 字符串。

HttpErrors

HttpError

  • Code

  • SubCode

  • UrlHandler

  • FileNameHandler

  • FileHandler

一个具有指定值的字符串数组，如下所示：

  • 如果“FileHandler”为 True，则为“Code, SubCode, URL, UrlHandler”

  • 如果“FileHandler”为 False，则为“Code, SubCode, FILE, FileNameHandler”

    说明：

    “Code”也可以是通配符（“*”）值。

MimeMap

  • FileExtension

  • MimeType

一个具有以下子设置值的字符串数组：

"FileExtension, MimeType”

ScriptMaps

ScriptMap

  • FileExtension

  • ScriptProcessor

  • IncludedVerbs

  • Script

  • CheckPathInfo

一个具有以下子设置值的字符串数组：

"FileExtension, ScriptProcessor, Flags, IncludedVerbs”

说明：

可以将星号 (*) 用作“FileExtension”以通过指定的“ScriptProcessor”传送所有请求。

“Flags”取决于“Script”和“CheckPathInfo”，如下所示：

  • 如果“Script”为 False 且“CheckPathInfo”也为 False，则“Flags”为 0。

  • 如果“Script”为 True 而“CheckPathInfo”为 False，则“Flags”为 1。

  • 如果“Script”为 False 而“CheckPathInfo”为 True，则“Flags”为 4。

  • 如果“Script”为 True 且“CheckPathInfo”也为 True，则“Flags”为 5。

SecureBindings

SecureBinding

  • IPAddress

  • Port

一个具有以下子设置值的字符串数组：“IPAddress:Port”

ServerBindings

Binding

  • IPAddress

  • Port

  • HostName

一个具有以下子设置值的字符串数组：“IPAddress:Port:HostName”

WebSvcExtRestrictionList

WebExtension

  • Enabled

  • FilePath

  • InetManagerDeletable

  • GroupID

  • Description

一个具有以下子设置值并采用任一种格式的字符串数组：

  • "Enabled, FilePath, InetManagerDeletable, GroupID, Description”

  • "Enabled, FilePath”

    说明：

    如果为 False，则将“Enabled”和“InetManagerDeletable”转换为 0；如果为 True，则将它们转换为 1。

请参见

任务

如何：在部署报告中查找 ASP.NET 应用程序的 IIS 元数据库设置

如何：在部署报告中查找 IIS Web 服务器的 IIS 元数据库设置

参考

与 IIS 元数据库不同的设置名称

ASP.NET 应用程序的 IIS 设置

IIS Web 服务器的 IIS 设置