Get-UMMailbox

  • 项目

 

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

上一次修改主题： 2007-07-20

Get-UMMailbox cmdlet 显示已启用 UM 的收件人的统一消息 (UM) 属性。

语法

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

Get-UMMailbox [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]

Get-UMMailbox [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]

详细说明

Get-UMMailbox cmdlet 可以检索单个 UM 邮箱的 UM 属性。还可以返回启用了 UM 邮箱的列表。

若要运行 Get-UMMailbox cmdlet，必须为您使用的帐户委派 Exchange 收件人管理员角色。

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

参数

参数 必需 类型 说明

Anr

可选

System.String

此参数指定根据其执行不明确名称解析 (ANR) 搜索的字符串。可以指定部分字符串，并搜索其属性与该字符串相匹配的对象。所搜索的默认属性如下：

  • CommonName (CN)

  • DisplayName

  • FirstName

  • LastName

  • Alias

Credential

可选

System.Management.Automation.PSCredential

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

DomainController

可选

Microsoft.Exchange.Data.Fqdn

此参数指定用于将此配置更改写入 Active Directory 的域控制器的完全限定的域名。

Filter

可选

System.String

此参数用于筛选 cmdlet 返回的结果。

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

Identity

可选

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

此参数指定要启用统一消息的用户。此参数包含下列变量：

  • ADObjectID

  • GUID

  • DN

  • Domain\Account

  • UPN

  • LegacyExchangeDN

  • SmtpAddress

  • 别名

如果未使用 Instance 参数，则此参数是必需的。

IgnoreDefaultScope

可选

System.Management.Automation.SwitchParameter

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

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

  • Identity 参数只能使用 DN。不接受其他形式的标识（例如别名和 GUID）。

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

  • 不能使用 Credential 参数。

OrganizationalUnit

可选

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

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

ReadFromDomainController

可选

System.Management.Automation.SwitchParameter

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

ResultSize

可选

Microsoft.Exchange.Data.Unlimited

此参数允许您指定要返回的最大结果数。如果未指定最大数目，则 cmdlet 将返回所有结果。

SortBy

可选

System.String

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

  • Alias

  • DisplayName

  • Name

结果将按升序进行排序。

输入类型

类型 说明

 

 

返回类型

类型 说明

 

 

错误

错误 说明

 

 

示例

第一个代码示例在格式化列表中显示 Active Directory 林中所有已启用 UM 邮箱的列表。

第二个代码示例显示 yanli@contoso.com 的 UM 邮箱属性。

Get-UMMailbox | format-list

Get-UMMailbox -Identity yanli@contoso.com