Get-SiteMailbox

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

使用 Get-SiteMailbox 指令程式檢視站台信箱的相關資訊。 此 Cmdlet 主要是由 Microsoft SharePoint 和 Exchange 用來在使用者介面中向使用者顯示資訊。 不過,您可能會發現它對於探索網站信箱的擁有者、成員和生命週期狀態等資訊沒有幫助。

2017 年的 Exchange Online 和 SharePoint Online 中已不再使用網站信箱。 如需詳細資訊,請參閱網站 信箱的取代。

如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。

語法

Default (預設值)

Get-SiteMailbox
    [[-Identity] <RecipientIdParameter>]
    [-Anr <String>]
    [-BypassOwnerCheck]
    [-DeletedSiteMailbox]
    [-DomainController <Fqdn>]
    [-ReadFromDomainController]
    [-ResultSize <Unlimited>]
    [<CommonParameters>]

Description

若您並非想檢視的診斷資訊之站台信箱成員或擁有者,在執行此指令程式時必須使用 BypassOwnerCheck 參數。 若您不是站台信箱成員或擁有者,且不使用 BypassOwnerCheck 參數執行此指令程式,指令將發生「未找到物件」錯誤而失敗。

您必須已獲指派權限,才能執行此指令程式。 雖然本文列出 Cmdlet 的所有參數,但如果指派給您的權限中未包含某些參數,您可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 Find the permissions required to run any Exchange cmdlet。

範例

範例 1

Get-SiteMailbox -BypassOwnerCheck -Identity ContentSite

此範例會傳回有關網站信箱 ContentSite 的預設資訊,其中包括網站名稱、網站信箱關閉時間,以及 SharePoint URL。

範例 2

Get-SiteMailbox -BypassOwnerCheck -Identity ContentSite | Format-List

此範例傳回站台信箱 ContentSite 的所有相關資訊。

範例 3

Get-SiteMailbox -BypassOwnerCheck -DeletedSiteMailbox | Remove-Mailbox -Confirm:$false

此範例會查詢標記為待刪除的網站信箱,並藉由以管線處理 Remove-Mailbox 指令程式將這些信箱自信箱資料庫中移除。

參數

-Anr

適用項目:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

Anr 參數會指定用來執行模糊名稱解析 (ANR) 搜尋的字串。 您可以指定部分字串,然後搜尋屬性符合該字串的物件。 搜尋的預設屬性如下:

  • CommonName (CN)
  • DisplayName
  • FirstName
  • LastName
  • 別名

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-BypassOwnerCheck

適用項目:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

當執行命令的帳戶不是網站信箱的成員或擁有者時,會使用 BypassOwnerCheck 參數。 您不需要使用此參數指定值。

如果您沒有使用此參數,而且您不是網站信箱的成員或擁有者,則命令將會失敗。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-DeletedSiteMailbox

適用項目:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

DeletedSiteMailbox 參數會傳回已標記為待刪除的站台信箱。 您不需要使用此參數指定值。

當 SharePoint 中的生命週期應用程式關閉網站信箱時,網站信箱會在關閉狀態下保留生命週期原則中指定的期間。 然後,終端使用者或 SharePoint 系統管理員即可重新啟用信箱。 在保留期間之後,會在信 MDEL: 箱資料庫中的 Exchange 網站信箱名稱加上,表示它已標示為要刪除。 若要釋放儲存空間和別名,請使用 Remove-Mailbox Cmdlet 來手動將這些站台信箱自信箱資料庫中移除。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-DomainController

適用項目: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 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

Identity 參數會指定站台信箱的識別碼。 您可以使用可唯一識別信箱的任何值。 例如:

  • 名稱
  • 別名
  • 辨別名稱 (DN)
  • 辨別名稱 (DN)
  • 標準 DN
  • GUID

警告: Identity 參數的值 $null 或不存在的值會傳回 所有 物件,就像您在執行 Get- 命令而不使用Identity 參數一樣。 請確認 Identity 參數的任何值清單均正確無誤,且不包含不存在的$null值。

參數屬性

類型:RecipientIdParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:1
必要:False
來自管線的值:True
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-ReadFromDomainController

適用項目:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

ReadFromDomainController 參數會指定應從使用者網域的網域控制站讀取的資訊。 您不需要使用此參數指定值。

命令: Set-AdServerSettings -ViewEntireForest $true 若要包含樹系中的所有物件,需要 ReadFromDomainController 切換。 否則,命令可能會使用包含過時資訊的通用類別目錄。 此外,您可能需要使用 ReadFromDomainController 參數執行命令的多次反覆運算,才能取得資訊。

預設情況下,收件者範圍設定為裝載 Exchange 伺服器的網域。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ResultSize

適用項目:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

ResultSize 參數會指定傳回的結果筆數上限。 若要傳回符合查詢的所有要求,請使用 unlimited 作為此參數的值。 預設值為 1000。

參數屬性

類型:Unlimited
預設值: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

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