Get-UMMailbox (RTM)

  • 项目

 

适用于： Exchange Server 2007

上一次修改主题： 2007-06-11

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

语法

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

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

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

详细说明

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

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

  • Exchange 收件人管理员角色

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

参数

参数 必需 类型 说明

Anr

可选

System.String

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

  • CommonName (CN)

  • DisplayName

  • FirstName

  • LastName

  • Alias

Credential

可选

System.Management.Automation.PSCredential

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

DomainController

可选

Microsoft.Exchange.Data.Fqdn

若要指定将此配置更改写入 Active Directory 目录服务域控制器的完全限定的域名，请在 cmdlet 中包含 DomainController 参数。

Filter

可选

System.String

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

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

Identity

可选

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

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

  • ADObjectID

  • GUID

  • DN

  • 域\帐户

  • UPN

  • LegacyExchangeDN

  • SmtpAddress

  • Alias

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

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