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 所需的权限、角色委派以及权利的详细信息,请参阅权限注意事项。
注意: |
---|
若要使用 Get-Mailbox cmdlet 准确评估当前的存储配额状态,除了查看 ProhibitSendQuota、ProhibitSendReceiveQuota 和 IssueWarningQuota 属性外,还需要查看 UseDatabaseQuotaDefaults 属性。如果 UseDatabaseQuotaDefaults 属性的值为 True,则意味着将忽略每个邮箱的设置,而使用邮箱数据库限制。如果此属性值设置为 True,并且 ProhibitSendQuota、ProhibitSendReceiveQuota 和 IssueWarningQuota 属性设置为 unlimited,则邮箱大小不是无限制的。实际上,必须参考邮箱数据库存储限制才能了解邮箱的限制。如果 UseDatabaseQuotaDefaults 属性的值为 False,则意味着将使用每个邮箱的设置。 |
参数
参数 | 必需 | 类型 | 说明 | ||
---|---|---|---|---|---|
Anr |
可选 |
System.String |
Anr 参数指定对其执行模糊名称解析搜索的字符串。可以指定部分字符串,并搜索其属性与该字符串匹配的对象。所搜索的默认属性是:
|
||
Credential |
可选 |
System.Management.Automation.PSCredential |
Credential 参数指定用于访问 Active Directory 目录服务的用户名和密码。 |
||
Database |
可选 |
Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter |
Database 参数指定从其获取邮箱的数据库。可以使用下列值:
如果未指定服务器名称,cmdlet 将搜索本地服务器上的数据库。如果同一服务器上存在多个同名的数据库,则必须指定存储组。 此参数不能与 Filter 参数一起使用。 |
||
DomainController |
可选 |
Microsoft.Exchange.Data.Fqdn |
DomainController 参数指定用于访问 Active Directory 的域控制器。请使用要使用的域控制器的完全限定的域名 (FQDN)。 |
||
Filter |
可选 |
System.String |
Filter 参数指定一个或多个用于限制查询所返回邮箱的属性。 此参数不能与 Database 参数一起使用。 有关可筛选属性的详细信息,请参阅-Filter 参数的可筛选属性。 |
||
Identity |
可选 |
Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter |
Identity 参数用于标识邮箱。可以使用下列值之一:
|
||
IgnoreDefaultScope |
可选 |
System.Management.Automation.SwitchParameter |
IgnoreDefaultScope 参数指示命令忽略 Exchange 命令行管理程序的默认收件人作用域设置,并将整个林作为作用域。这使该命令能够访问当前默认作用域中不存在的 Active Directory 对象。使用 IgnoreDefaultScope 参数引入以下限制:
|
||
OrganizationalUnit |
可选 |
Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter |
OrganizationalUnit 参数指定组织单位 (OU),并用于限制结果。如果使用此参数,将只获取所指定的容器中的邮箱。可以使用 OU 或域名。如果使用 OU,则必须指定 OU 的规范名称。 |
||
ReadFromDomainController |
可选 |
System.Management.Automation.SwitchParameter |
ReadFromDomainController 参数指定从用户域中的域控制器读取的用户信息。如果将收件人作用域设置为包括林中的所有收件人,且不使用此参数,则有可能从包含过期信息的全局编录中读取用户信息。如果使用此参数,则可能需要多次读取才能获取该信息。
|
||
RecipientTypeDetails |
可选 |
Microsoft.Exchange.Data.Directory.Recipient.RecipientTypeDetails[] |
RecipientTypeDetails 参数指定返回的收件人的类型。Microsoft Exchange Server 2007 的收件人类型分为收件人类型和子类型。每个收件人类型包含所有子类型的所有常见属性。例如,类型 UserMailbox 代表 Active Directory 中具有关联邮箱的用户帐户。因为存在多种邮箱类型,所以每个邮箱类型都由 RecipientTypeDetails 参数标识。例如,会议室邮箱将 RecipientTypeDetails 设置为 RoomMailbox,而用户邮箱将 RecipientTypeDetails 设置为 UserMailbox。 对于该命令,可用的收件人类型详细信息包括:
|
||
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