Get-EcpVirtualDirectory
內部部署 Exchange 才有提供此 Cmdlet。
使用 Get-EcpVirtualDirectory 指令碼可查看 Exchange 控制台 (ECP) 虛擬目錄,這些目錄用於 Internet Information Services (IIS) 在 Microsoft Exchange 伺服器上。 EAC (Exchange 管理中心) 使用 ECP 虛擬目錄。
ECP 網頁管理介面於 Exchange Server 2010 中引入。 在 Exchange Server 2013 與 Exchange Server 2016 中,EAC 虛擬目錄及對應的管理指令匣名稱仍使用 ECP。 您可以使用這些 cmdlet 管理 Exchange 2010、Exchange 2013 及 Exchange 2016 伺服器上的 ECP 虛擬目錄。
如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。
語法
Server
Get-EcpVirtualDirectory
-Server <ServerIdParameter>
[-ADPropertiesOnly]
[-DomainController <Fqdn>]
[-ShowMailboxVirtualDirectories]
[<CommonParameters>]
Identity
Get-EcpVirtualDirectory
[[-Identity] <VirtualDirectoryIdParameter>]
[-ADPropertiesOnly]
[-DomainController <Fqdn>]
[-ShowMailboxVirtualDirectories]
[<CommonParameters>]
Description
您必須已獲指派權限,才能執行此指令程式。 雖然這篇文章列出了 cmdlet 的所有參數,但如果某些參數未包含在你分配的權限中,你可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 Find the permissions required to run any Exchange cmdlet。
範例
範例 1
Get-EcpVirtualDirectory -Server Server01
此範例回傳了名為 Server01 的伺服器上所有 Exchange 控制台虛擬目錄的摘要清單。
範例 2
Get-EcpVirtualDirectory -Identity "Server01\ecp*" | Format-List
此範例回傳了名為 Server01 伺服器上的 Exchange 控制台 虛擬目錄「ecp (Default Site) 」的詳細資訊。
範例 3
Get-EcpVirtualDirectory
此範例回傳組織內所有郵件匣伺服器用戶端存取服務中 Exchange 控制台虛擬目錄的摘要清單。
參數
-ADPropertiesOnly
適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
ADPropertiesOnly 交換器會指定是否只回傳儲存在 Active Directory 中的虛擬目錄屬性。 您不需要使用此參數指定值。
如果你不使用這個交換器,Active Directory 和 Internet Information Services (IIS) metabase 中的屬性會被回傳。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DomainController
適用:Exchange Server 2010、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 |
-Identity
適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Identity 參數指定你想查看的 ECP 虛擬目錄。 您可以使用任何可唯一識別虛擬目錄的值。 例如:
- 名稱或伺服器\名稱
- 辨別名稱 (DN)
- GUID
名稱值使用虛擬目錄屬性的語法 "VirtualDirectoryName (WebsiteName)" 。 你可以 ) ( 用語法 VirtualDirectoryName*。
您不能在相同的命令中使用 Identity 和 Server 參數。
注意:Identity 參數的值$null或不存在的值,會回傳 所有 物件,就像你執行 Get- 指令時沒有 Identity 參數一樣。 請確認 Identity 參數的值清單是否準確,且不包含不存在的 $null 值。
參數屬性
| 類型: | VirtualDirectoryIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | 1 |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Server
適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Server 參數指定承載虛擬目錄的 Exchange 伺服器。 您可以使用唯一識別伺服器的任何值。 例如:
- Name
- FQDN
- 辨別名稱 (DN)
- 交換遺產
您不能在相同的命令中使用 Server 和 Identity 參數。
參數屬性
| 類型: | ServerIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Server
| Position: | Named |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-ShowMailboxVirtualDirectories
適用:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
ShowMailboxVirtualDirectory 交換器顯示 Mailbox 伺服器後端虛擬目錄的資訊。 您不需要使用此參數指定值。
預設情況下,此指令子會顯示郵件匣伺服器上用戶端存取服務中虛擬目錄的資訊。 用戶端連線由郵箱伺服器上的用戶端存取服務代理至郵箱伺服器的後端服務。 Clients don't connect directly to the backend services.
根據預設,此 Cmdlet 會顯示信箱伺服器之用戶端存取服務中虛擬目錄的相關資訊。系統會將用戶端連線從信箱伺服器上的用戶端存取服務 Proxy 處理到信箱伺服器上的後端服務。用戶端不直接連接後端服務。
參數屬性
| 類型: | 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
若要查看此指令程式可接受的輸入類型,請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的,表示指令程式不接受輸入資料。
輸出
Output types
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型),請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的,表示指令程式不會傳回資料。