New-OwaVirtualDirectory
此 cmdlet 仅适用于本地 Exchange。
使用 New-OwaVirtualDirectory cmdlet 创建在 Exchange 服务器上的 Internet Information Services 中使用的Outlook 网页版虚拟目录。 通常，在安装了客户端访问服务器角色的 Exchange 服务器上创建虚拟目录。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
Default （默认值）
New-OwaVirtualDirectory
[-ApplicationRoot <String>]
[-AppPoolId <String>]
[-Confirm]
[-DomainController <Fqdn>]
[-ExtendedProtectionFlags <MultiValuedProperty>]
[-ExtendedProtectionSPNList <MultiValuedProperty>]
[-ExtendedProtectionTokenChecking <ExtendedProtectionTokenCheckingMode>]
[-ExternalAuthenticationMethods <MultiValuedProperty>]
[-ExternalUrl <Uri>]
[-InternalUrl <Uri>]
[-Name <String>]
[-Path <String>]
[-Role <VirtualDirectoryRole>]
[-Server <ServerIdParameter>]
[-WebSiteName <String>]
[-WhatIf]
[<CommonParameters>]
说明
默认情况下，安装 Exchange 时，Outlook 网页版虚拟目录 owa 是在服务器上的默认 IIS 网站上创建的。
您必须先获得权限，然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数，但如果某些参数未包含在分配给你的权限中，则可能无法访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
New-OwaVirtualDirectory -WebSiteName "Contoso.com"
此示例在本地 Exchange 服务器上的 IIS 网站（不是默认网站）中创建Outlook 网页版虚拟目录。
参数
-ApplicationRoot
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
ApplicationRoot 参数指定虚拟目录的元数据路径。 默认情况下，此路径与创建虚拟目录的网站的路径相同。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-AppPoolId
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
AppPoolId 参数指定用于运行虚拟目录的 IIS 应用程序池。 我们建议您保留此参数的默认设置。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Confirm
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。
- 破坏性 cmdlet（例如 Remove-* cmdlets）内置有暂停，可强制要求先确认命令，然后再继续操作。 对于这些 cmdlet，您可以使用此确切语法跳过确认提示：
-Confirm:$false。 - 其他大多数 cmdlet（例如 New-* 和 Set-* cmdlet）都没有内置暂停。 对于这些 cmdlet，指定不含值的 Confirm 开关会引入暂停，从而强制要求你先确认命令，然后再继续操作。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-DomainController
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如，dc01.contoso.com。
参数属性
| 类型: | Fqdn |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ExtendedProtectionFlags
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
ExtendedProtectionFlags 参数指定虚拟目录上用于身份验证的扩展保护的自定义设置。 有效值包含:
- 无：这是默认设置。
- AllowDotlessSPN：如果要使用服务主体名称 (SPN) 不包含 FQDN (的值，例如 HTTP/ContosoMail 而不是 HTTP/mail.contoso.com) ，则是必需的。 使用 ExtendedProtectionSPNList 参数指定 SPN。 此设置使针对身份验证的扩展保护的安全性降低，因为无点证书不是唯一的，因此无法确保通过安全通道建立客户端到代理连接。
- NoServiceNameCheck：不会检查 SPN 列表来验证通道绑定令牌。 此设置降低对身份验证的扩展保护的安全性。 通常，建议不使用此设置。
- 代理：代理服务器负责终止 SSL 通道。 若要使用此设置，需要使用 ExtendedProtectionSPNList 参数注册 SPN。
- ProxyCoHosting：HTTP 和 HTTPS 流量可能正在访问虚拟目录，并且代理服务器至少位于 Exchange 服务器上的某些客户端和客户端访问服务之间。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ExtendedProtectionSPNList
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
如果在虚拟目录上使用扩展保护进行身份验证，ExtendedProtectionSPNList 参数指定 (SPN 的有效服务主体名称列表) 。 有效值包含:
- $null：此值为默认值。
- 有效 SPN 的单个 SPN 或逗号分隔列表：SPN 值格式为
Protocol\FQDN。 例如，HTTP/mail.contoso.com。 若要添加非 FQDN (的 SPN，例如 HTTP/ContosoMail) ，还需要为 ExtendedProtectionFlags 参数使用 AllowDotlessSPN 值。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ExtendedProtectionTokenChecking
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
ExtendedProtectionTokenChecking 参数定义如何在虚拟目录上使用扩展保护进行身份验证。 默认情况下，不会启用针对身份验证的扩展保护。 有效值包含:
- 无：对虚拟目录不使用针对身份验证的扩展保护。 此值为默认值。
- None：不在虚拟目录上使用针对验证的扩展保护。 不支持扩展身份验证保护Connections有效，但可能不像使用扩展保护进行身份验证的连接那样安全。
- 要求：针对身份验证的扩展保护用于客户端和虚拟目录之间的所有连接。 如果客户端或服务器不支持，连接将失败。 如果使用此值，还需要为 ExtendedProtectionSPNList 参数设置 SPN 值。
注意：如果使用“允许”或“要求”值，并且客户端和邮箱服务器上的客户端访问服务之间有一个代理服务器（配置为终止客户端到代理 SSL 通道），则还需要使用 ExtendedProtectionSPNList 参数配置一个或多个服务主体名称 (SPN) 。
参数属性
| 类型: | ExtendedProtectionTokenCheckingMode |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ExternalAuthenticationMethods
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
ExternalAuthenticationMethods 参数限制可用于从防火墙外部连接到虚拟目录的身份验证方法。 有效值包含:
- Adfs
- 基本
- 证书
- 摘要
- Fba
- Kerberos
- LiveIdBasic
- LiveIdFba
- LiveIdNegotiate
- NegoEx
- 谈判
- Ntlm
- OAuth
- WindowsIntegrated
- WSSecurity
WSSecurity
尽管可以指定这些值中的任何一个，但身份验证方法是否实际适用于外部连接取决于其他因素。 例如：
- 虽然您可以指定这些值中的任意值，但身份验证方法是否真正适用于内部连接取决于其他因素。例如：
- 虚拟目录上是否有身份验证方法？
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ExternalUrl
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
ExternalURL 参数指定从防火墙外部连接到虚拟目录所使用的 URL。 如果使用安全套接字层 (SSL)，则此设置很重要。
参数属性
| 类型: | Uri |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-InternalUrl
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
InternalURL 参数指定从防火墙内部连接到虚拟目录所使用的 URL。 使用 SSL 时，此设置很重要。
参数属性
| 类型: | Uri |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Name
适用：Exchange Server 2010
此参数仅在 Exchange Server 2010 中可用。
保留此参数以供 Microsoft 内部使用。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 1 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Path
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
Path 参数指定虚拟目录的文件系统路径。 我们建议您仅在需要对虚拟目录文件使用自定义位置时才使用此参数。 默认值为空 ($null)，表示使用的是默认位置。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Role
适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
Role 参数对虚拟目录的配置进行种种。 有效值包含:
- ClientAccess：在邮箱服务器上配置客户端访问 (前端) 服务的虚拟目录。
- 邮箱：为邮箱服务器上的后端服务配置虚拟目录。
客户端连接从客户端访问服务代理到本地或远程邮箱服务器上的后端服务。 客户端不直接连接到后端服务。
参数属性
| 类型: | VirtualDirectoryRole |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Server
适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
Server 参数指定托管虚拟目录的 Exchange 服务器。 可以使用唯一标识该服务器的任何值。 例如：
- 名称
- FQDN
- 可分辨名称 (DN)
- ExchangeLegacyDN
参数属性
| 类型: | ServerIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-WebSiteName
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
WebSiteName 参数指定在其下创建虚拟目录的 IIS 网站的名称。 您无需使用此参数在默认网站下创建虚拟目录。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-WhatIf
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 无线 |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。
输入
Input types
若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。