Get-Mailbox

  • 项目

 

适用于： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

上一次修改主题： 2010-04-27

使用 Get-Mailbox cmdlet 可以查看邮箱对象和属性、填充属性页或向其他任务提供邮箱信息。

语法

get-Mailbox [-Identity <MailboxIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

get-Mailbox [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>] [-SortBy <String>]

get-Mailbox [-Credential <PSCredential>] [-Database <DatabaseIdParameter>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

get-Mailbox [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

get-Mailbox [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

详细说明

Get-Mailbox cmdlet 用于检索邮箱的属性和对象。没有必需参数。如果在没有参数的情况下使用该 cmdlet，则列出组织中的所有邮箱。

若要运行 Get-Mailbox cmdlet，必须为您使用的帐户委派以下角色：

  • Exchange 仅查看管理员角色

有关管理 Microsoft Exchange Server 2007 所需的权限、角色委派以及权利的详细信息，请参阅权限注意事项。

note注意：
若要使用 Get-Mailbox cmdlet 准确评估当前的存储配额状态，除了查看 ProhibitSendQuota、ProhibitSendReceiveQuota 和 IssueWarningQuota 属性外，还需要查看 UseDatabaseQuotaDefaults 属性。如果 UseDatabaseQuotaDefaults 属性的值为 True，则意味着将忽略每个邮箱的设置，而使用邮箱数据库限制。如果此属性值设置为 True，并且 ProhibitSendQuota、ProhibitSendReceiveQuota 和 IssueWarningQuota 属性设置为 unlimited，则邮箱大小不是无限制的。实际上，必须参考邮箱数据库存储限制才能了解邮箱的限制。如果 UseDatabaseQuotaDefaults 属性的值为 False，则意味着将使用每个邮箱的设置。

参数

参数 必需 类型 说明

Anr

可选

System.String

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

  • CommonName (CN)

  • DisplayName

  • FirstName

  • LastName

  • 别名

Credential

可选

System.Management.Automation.PSCredential

Credential 参数指定用于访问 Active Directory 目录服务的用户名和密码。

Database

可选

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

Database 参数指定从其获取邮箱的数据库。可以使用下列值：

  • 数据库的 GUID

  • 数据库名称

  • 服务器名称\数据库名称

  • 服务器名称\存储组\数据库称

如果未指定服务器名称，cmdlet 将搜索本地服务器上的数据库。如果同一服务器上存在多个同名的数据库，则必须指定存储组。

此参数不能与 Filter 参数一起使用。

DomainController

可选

Microsoft.Exchange.Data.Fqdn

DomainController 参数指定用于访问 Active Directory 的域控制器。请使用要使用的域控制器的完全限定的域名 (FQDN)。

Filter

可选

System.String

Filter 参数指定一个或多个用于限制查询所返回邮箱的属性。

此参数不能与 Database 参数一起使用。

有关可筛选属性的详细信息，请参阅-Filter 参数的可筛选属性。

Identity

可选

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Identity 参数用于标识邮箱。可以使用下列值之一：

  • GUID

  • Distinguished name (DN)

  • 域\帐户

  • User principal name (UPN)

  • LegacyExchangeDN

  • Smtp 地址

  • 别名

IgnoreDefaultScope

可选

System.Management.Automation.SwitchParameter

IgnoreDefaultScope 参数指示命令忽略 Exchange 命令行管理程序的默认收件人作用域设置，并将整个林作为作用域。这使该命令能够访问当前默认作用域中不存在的 Active Directory 对象。使用 IgnoreDefaultScope 参数引入以下限制：

  • 不能使用 DomainController 参数。该命令将自动使用相应的全局编录服务器。

  • 仅可以对 Identity 参数使用 DN。不接受其他形式的标识，如别名或 GUID。

  • 不能同时使用 OrganizationalUnit 参数和 Identity 参数。

  • 不能使用 Credential 参数。

OrganizationalUnit

可选

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

OrganizationalUnit 参数指定组织单位 (OU)，并用于限制结果。如果使用此参数，将只获取所指定的容器中的邮箱。可以使用 OU 或域名。如果使用 OU，则必须指定 OU 的规范名称。

ReadFromDomainController

可选

System.Management.Automation.SwitchParameter

ReadFromDomainController 参数指定从用户域中的域控制器读取的用户信息。如果将收件人作用域设置为包括林中的所有收件人，且不使用此参数，则有可能从包含过期信息的全局编录中读取用户信息。如果使用此参数，则可能需要多次读取才能获取该信息。

note注意：
默认情况下，收件人作用域被设置为驻留 Exchange 服务器的域。

RecipientTypeDetails

可选

Microsoft.Exchange.Data.Directory.Recipient.RecipientTypeDetails[]

RecipientTypeDetails 参数指定返回的收件人的类型。Microsoft Exchange Server 2007 的收件人类型分为收件人类型和子类型。每个收件人类型包含所有子类型的所有常见属性。例如，类型 UserMailbox 代表 Active Directory 中具有关联邮箱的用户帐户。因为存在多种邮箱类型，所以每个邮箱类型都由 RecipientTypeDetails 参数标识。例如，会议室邮箱将 RecipientTypeDetails 设置为 RoomMailbox，而用户邮箱将 RecipientTypeDetails 设置为 UserMailbox。

对于该命令，可用的收件人类型详细信息包括：

  • RoomMailbox

  • EquipmentMailbox

  • LegacyMailbox

  • LinkedMailbox

  • UserMailbox

  • SharedMailbox

ResultSize

可选

Microsoft.Exchange.Data.Unlimited

ResultSize 参数指定要返回的最大结果数。如果希望返回与查询条件匹配的所有邮箱，请使用“unlimited”作为此参数的值。默认值为 1000。

Server

可选

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Server 参数指定单个服务器，并用于限制结果。如果使用此参数，将只获取驻留在所指定的服务器上的邮箱。请使用要指定服务器的公用名。

SortBy

可选

System.String

SortBy 参数指定用来对结果排序的属性。一次只能按一个属性进行排序。可以按下列属性排序：

  • 别名

  • 显示名称

  • 名称

结果将按升序进行排序。

输入类型

返回类型

错误

错误 说明

 

异常

异常 说明

 

示例

第一个示例显示如何获取组织中所有邮箱的列表。

第二个示例显示如何获取在 Contoso.com 域的用户容器中的组织内所有邮箱的列表。

第三个示例说明如何获取 DC01 域中对字符串“Chr”进行模糊名称解析搜索所得到的所有邮箱。它将 Chris Ashton、Christian Cletus 和 Christa Geller 等用户的邮箱。

Get-Mailbox -ResultSize unlimited
Get-Mailbox -OrganizationalUnit Users
Get-Mailbox -Anr Chr -DomainController DC01