Set-AutodiscoverVirtualDirectory
此 cmdlet 仅适用于本地 Exchange。
使用 Set-AutodiscoverVirtualDirectory cmdlet 配置自动发现在 Exchange 服务器上的 Internet Information Services (IIS) 中使用的虚拟目录。
有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。
语法
Default (默认值)
Set-AutodiscoverVirtualDirectory
[-Identity] <VirtualDirectoryIdParameter>
[-BasicAuthentication <Boolean>]
[-Confirm]
[-DigestAuthentication <Boolean>]
[-DomainController <Fqdn>]
[-ExtendedProtectionFlags <MultiValuedProperty>]
[-ExtendedProtectionSPNList <MultiValuedProperty>]
[-ExtendedProtectionTokenChecking <ExtendedProtectionTokenCheckingMode>]
[-ExternalUrl <Uri>]
[-InternalUrl <Uri>]
[-OAuthAuthentication <Boolean>]
[-WhatIf]
[-WindowsAuthentication <Boolean>]
[-WSSecurityAuthentication <Boolean>]
[<CommonParameters>]
说明
您必须先获得权限,然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数,但如果某些参数未包含在分配给你的权限中,则可能无法访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Set-AutodiscoverVirtualDirectory -Identity 'Autodiscover(Default Web Site)' -WindowsAuthentication $false -BasicAuthentication $false -DigestAuthentication $true
本示例将自动发现虚拟目录的身份验证方法设置为“摘要式”身份验证。
示例 2
Set-AutodiscoverVirtualDirectory -Identity 'autodiscover (default Web site)' -ExternalUrl 'https://www.contoso.com'
在 Exchange Server 2010 中,此示例设置自动发现虚拟目录的外部 URL。
示例 3
Set-AutodiscoverVirtualDirectory -Identity 'Autodiscover (Default Web Site)' -WindowsAuthentication $true
本示例设置自动发现虚拟目录的集成Windows 身份验证。
参数
-BasicAuthentication
适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
BasicAuthentication 参数指定是否在虚拟目录上启用基本身份验证。 有效值包含:
- $true:已启用基本身份验证。 此值为默认值。
- $true:启用基本身份验证。此为默认值。
参数属性
| 类型: | Boolean |
| 默认值: | 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 |
-DigestAuthentication
适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
DigestAuthentication 参数指定是否在虚拟目录上启用摘要式身份验证。 有效值包含:
- $true:已启用摘要式身份验证。
- $false:禁用摘要式身份验证。 此值为默认值。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(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 |
-ExternalUrl
适用:Exchange Server 2010
此参数仅在 Exchange Server 2010 中可用。
ExternalUrl 参数指定用于从网络防火墙外部连接到虚拟目录的 URL。
参数属性
| 类型: | Uri |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Identity
适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
Identity 参数指定您想要修改的自动发现虚拟目录。 可以使用唯一标识虚拟目录的任何值。 例如:
- 名称或服务器\名称
- 可分辨名称 (DN)
- GUID
Name 值使用虚拟目录属性中的语法 "VirtualDirectoryName (WebsiteName)" 。 可以使用 语法 VirtualDirectoryName*指定通配符 (*) 而不是默认网站。
参数属性
| 类型: | VirtualDirectoryIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
-InternalUrl
适用:Exchange Server 2010
此参数仅在 Exchange Server 2010 中可用。
InternalUrl 参数指定用于从网络防火墙内部连接到虚拟目录的 URL。
参数属性
| 类型: | Uri |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-OAuthAuthentication
适用:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
OAuthAuthentication 参数指定是否在虚拟目录上启用 OAuth 身份验证。 有效值包含:
- $true:已启用 OAuth 身份验证。 此值为默认值。
- $false:OAuth 身份验证已禁用。
参数属性
| 类型: | Boolean |
| 默认值: | 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 |
-WindowsAuthentication
适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
WindowsAuthentication 参数指定是否在虚拟目录上启用集成Windows 身份验证。 有效值包含:
- $true:已启用集成Windows 身份验证。 此值为默认值。
- $false:已禁用集成Windows 身份验证。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-WSSecurityAuthentication
适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
WSSecurityAuthentication 参数指定是否在虚拟目录上启用 WS-Security (Web 服务安全性) 身份验证。 有效值包含:
- $true:已启用 WS-Security 身份验证。 此值为默认值。
- $true:启用 WS-安全性身份验证。此为默认值。
参数属性
| 类型: | Boolean |
| 默认值: | 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 不返回任何数据。