Set-Contact (RTM)

 

适用于: Exchange Server 2007

上一次修改主题: 2007-06-17

使用 Set-Contact cmdlet 可以修改现有联系人的设置。

语法

Set-Contact -Identity <ContactIdParameter> [-AssistantName <String>] [-City <String>] [-Company <String>] [-CountryOrRegion <CountryInfo>] [-CreateDTMFMap <$true | $false>] [-Department <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-Fax <String>] [-FirstName <String>] [-HomePhone <String>] [-Initials <String>] [-LastName <String>] [-Manager <UserContactIdParameter>] [-MobilePhone <String>] [-Name <String>] [-Notes <String>] [-Office <String>] [-OtherFax <MultiValuedProperty>] [-OtherHomePhone <MultiValuedProperty>] [-OtherTelephone <MultiValuedProperty>] [-Pager <String>] [-Phone <String>] [-PhoneticDisplayName <String>] [-PostalCode <String>] [-PostOfficeBox <MultiValuedProperty>] [-SimpleDisplayName <String>] [-StateOrProvince <String>] [-StreetAddress <String>] [-TelephoneAssistant <String>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-WebPage <String>]

Set-Contact [-AssistantName <String>] [-City <String>] [-Company <String>] [-CountryOrRegion <CountryInfo>] [-CreateDTMFMap <$true | $false>] [-Department <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-Fax <String>] [-FirstName <String>] [-HomePhone <String>] [-Initials <String>] [-Instance <Contact>] [-LastName <String>] [-Manager <UserContactIdParameter>] [-MobilePhone <String>] [-Name <String>] [-Notes <String>] [-Office <String>] [-OtherFax <MultiValuedProperty>] [-OtherHomePhone <MultiValuedProperty>] [-OtherTelephone <MultiValuedProperty>] [-Pager <String>] [-Phone <String>] [-PhoneticDisplayName <String>] [-PostalCode <String>] [-PostOfficeBox <MultiValuedProperty>] [-SimpleDisplayName <String>] [-StateOrProvince <String>] [-StreetAddress <String>] [-TelephoneAssistant <String>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-WebPage <String>]

详细说明

可以使用 Set-Contact cmdlet 修改在 Active Directory 用户和计算机中可见的联系人对象的设置。如果是启用邮件的联系人,请使用 Set-MailContact cmdlet 来修改使用 Set-Contact cmdlet 时不可用的联系人电子邮件设置。有关 Set-MailContact cmdlet 的详细信息,请参阅 Set-MailContact (RTM)

若要运行 Set-Contact cmdlet,必须为您使用的帐户委派下列角色:

  • Exchange 收件人管理员角色

  • 帐户操作员角色(对于适用的 Active Directory 容器)

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

参数

参数 必需 类型 说明

Identity

必需

Microsoft.Exchange.Configuration.Tasks.ContactIdParameter

Identity 参数指定要修改的对象。Identity 参数可以将下列任意值作为联系人对象。

  • GUID

  • 可分辨名称 (DN)

  • 规范名称

  • 名称

如果指定了 Instance 参数,则不能使用 Identity 参数。

AssistantName

可选

System.String

AssistantName 参数定义联系人助理的姓名。

City

可选

System.String

City 参数定义联系人所在的城市。

Company

可选

System.String

Company 参数定义联系人所在的公司。

CountryOrRegion

可选

Microsoft.Exchange.Data.Directory.CountryInfo

CountryOrRegion 参数定义联系人所在的国家或地区。

CreateDTMFMap

可选

System.Boolean

此参数指定为联系人创建的双音多频 (DTMF) 映射。

Department

可选

System.String

Department 参数定义联系人所在的部门。

DisplayName

可选

System.String

可以使用 DisplayName 参数在 Exchange 管理控制台和 Exchange 全局地址列表 (GAL) 中指定联系人姓名。DisplayName 只对已启用邮件的对象有意义。

DomainController

可选

Microsoft.Exchange.Data.Fqdn

若要指定将此配置更改写入 Active Directory 目录服务域控制器的完全限定的域名 (FQDN),需包括 DomainController 参数。

