Get-SiteMailbox

参考

模块:: ExchangePowerShell

适用于:: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

此 cmdlet 仅适用于本地 Exchange。

使用 Get-SiteMailbox cmdlet 可查看有关站点邮箱的信息。此 cmdlet 主要由 Microsoft SharePoint 和 Exchange 用于在用户界面中向用户显示信息。但是，可将其用于发现站点邮箱的所有者、成员和生命周期状态之类的信息。

2017 年，Exchange Online 和 SharePoint Online 中弃用了网站邮箱。有关详细信息，请参阅弃用网站邮箱。

有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。

语法

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

Anr 参数指定字符串，用于执行模糊名称解析 (ANR) 搜索。可以指定部分字符串，并搜索其属性与该字符串匹配的对象。搜索的默认属性是：

CommonName (CN)
DisplayName
FirstName
LastName
别名

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-BypassOwnerCheck

当运行命令的帐户不是网站邮箱的成员或所有者时，将使用 BypassOwnerCheck 参数。不必为此开关指定值。

如果不使用此开关，并且你不是网站邮箱的成员或所有者，该命令将失败。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DeletedSiteMailbox

DeletedSiteMailbox 开关返回被标记为等待删除的站点邮箱。不必为此开关指定值。

当 SharePoint 中的生命周期应用程序关闭网站邮箱时，网站邮箱会在生命周期策略中指定的时间段内保留为“已关闭”状态。然后，最终用户或 SharePoint 管理员可以重新激活邮箱。保留期过后，位于邮箱数据库中的 Exchange 站点邮箱的名称将前面附加 MDEL：，以指示已将其标记为要删除。要释放存储空间和别名，请使用 Remove-Mailbox cmdlet 手动从邮箱数据库中删除这些站点邮箱。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainController

DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。可以使用完全限定的域名 (FQDN) 来标识域控制器。例如，dc01.contoso.com。

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

Identity 参数指定站点邮箱的标识。可以使用能够唯一标识邮箱的任意值。例如：

名称
别名
可分辨名称 (DN)
可分辨名称 (DN)
规范 DN
GUID

Type:	RecipientIdParameter
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ReadFromDomainController

ReadFromDomainController 开关指定从用户域中的域控制器读取的信息。不必为此开关指定值。

命令： Set-AdServerSettings -ViewEntireForest $true 若要包含林中的所有对象，需要 ReadFromDomainController 开关。否则，该命令可能会使用包含过时信息的全局编录。此外，可能需要使用 ReadFromDomainController 开关运行命令的多个迭代才能获取信息。

默认情况下，收件人范围设置为托管 Exchange 服务器的域。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ResultSize

ResultSize 参数指定了要返回的结果的最大数量。若要返回所有与查询相匹配的请求，则请将此参数的值设为无限制。默认值为 1000。

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

输入

Input types

若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。

输出

Output types

若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。