Get-MailboxImportRequestStatistics
內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 某些參數和設定可能僅限於一個環境或另一個環境。
使用 Get-MailboxImportRequestStatistics 指令程式檢視有關匯入要求的詳細資訊。
此 Cmdlet 僅適用於信箱匯入匯出角色,而且根據預設,此角色不會指派給任何角色群組。 若您要使用此 cmdlet,必須將「信箱匯入匯出」角色新增至角色群組 (例如,Organization Management 角色群組)。 如需詳細資訊,請參閱 將角色新增至角色群組。
如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。
語法
IdentityOnPremises
Get-MailboxImportRequestStatistics
[-Identity] <MailboxImportRequestIdParameter>
[-Diagnostic]
[-DiagnosticArgument <String>]
[-DomainController <Fqdn>]
[-IncludeReport]
[-ReportOnly]
[<CommonParameters>]
IdentityCloud
Get-MailboxImportRequestStatistics
[-Identity] <MailboxImportRequestIdParameter>
[-DiagnosticInfo <String>]
[-IncludeReport]
[-IncludeSkippedItems]
[-ReportOnly]
[<CommonParameters>]
MigrationMRSInstance
Get-MailboxImportRequestStatistics
-MRSInstance <Fqdn>
[-DomainController <Fqdn>]
[-RequestGuid <Guid>]
[<CommonParameters>]
MigrationRequestQueue
Get-MailboxImportRequestStatistics
-RequestQueue <DatabaseIdParameter>
[-Diagnostic]
[-DiagnosticArgument <String>]
[-DomainController <Fqdn>]
[-IncludeReport]
[-ReportOnly]
[-RequestGuid <Guid>]
[<CommonParameters>]
Description
您可以從 Get-MailboxImportRequest 指令程式使用管線處理 Get-MailboxImportRequestStatistics 指令程式。
您必須已獲指派權限,才能執行此指令程式。 雖然本文列出 Cmdlet 的所有參數,但如果指派給您的權限中未包含某些參數,您可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 Find the permissions required to run any Exchange cmdlet。
範例
範例 1
Get-MailboxImportRequestStatistics -Identity Tony\MailboxImport1
此範例會傳回 Tony Smith 之第二個匯入要求的預設統計資料。 預設傳回的資訊類型包括名稱、信箱和狀態。
範例 2
Get-MailboxImportRequestStatistics -Identity Tony\MailboxImport1 | Export-CSV \\SERVER01\ImportRequest_Reports\Tony_Importstats.csv
此範例會傳回 Tony Smith 信箱之第二個匯入要求的詳細統計資料,並且將報告匯出成 .csv 檔案。
範例 3
Get-MailboxImportRequestStatistics -Identity Tony\LegalHold -IncludeReport | Format-List
此範例會透過使用 IncludeReport 參數和將結果透過管線傳送到 Format-List 命令等方式,傳回有關 Tony Smith 信箱之匯入要求的其他資訊。
範例 4
Get-MailboxImportRequestStatistics -MRSInstance CAS01.contoso.com
在 Exchange Server 2010 中,此範例會傳回由伺服器 CAS01 上執行的 MRS 執行個體所處理的匯入要求的預設統計資料。
範例 5
Get-MailboxImportRequest -Status Failed | Get-MailboxImportRequestStatistics -IncludeReport | Format-List > AllImportReports.txt
此範例會使用 IncludeReport 參數傳回所有狀態為 Failed 的匯入要求之其他資訊,並將資訊儲存到文字檔 AllExportReports.txt。
參數
-Diagnostic
適用項目:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此參數僅適用於內部部署 Exchange。
Diagnostic 參數指定是否要在結果中傳回極詳細的資訊。 您不需要使用此參數指定值。
一般而言,您只能在 Microsoft 客戶服務和支援中心要求排解疑難問題時使用此參數。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
IdentityOnPremises
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
MigrationRequestQueue
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DiagnosticArgument
適用項目:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此參數僅適用於內部部署 Exchange。
DiagnosticArgument 參數可使用 Diagnostic 參數修改所傳回的結果。 一般而言,您只能在 Microsoft 客戶服務和支援中心要求排解疑難問題時使用 Diagnostic 參數和 DiagnosticArgument 參數。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
IdentityOnPremises
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
MigrationRequestQueue
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DiagnosticInfo
適用:Exchange Online
此參數只能在雲端式服務中使用。
通常,只有在 Microsoft 客戶服務和支援人員的要求時,才使用 DiagnosticInfo 參數來疑難排解問題。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
IdentityCloud
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DomainController
適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此參數僅適用於內部部署 Exchange。
DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如,dc01.contoso.com。
參數屬性
| 類型: | Fqdn |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
IdentityOnPremises
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
MigrationRequestQueue
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
MigrationMRSInstance
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Identity
適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
Identity 參數會指定匯入要求的識別碼。 根據預設,匯入要求的名稱 <alias>\MailboxImportX 為 (,其中 X = 0-9) 。 如果您在建立匯入要求時指定了名稱,請使用下列語法: Alias\Name。
注意:在 Exchange Online 中,虛刪除信箱的別名可能與使用中信箱的別名相符。 若要確保唯一性,請使用來自 Get-MailboxImportRequest cmdlet 輸出的 RequestGuid 值作為此參數的值。
警告: Identity 參數的值 $null 或不存在的值會傳回 所有 物件,就像您在執行 Get- 命令而不使用Identity 參數一樣。 請確認 Identity 參數的任何值清單均正確無誤,且不包含不存在的$null值。
參數屬性
| 類型: | MailboxImportRequestIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
IdentityOnPremises
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
IdentityCloud
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-IncludeReport
適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
IncludeReport 參數會指定是否傳回可用於疑難排解之要求的額外詳細資訊。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
IdentityOnPremises
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
IdentityCloud
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
MigrationRequestQueue
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-IncludeSkippedItems
適用:Exchange Online
此參數只能在雲端式服務中使用。
{{ 填滿 IncludeSkippedItems 描述 }}
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
IdentityCloud
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-MRSInstance
適用:Exchange Server 2010
MRSInstance 參數會指定 Microsoft Exchange 信箱複寫服務 (MRS) 所在用戶端存取伺服器的完整網域名稱 (FQDN) 。 使用此參數時,會針對此 MRS 執行個體傳回所有記錄。
您無法將此參數與 Identity 或 RequestQueue 參數搭配使用。
參數屬性
| 類型: | Fqdn |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
MigrationMRSInstance
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ReportOnly
適用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ReportOnly 參數會將結果傳回為報表項目陣列 () 的編碼字串。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
IdentityOnPremises
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
IdentityCloud
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
MigrationRequestQueue
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RequestGuid
適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此參數僅適用於內部部署 Exchange。
RequestGuid 參數與 RequestQueue 參數一起 (,) 指定匯入要求的唯一識別碼。 若要尋找匯入要求 GUID,請使用 Get-MailboxImportRequest 指令程式。
資料庫名稱
參數屬性
| 類型: | Guid |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
MigrationMRSInstance
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
MigrationRequestQueue
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RequestQueue
適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此參數僅適用於內部部署 Exchange。
此參數僅用於偵錯目的。
RequestQueue 參數會根據執行要求的信箱資料庫來識別要求。 您可以使用唯一識別資料庫的任何值。 例如:
- 名稱
- 辨別名稱 (DN)
- GUID
資料庫名稱
參數屬性
| 類型: | DatabaseIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
MigrationRequestQueue
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援常見參數: -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。
輸入
Input types
若要查看此指令程式可接受的輸入類型,請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的,表示指令程式不接受輸入資料。
輸出
Output types
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型),請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的,表示指令程式不會傳回資料。