Fax

可选

System.String

Fax 参数定义联系人的传真号码。

FirstName

可选

System.String

FirstName 参数定义联系人的名。

HomePhone

可选

System.String

HomePhone 参数定义联系人的家庭电话号码。

Initials

可选

System.String

Initials 参数定义联系人的姓名缩写。

Instance

可选

Microsoft.Exchange.Data.Directory.Management.Contact

使用 Instance 参数可以将整个对象传递给此命令以进行处理。该参数主要用于必须将整个对象传递给命令的脚本。

如果指定了 Identity 参数,则不可使用 Instance 参数。

LastName

可选

System.String

LastName 参数定义联系人的姓。

Manager

可选

Microsoft.Exchange.Configuration.Tasks.UserContactIdParameter

Manager 参数定义联系人的经理。

MobilePhone

可选

System.String

MobilePhone 参数定义联系人的主要移动电话号码。

Name

可选

System.String

Name 参数指定在 Active Directory 用户和计算机中的联系人姓名,并且如果该组启用了邮件,那么也指定 Exchange 管理控制台中“组名称”字段中的联系人姓名。

Name 值不能超过 64 个字符。

Notes

可选

System.String

Notes 参数定义有关联系人的其他信息。

Office

可选

System.String

Office 参数定义联系人的实际办公室的名称或号码。

OtherFax

可选

Microsoft.Exchange.Data.MultiValuedProperty

OtherFax 参数定义联系人的另一传真号码。

OtherHomePhone

可选

Microsoft.Exchange.Data.MultiValuedProperty

OtherHomePhone 参数定义联系人的另一家庭电话号码。

OtherTelephone

可选

Microsoft.Exchange.Data.MultiValuedProperty

OtherTelephone 参数定义联系人的另一办公室电话号码。

Pager

可选

System.String

Pager 参数定义联系人的寻呼号码。

Phone

可选

System.String

Phone 参数定义联系人的办公室电话号码。

PhoneticDisplayName

可选

System.String

PhoneticDisplayName 参数指定 DisplayName 参数的拼音发音。

此参数值的最大长度为 255 个字符。有关 PhoneticDisplayName 参数和语音识别的详细信息,请参阅了解自动语音识别目录查找

PostalCode

可选

System.String

PostalCode 参数定义联系人的邮政编码。

PostOfficeBox

可选

Microsoft.Exchange.Data.MultiValuedProperty

PostOfficeBox 参数定义联系人的邮箱号码。

SimpleDisplayName

可选

System.String

如果只允许使用有限的一组字符,则使用 SimpleDisplayName 参数显示对象的备用说明。这组有限的字符包括从 26 到 126 的 ASCII 字符(包含 26 和 126)。SimpleDisplayName 只对已启用邮件的对象有意义。

StateOrProvince

可选

System.String

StateOrProvince 参数定义联系人的省/市/自治区。

StreetAddress

可选

System.String

StreetAddress 参数定义联系人的实际地址。

TelephoneAssistant

可选

System.String

TelephoneAssistant 参数定义联系人助理的电话号码。

Title

可选

System.String

Title 参数定义联系人的职务。

UMDialPlan

可选

Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter

此参数指定拨号计划的目录对象 ID。

UMDtmfMap

可选

Microsoft.Exchange.Data.MultiValuedProperty

此参数指定是否需要为启用 UM 的联系人创建用户定义的 DTMF 映射。

WebPage

可选

System.String

WebPage 参数定义联系人的网页。

输入类型

返回类型

错误

错误 说明

 

 

异常

异常 说明

 

 

示例

下面的代码示例显示如何使用 Set-Contact 命令更改现有联系人,此联系人的姓名为“Ted Bremer”,位于名为 contoso.com 的 Active Directory 域的用户容器中:

  • 将 City 值更改为 Seattle。

  • 将 Company 值更改为 Contoso。

Set-Contact -Identity "contoso.com/Users/Ted Bremer" -City "Seattle" -Company "Contoso"