Get-MailboxLocation
內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 某些參數和設定可能僅限於一個環境或另一個環境。
使用 Get-MailboxLocation Cmdlet 來檢視 Exchange Online 中的信箱位置資訊。
如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。
語法
DatabaseSet
Get-MailboxLocation
-Database <DatabaseIdParameter>
[-Confirm]
[-MailboxLocationType <MailboxLocationType>]
[-ResultSize <Unlimited>]
[-WhatIf]
[<CommonParameters>]
Identity
Get-MailboxLocation
-Identity <MailboxLocationIdParameter>
[-Confirm]
[-MailboxLocationType <MailboxLocationType>]
[-ResultSize <Unlimited>]
[-WhatIf]
[<CommonParameters>]
User
Get-MailboxLocation
-User <UserIdParameter>
[-IncludePreviousPrimary]
[-Confirm]
[-MailboxLocationType <MailboxLocationType>]
[-ResultSize <Unlimited>]
[-WhatIf]
[<CommonParameters>]
Description
您必須已獲指派權限,才能執行此指令程式。 雖然本文列出 Cmdlet 的所有參數,但如果指派給您的權限中未包含某些參數,您可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 Find the permissions required to run any Exchange cmdlet。
範例
範例 1
Get-MailboxLocation -User chris@contoso.com
在 Exchange Online 中,此範例會傳回使用者chris@contoso.com的信箱位置資訊。
範例 2
Get-MailboxLocation -Identity e15664af-82ed-4635-b02a-df7c2e03d950
在 Exchange Server 或 Exchange Online 中,本範例會從) 的結果Get-Mailbox -Identity <MailboxIdentity> | Format-List ExchangeGuid傳回所指定信箱 GUID 的信箱位置資訊 (ExchangeGuid 屬性值。
參數
-Confirm
適用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | CF |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Database
適用項目:Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此參數僅適用於內部部署 Exchange。
Database 參數會傳回指定信箱資料庫中所有信箱的信箱位置資訊。 您可以使用唯一識別資料庫的任何值。 例如:
- 名稱
- 辨別名稱 (DN)
- GUID
資料庫名稱
參數屬性
| 類型: | DatabaseIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
DatabaseSet
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Identity
適用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
Identity 參數會指定您要檢視的信箱位置物件。 此值會使用下列其中一種格式:
- TenantGUID\MailboxGUID
- MailboxGUID
在 Exchange Server 或 Exchange Online 中,您可以執行以下命令來尋找和比較使用者的 MailboxGUID 值: Get-Mailbox -Identity <MailboxIdentity> | Format-List *GUID,MailboxLocations。
在 Exchange Online 中,您可以在使用 User 參數執行 Get-MailboxLocation 之後找到 TenantGUID 和 MailboxGUID 值。
您無法將此參數與 User 參數搭配使用。
警告: Identity 參數的值 $null 或不存在的值會傳回 所有 物件,就像您在執行 Get- 命令而不使用Identity 參數一樣。 請確認 Identity 參數的任何值清單均正確無誤,且不包含不存在的$null值。
參數屬性
| 類型: | MailboxLocationIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-IncludePreviousPrimary
適用:Exchange Online
此參數只能在雲端式服務中使用。
IncludePreviousPrimary 參數會指定是否要在結果中包含上一個主要信箱。 您不需要使用此參數指定值。
您只能將此參數與 User 參數搭配使用。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
User
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-MailboxLocationType
適用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
MailboxLocationType 會依信箱類型篩選結果。 有效值為:
- 彙總
- AuxArchive
- AuxPrimary
- ComponentShared
- MainArchive
- Previous主要 (Exchange Online 僅限)
- 主要
參數屬性
| 類型: | MailboxLocationType |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ResultSize
適用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ResultSize 參數會指定傳回的結果筆數上限。 若要傳回符合查詢的所有要求,請使用 unlimited 作為此參數的值。 預設值為 1000。
參數屬性
| 類型: | Unlimited |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-User
適用:Exchange Online
此參數只能在雲端式服務中使用。
User 參數會指定您要檢視其信箱位置的使用者。 您可以使用唯一識別使用者的任何值。 例如:
- 名稱
- 辨別名稱 (DN)
- 辨別名稱 (DN)
- GUID
資料庫名稱
參數屬性
| 類型: | UserIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
User
| Position: | Named |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-WhatIf
適用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | WI |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援常見參數: -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。