Get-MapiVirtualDirectory

參考

模組:: ExchangePowerShell

適用於:: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

內部部署 Exchange 才有提供此 Cmdlet。

使用 Get-MapiVirtualDirectory Cmdlet 來檢視 MAPI (MAPI) 虛擬目錄的訊息應用程式開發介面，這些虛擬目錄是用於 Microsoft Exchange 伺服器上的 Internet Information Services (IIS) 。 MAPI 虛擬目錄是由支援的 Microsoft Outlook 版本使用，以使用 MAPIHTTP 通訊協定連線到信箱。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

Syntax

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

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

Description

您必須已獲指派權限，才能執行此指令程式。雖然本主題已列出這個指令程式的所有參數，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。若要尋找在組織中執行任何 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 (Default Web Site) 」的 MAPI 虛擬目錄詳細資訊。以上三個命令的作用相同。

範例 3

Get-MapiVirtualDirectory

此範例會傳回組織中所有信箱伺服器上的用戶端存取服務中所有 MAPI 虛擬目錄的摘要清單。

參數

-ADPropertiesOnly

ADPropertiesOnly 參數會指定是否只傳回儲存在 Active Directory 中的虛擬目錄屬性。您不需要使用此參數指定值。

如果您未使用此參數，則會傳回 Active Directory 和 Internet Information Services (IIS) metabase 中的屬性。

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 伺服器。您可以使用唯一識別伺服器的任何值。例如：

Name
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 參數會顯示 Mailbox 伺服器上後端虛擬目錄的相關資訊。您不需要使用此參數指定值。

根據預設，此 Cmdlet 會顯示信箱伺服器上用戶端存取服務中虛擬目錄的相關資訊。用戶端連線會從信箱伺服器上的用戶端存取服務，代理到信箱伺服器上的後端服務。 Clients don't connect directly to the backend services.

根據預設，此 Cmdlet 會顯示信箱伺服器之用戶端存取服務中虛擬目錄的相關資訊。系統會將用戶端連線從信箱伺服器上的用戶端存取服務 Proxy 處理到信箱伺服器上的後端服務。用戶端不直接連接後端服務。

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

輸入

Input types

若要查看此指令程式可接受的輸入類型，請參閱指令程式輸入和輸出類型。如果指令程式的 [輸入類型] 欄位是空的，表示指令程式不接受輸入資料。

輸出

Output types

若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。

共用方式為