Get-MailUser (RTM)

 

适用于： Exchange Server 2007

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

使用 Get-MailUser cmdlet 可从 Active Directory 目录服务中检索指定用户的邮件相关的属性。

语法

get-MailUser [-Identity <MailUserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]

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

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

详细说明

要点：
在 Microsoft Exchange Server 2007 中，只能通过 Exchange 命令行管理程序来检索已启用邮件的用户设置。

Get-MailUser cmdlet 检索指定用户的所有邮件相关属性。

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

• Exchange 仅查看管理员角色

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

注意：
并非所有用户属性都可以通过 Get-MailUser cmdlet 来检索。可以使用 Get-User cmdlet 获得其他用户属性。

参数

参数	必需	类型	说明
ANR	可选	System.String	Anr 参数指定一个字符串，用于执行模糊名称解析 (ANR) 搜索。可以指定部分字符串，并搜索其属性与该字符串匹配的对象。搜索的默认属性是： CommonName (CN) DisplayName (displayName) FirstName (givenName) LastName (sn) Alias (mailNickname)
Credential	可选	System.Management.Automation.PSCredential	Credential 参数可指定用于获取 Active Directory 的访问权限的帐户。 如果使用 Credential 参数，则命令将在继续执行之前提示输入帐户的密码。
DomainController	可选	Microsoft.Exchange.Data.Fqdn	若要指定将此配置更改写入 Active Directory 的域控制器的完全限定的域名 (FQDN)，请在命令中包含 DomainController 参数。
Filter	可选	System.String	Filter 参数用于筛选所返回的收件人列表。可以指定要筛选的属性。 有关可筛选属性的详细信息，请参阅 -Filter 参数的可筛选属性。
Identity	可选	Microsoft.Exchange.Configuration.Tasks.MailUserIdParameter	Identity 参数用于标识用户。可以包含用户的 ADO 对象 ID、可分辨名称 (DN)、LegacyExchangeDN、GUID、域\Sam 帐户名、用户主体名称 (UPN)、电子邮件地址或别名。
OrganizationalUnit	可选	Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter	OrganizationalUnit 参数可指定将在其中限制结果的容器。可以指定组织单位 (OU) 或域。应指定规范名称。例如： OU：westcoast.contoso.com/users 域：westcoast.contoso.com
ReadFromDomainController	可选	System.Management.Automation.SwitchParameter	ReadFromDomainController 参数指定从用户域中的域控制器读取的用户信息。如果将收件人作用域设置为包括林中的所有收件人，且不使用此参数，则有可能从包含过期信息的全局编录中读取用户信息。如果使用此参数，则可能需要多次读取才能获取该信息。 注意： 默认情况下，收件人作用域被设置为驻留 Exchange 服务器的域。
ResultSize	可选	Microsoft.Exchange.Data.Unlimited	ResultSize 参数可指定要返回的最大收件人对象数。如果不指定，此参数返回与筛选器匹配的所有结果。
SortBy	可选	System.String	SortBy 参数指定用来对结果排序的属性。每次按一个属性执行排序，并且始终按升序执行。

输入类型

返回类型

错误

错误	说明

异常

异常	说明

示例

第一个示例中，在无参数的情况下使用 Get-MailUser 命令来检索整个 Exchange 组织中已启用邮件用户的完整列表。

第二个示例中，先检索用户 Ted 的邮件设置，然后通过管道将结果传输给 Format-List cmdlet 以进行显示。

Get-MailUser
Get-MailUser -Identity Ted | Format-List