Get-SiteMailbox
此 cmdlet 仅适用于本地 Exchange。
使用 Get-SiteMailbox cmdlet 可查看有关站点邮箱的信息。 此 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>]
说明
如果您不是要查看其诊断信息的站点邮箱的成员或所有者，则必须在运行此 cmdlet 时使用 BypassOwnerCheck 参数。 如果您不是站点邮箱的成员或所有者，并且在运行此 cmdlet 时不使用 BypassOwnerCheck 参数，则该命令将失败并返回“未找到对象”错误。
您必须先获得权限，然后才能运行此 cmdlet。 尽管本文列出了 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 cmdlet 将它们从邮箱数据库中删除。
参数
-Anr
适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
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
当运行命令的帐户不是网站邮箱的成员或所有者时，将使用 BypassOwnerCheck 参数。 不必为此开关指定值。
如果不使用此开关，并且你不是网站邮箱的成员或所有者，该命令将失败。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-DeletedSiteMailbox
适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
DeletedSiteMailbox 开关返回被标记为等待删除的站点邮箱。 不必为此开关指定值。
当 SharePoint 中的生命周期应用程序关闭网站邮箱时，网站邮箱会在生命周期策略中指定的时间段内保留为“已关闭”状态。 然后，最终用户或 SharePoint 管理员可以重新激活邮箱。 保留期过后，邮箱数据库中的 Exchange 站点邮箱的名称会附加在前面 MDEL: ，以指示它已标记为要删除。 要释放存储空间和别名，请使用 Remove-Mailbox cmdlet 手动从邮箱数据库中删除这些站点邮箱。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-DomainController
适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
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
Identity 参数指定站点邮箱的标识。 可以使用能够唯一标识邮箱的任意值。 例如：
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- 规范 DN
- GUID
参数属性
| 类型: | RecipientIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 1 |
| 必需: | False |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-ReadFromDomainController
适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
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
ResultSize 参数指定了要返回的结果的最大数量。 若要返回所有与查询相匹配的请求，则请将此参数的值设为无限制。 默认值为 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
若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。