301重定向参数http://www.site.com$S$Q
变量 | 描述 | 示例 |
$S | 将请求的 URL 的后缀传递给新的 URL。后缀是用重定向的 URL 代替之后,初始 URL 中所保留的部分。 如果未设置 EXACT_DESTINATION 标志,则结果目标 URL 的名称将具有所请求文件的名称(作为文件夹名称)以及文件名本身。 | 如果映射到以下网站的虚拟目录: http://fabrikam/Scripts 配置为重定向到以下确切的 URL: http://fabrikam/NewScripts$S 对以下 URL 的新请求: http://fabrikam/Scripts/Program.exe 将自动重定向至以下 URL: http://fabrikam/NewScripts/Program.exe |
$P | 将初始 URL 中的参数(如 querystring 参数)传递至新的 URL,不包括问号 (?)。 | 如果映射到以下网站的虚拟目录: http://fabrikam/Scripts 配置为重定向到以下 URL: http://fabrikam/NewScripts$P 对以下 URL 的新请求: http://fabrikam/Scripts/File.asp?var1=5&var2=6 将自动重定向至以下 URL: http://fabrikam/NewScriptsvar1=5&var2=6 |
$Q | 将初始 URL 中的参数(如 querystring 参数)传递至新的 URL,包括问号 (?)。 | 如果映射到以下网站的虚拟目录: http://fabrikam/Scripts 配置为重定向到以下确切的 URL: http://fabrikam/NewScripts$S$Q 对以下 URL 的新请求: http://fabrikam/Scripts/File.asp?var1=5&var2=6 将自动重定向至以下 URL: http://fabrikam/NewScripts/File.asp?var1=5&var2=6 |
$V | 传递请求的 URL,不包括服务器名和任何参数。要包含参数,可使用 $P 或 $Q 变量及 $V 变量。 如果未设置 EXACT_DESTINATION 标志,则结果目标 URL 的名称将具有所请求文件的名称(作为文件夹名称)以及文件名本身。 | 如果映射到以下网站的虚拟目录: http://fabrikam/Scripts 配置为重定向到以下确切的 URL: http://contoso$V 对以下 URL 的新请求: http://fabrikam/Scripts/File.asp 将自动重定向至以下 URL: http://contoso/Scripts/File.asp |
使用通配符重定向
可以使用重定向通配符匹配原来 URL 中的任意数目的字符。目标 URL 以星号 (*) 和分号 (;) 开头,成对的通配符和目标 URL 之间用分号分隔。以下示例显示了一个使用通配符的重定向字符串的格式。
*; Wildcard1; Destination1[; Wildcard2; Destination2][, Flags]
其中,WildcardN 可以包括星号 (*) 以匹配初始 URL 中任何数量的字符,并使用下表中定义的变量($0 到 $9)将这些字符传递给 DestinationN。
变量 | 描述 | 示例 |
$0 到 $9 | 传递被请求的 URL 中与指定的通配符相匹配的部分。对于每个 Wildcard;Destination 集,通配符必须从 $0 开始。重定向字符串必须附加 EXACT_DESTINATION 标志。 | 如果映射到以下网站的虚拟目录: http://fabrikam/Scripts 使用以下重定向字符串进行配置: *; /Scripts/*_in.asp; /NewScripts/$0.dll; /Scripts/*_out.asp; http://contoso/NewScripts/$0.dll 对以下 URL 的新请求: http://fabrikam/Scripts/data_in.asp http://fabrikam/Scripts/data_out.asp 将分别自动重定向至以下 URL: http://fabrikam/NewScripts/data.dll http://contoso/NewScripts/data.dll |
! | 不允许重定向。 如果当父目录配置为重定向时要使文件或子目录不被重定向,那么可以使用该变量。 | 如果映射到以下网站的虚拟目录: http://fabrikam/Scripts 配置为重定向到以下网站之外的位置: http://fabrikam/Scripts/Commerce/Accounts 则必须免除重定向,以编程方式将被免除文件夹的重定向字符串设置为: *;! |
例如,要将所有对 /Scripts/Filename.stm 的请求重定向到名为 Default.stm 的文件,并将所有对 /Scripts/Filename.htm 的请求重定向到 Default.htm 文件,请对 /Scripts 虚拟目录使用以下重定向请求:
*;Filename.stm;/Default.stm/Filename.htm;/Default.htm
使用重定向标志
以下标志用于扩充 URL 或通配符格式的重定向字符串。允许多个标志。标志以编程方式附加到 HttpRedirect 中的重定向字符串中,或通过选中“IIS 管理器”中的复选框进行配置。
标志 | 用户界面复选框 | 描述 |
EXACT_DESTINATION | 上面输入的准确 URL | 表示为 Destination 提供的值应被视作绝对目标位置。 |
CHILD_ONLY | 该目录以下的目录 | 通知 IIS 应只发生一次重定向,因为目标位置为初始 URL 的子目录。此标志避免了循环。并且,仅当请求是重定向到初始 URL 的子文件夹或文件时,此标志才指示 IIS 重定向该请求。 |
PERMANENT | 资源的永久重定向 | 表示永久重定向该资源。 |
TEMPORARY | 清除“资源的永久重定向”复选框 | 表示暂时重定向该资源。 |