Get-Contact (RTM)

  • 项目

 

适用于： Exchange Server 2007

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

使用 Get-Contact cmdlet 可以检索指定的一个或多个联系人的信息。

语法

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

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

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

详细说明

Get-Contact cmdlet 在 Active Directory 目录服务中查询特定联系人或联系人收件人对象的属性。

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

  • Exchange 仅查看管理员角色

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

参数

参数 必需 类型 说明

Anr

可选

System.String

Anr 参数用于搜索与提供的部分字符串匹配的对象。类似于使用通配符的搜索。

Credential

可选

System.Management.Automation.PSCredential

Credential 参数指定用于在 Active Directory 中查询联系人凭据的帐户。

DomainController

可选

Microsoft.Exchange.Data.Fqdn

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

Filter

可选

System.String

Filter 参数指定一组属性，用于限制查询所返回的收件人。

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

Identity

可选

Microsoft.Exchange.Configuration.Tasks.ContactIdParameter

Identity 参数接受下列值之一：

  • GUID

  • 可分辨名称 (DN)

  • 域\帐户

  • 用户主要名称 (UPN)

  • 旧版 Exchange DN

  • 简单邮件传输协议 (SMTP) 地址

  • 别名

OrganizationalUnit

可选

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

OrganizationalUnit 参数仅返回指定组织单位 (OU) 中的对象。

ReadFromDomainController

可选

System.Management.Automation.SwitchParameter

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

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

RecipientTypeDetails

可选

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

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

对于该命令，可用的收件人类型详细信息包括：

  • Contact

  • MailEnabledContact

  • MailEnabledForestContact

ResultSize

可选

Microsoft.Exchange.Data.Unlimited

ResultSize 参数指定要返回的最大结果数。

SortBy

可选

System.String

SortBy 参数指定根据单个属性以升序排序。

输入类型

返回类型

错误

错误 说明

 

 

异常

异常 说明

 

示例

在此示例中，Get-Contact 命令检索联系人 Ted Bremer，并通过管道将该对象传递给 Format-List 命令，以显示有关该联系人的信息。

Get-Contact -Identity TedBremer | Format-List