New-MapiVirtualDirectory

模块:
Exchange PowerShell

此 cmdlet 仅适用于本地 Exchange。

使用 New-MapiVirtualDirectory cmdlet 创建消息传送应用程序编程接口 (MAPI) 虚拟目录，这些目录在 Internet Information Services (Microsoft Exchange 服务器上的 IIS) 中使用。 受支持版本的 Microsoft Outlook 使用 MAPI 虚拟目录通过 MAPIHTTP 协议连接到邮箱。

有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。

语法

Default (默认值) 

New-MapiVirtualDirectory

    [-Confirm]
    [-DomainController <Fqdn>]
    [-ExtendedProtectionFlags <MultiValuedProperty>]
    [-ExtendedProtectionSPNList <MultiValuedProperty>]
    [-ExtendedProtectionTokenChecking <ExtendedProtectionTokenCheckingMode>]
    [-ExternalUrl <Uri>]
    [-IISAuthenticationMethods <MultiValuedProperty>]
    [-InternalUrl <Uri>]
    [-Role <VirtualDirectoryRole>]
    [-Server <ServerIdParameter>]
    [-WebSiteName <String>]
    [-WhatIf]
    [<CommonParameters>]

说明

您必须先获得权限，然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数，但如果某些参数未包含在分配给你的权限中，则可能无法访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。

示例

示例 1

New-MapiVirtualDirectory -InternalUrl https://contoso.com/mapi -IISAuthenticationMethods NTLM,Negotiate,OAuth

此示例创建具有以下配置的新 MAPI 虚拟目录：

  • 内部 URL： https://contoso.com/mapi
  • IIS 身份验证方法：NTLM、Negotiate 和 OAuth。

参数

-Confirm

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如，dc01.contoso.com。

参数属性

类型:Fqdn
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ExtendedProtectionFlags

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

ExtendedProtectionFlags 参数指定虚拟目录上用于身份验证的扩展保护的自定义设置。 有效值包含:

  • 无：这是默认设置。
  • AllowDotlessSPN：如果要使用服务主体名称 (SPN) 不包含 FQDN (的值，例如 HTTP/ContosoMail 而不是 HTTP/mail.contoso.com) ，则是必需的。 使用 ExtendedProtectionSPNList 参数指定 SPN。 此设置使针对身份验证的扩展保护的安全性降低，因为无点证书不是唯一的，因此无法确保通过安全通道建立客户端到代理连接。
  • NoServiceNameCheck：不会检查 SPN 列表来验证通道绑定令牌。 此设置降低对身份验证的扩展保护的安全性。 通常，建议不使用此设置。
  • 代理：代理服务器负责终止 TLS 通道。 若要使用此设置，需要使用 ExtendedProtectionSPNList 参数注册 SPN。
  • ProxyCoHosting：HTTP 和 HTTPS 流量可能正在访问虚拟目录，并且代理服务器至少位于 Exchange 服务器上的某些客户端和客户端访问服务之间。

参数属性

类型:MultiValuedProperty
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ExtendedProtectionSPNList

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

如果在虚拟目录上使用扩展保护进行身份验证，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 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

ExtendedProtectionTokenChecking 参数指定是否对到虚拟目录的客户端连接使用用于身份验证的扩展保护。 有效值包含:

  • 无：针对身份验证的扩展保护不用于到虚拟目录的客户端连接。 此值为默认值。
  • 允许：如果客户端和服务器都支持，则对到虚拟目录的客户端连接使用扩展身份验证保护。
  • 要求：客户端连接到虚拟目录时，需要对身份验证进行扩展保护。 如果客户端或服务器不支持它，连接将失败。 此值还需要服务主体名称 (SPN) ExtendedProtectionSPNList 参数的值。

注意：如果 Exchange 服务器前面的代理服务器终止了客户端到代理传输层安全性 (TLS) 通道，则值 Allow 或 Require 需要一个或多个 SPN 值作为 ExtendedProtectionSPNList 参数。

参数属性

类型:ExtendedProtectionTokenCheckingMode
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ExternalUrl

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

ExternalURL 参数指定从防火墙外部连接到虚拟目录的 URL。

此设置强制实施传输层安全性 (TLS) 协议，并使用默认 TLS 端口。 此参数使用语法 https://<Domain Name>/mapi。 例如，https://external.contoso.com/mapi。

使用 InternalUrl 或 ExternalUrl 参数时，您需要通过 IISAuthenticationMethods 参数指定一个或多个身份验证值。

参数属性

类型:Uri
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-IISAuthenticationMethods

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

IISAuthenticationMethods 参数指定针对 Internet 信息服务 (IIS) 中的虚拟目录启用的身份验证方法。 PasswordQuality 参数指定设备密码所需的最小密码质量分级。密码质量是指示密码安全性和复杂性的数值。质量值越高表示密码越安全。

  • 基本
  • 洽谈
  • NTLM
  • OAuth

可以指定用逗号分隔的多个值。

默认值为 NTLM、OAuth 和 Negotiate。 建议始终为 OAuth 配置虚拟目录。

有关不同身份验证方法的详细信息，请参阅 了解 HTTP 身份验证 和 什么是 OAuth 身份验证？。

参数属性

类型:MultiValuedProperty
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-InternalUrl

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

InternalURL 参数指定从防火墙内部连接到虚拟目录的 URL。

此设置强制实施传输层安全性 (TLS) 协议，并使用默认 TLS 端口。 此参数使用语法 https://<Domain Name>/mapi。 例如，https://internal.contoso.com/mapi。

使用 InternalUrl 或 ExternalUrl 参数时，您需要通过 IISAuthenticationMethods 参数指定一个或多个身份验证值。

参数属性

类型:Uri
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Role

适用：Exchange Server 2013

Role 参数对虚拟目录的配置进行种种。 有效值包含:

  • ClientAccess：在邮箱服务器上配置客户端访问 (前端) 服务的虚拟目录。
  • 邮箱：为邮箱服务器上的后端服务配置虚拟目录。

客户端连接从客户端访问服务代理到本地或远程邮箱服务器上的后端服务。 客户端不直接连接到后端服务。

参数属性

类型:VirtualDirectoryRole
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Server

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

Server 参数指定托管虚拟目录的 Exchange 服务器。 可以使用唯一标识该服务器的任何值。 例如：

  • 名称
  • FQDN
  • 可分辨名称 (DN)
  • ExchangeLegacyDN

参数属性

类型:ServerIdParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:True
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-WebSiteName

适用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE

WebSiteName 参数指定在其下创建虚拟目录的 IIS 网站的名称。 您无需使用此参数在默认网站下创建虚拟目录。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-WhatIf

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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 不返回任何数据。