Get-MapiVirtualDirectory

参考

模块:: ExchangePowerShell

适用于:: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

此 cmdlet 仅适用于本地 Exchange。

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

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

语法

Get-MapiVirtualDirectory
   -Server <ServerIdParameter>
   [-ADPropertiesOnly]
   [-DomainController <Fqdn>]
   [-ShowMailboxVirtualDirectories]
   [<CommonParameters>]

Get-MapiVirtualDirectory
   [[-Identity] <VirtualDirectoryIdParameter>]
   [-ADPropertiesOnly]
   [-DomainController <Fqdn>]
   [-ShowMailboxVirtualDirectories]
   [<CommonParameters>]

说明

您必须先获得权限，然后才能运行此 cmdlet。虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。

示例

示例 1

Get-MapiVirtualDirectory -Server ContosoMail

本示例返回服务器 ContosoMail 上所有 MAPI 虚拟目录的摘要列表。

示例 2

Get-MapiVirtualDirectory -Identity "ContosoMail\mapi (Default Web Site)" | Format-List

Get-MapiVirtualDirectory "ContosoMail\mapi (Default Web Site)" | Format-List

Get-MapiVirtualDirectory ContosoMai\mapi* | Format-List

这些示例返回名为 ContosoMail 的服务器上名为“mapi (默认网站) ”的 MAPI 虚拟目录的详细信息。所有三个命令都进行相同的操作。

示例 3

Get-MapiVirtualDirectory

本示例返回组织中所有邮箱服务器上的客户端访问服务中所有 MAPI 虚拟目录的摘要列表。

参数

-ADPropertiesOnly

ADPropertiesOnly 开关指定是否仅返回存储在 Active Directory 中的虚拟目录属性。不必为此开关指定值。

如果不使用此开关，则会返回 Active Directory 和 Internet Information Services (IIS) 元数据库的属性。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainController

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

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

Identity 参数指定您要查看的 MAPI 虚拟目录。可以使用唯一标识虚拟目录的任何值。例如：

名称或服务器\名称
可分辨名称 (DN)
GUID

Name 值使用虚拟目录属性中的语法 "VirtualDirectoryName (WebsiteName)" 。可以使用语法 VirtualDirectoryName*指定通配符 (*) 而不是默认网站。

不能在同一个命令中同时使用 Identity 和 Server 参数。

Type:	VirtualDirectoryIdParameter
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Server

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

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

不能在同一个命令中同时使用 Server 和 Identity 参数。

Type:	ServerIdParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ShowMailboxVirtualDirectories

此参数仅在 2013 Exchange Server可用。

ShowMailboxVirtualDirectories 开关显示有关邮箱服务器上的后端虚拟目录的信息。不必为此开关指定值。

默认情况下，此 cmdlet 显示有关邮箱服务器上的客户端访问服务中的虚拟目录的信息。客户端连接从邮箱服务器上的客户端访问服务代理到邮箱服务器上的后端服务。客户端不直接连接到后端服务。

默认情况下，此 cmdlet 显示邮箱服务器上客户端访问服务中的虚拟目录的相关信息。客户端通过代理从邮箱服务器上的客户端访问服务连接到邮箱服务器上的后端服务。客户端不直接连接到后端服务。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013

输入

Input types

若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。

输出

Output types

若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。