通过

Get-MailContact (RTM)

  • 项目

 

适用于： Exchange Server 2007

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

使用 Get-MailContact cmdlet 可以从 Active Directory 中检索所有指定的联系人的属性。

语法

Get-MailContact [-Identity <MailContactIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

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

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

详细说明

此 cmdlet 检索指定联系人的所有属性。没有必需参数。如果在没有参数的情况下运行 cmdlet，将返回 Exchange 组织的完全联系人列表。

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

  • Exchange 仅查看管理员角色

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

参数

参数 必需 类型 说明

ANR

可选

System.String

使用不明确名称解析 (ANR) 解析指定的参数。搜索的默认属性是：

  • CommonName (CN)

  • DisplayName (displayName)

  • FirstName (givenName)

  • LastName (sn)

  • Alias (mailNickname)

  • LegacyExchangeDN (legacyExchangeDN)

  • Name (name) （而不是 CommonName/CN）

  • EmailAddresses (proxyAddresses)

  • SamAccountName (samAccountName)

  • Office (physicalDeliveryOfficeName)

Credential

可选

System.Management.Automation.PSCredential

此参数指定用于访问 Active Directory 的帐户。

如果使用 Credential 参数，则命令将在继续执行之前提示输入帐户的密码。

DomainController

可选

Microsoft.Exchange.Data.Fqdn

若要指定从 Active Directory 检索数据的域控制器完全限定的域名，请在命令中包含 DomainController 参数。

Filter

可选

System.String

此参数用于筛选返回的收件人列表。可以指定要筛选的属性。

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

Identity

可选

Microsoft.Exchange.Configuration.Tasks.MailContactIdParameter

此参数对联系人进行识别。可以包括联系人的 ADObjectID、可分辨名称、LegacyExchangeDN、GUID、域\Sam 帐户名、用户主要名称 (UPN)、电子邮件地址或别名。

OrganizationalUnit

可选

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

此参数指定限制结果的容器。可以指定组织单元 (OU) 或域。应该也指定规范名称。例如：

  • OU：westcoast.contoso.com/users

  • 域：westcoast.contoso.com

ReadFromDomainController

可选

System.Management.Automation.SwitchParameter

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

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

RecipientTypeDetails

可选

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

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

对于此 cmdlet，可用的收件人类型详细信息为：

  • MailEnabledContact

  • MailEnabledForestContact

ResultSize

可选

Microsoft.Exchange.Data.Unlimited

此参数指定要返回的收件人对象的总数。如果不指定，此参数返回与筛选器匹配的所有结果。

SortBy

可选

System.String

此参数指定用来对结果排序的属性。每次按一个属性执行排序，并且始终按升序执行。

输入类型

返回类型

错误

错误 说明

异常

异常 说明

示例

在本示例中，Get-MailContact 命令用于检索名为 Ted 的已启用邮件的联系人。

Get-MailContact -Identity Ted | Format-List