Set-Contact

 

适用于： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

上一次修改主题： 2009-05-12

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

语法

Set-Contact -Identity <ContactIdParameter> [-AllowUMCallsFromNonUsers <None | SearchEnabled>] [-AssistantName <String>] [-City <String>] [-Company <String>] [-Confirm [<SwitchParameter>]] [-CountryOrRegion <CountryInfo>] [-CreateDTMFMap <$true | $false>] [-Department <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-Fax <String>] [-FirstName <String>] [-HomePhone <String>] [-IgnoreDefaultScope <SwitchParameter>] [-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>] [-UseRusServer <String>] [-WebPage <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Set-Contact [-AllowUMCallsFromNonUsers <None | SearchEnabled>] [-AssistantName <String>] [-City <String>] [-Company <String>] [-Confirm [<SwitchParameter>]] [-CountryOrRegion <CountryInfo>] [-CreateDTMFMap <$true | $false>] [-Department <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-Fax <String>] [-FirstName <String>] [-HomePhone <String>] [-IgnoreDefaultScope <SwitchParameter>] [-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>] [-UseRusServer <String>] [-WebPage <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

详细说明

可以使用 Set-Contact cmdlet 修改在 Active Directory 用户和计算机中可见的联系人对象的设置。如果是启用邮件的联系人，请使用 Set-MailContact cmdlet 来修改使用 Set-Contact cmdlet 时不可用的联系人电子邮件设置。

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

• Exchange 收件人管理员角色

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

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

参数

参数	必需	类型	说明
Identity	必需	Microsoft.Exchange.Configuration.Tasks.ContactIdParameter	Identity 参数指定要修改的对象。Identity 参数可以将下列任意值作为联系人对象。 GUID 可分辨名称 (DN) 规范名称 名称 如果指定了 Instance 参数，则不能使用 Identity 参数。
AllowUMCallsFromNonUsers	可选	Microsoft.Exchange.Data.Directory.Recipient.AllowUMCallsFromNonUsersFlags	此参数指定是否将联系人排除在目录搜索外。
AssistantName	可选	System.String	AssistantName 参数定义联系人助理的姓名。
City	可选	System.String	City 参数定义联系人所在的城市。
Company	可选	System.String	Company 参数定义联系人所在的公司。
Confirm	可选	System.Management.Automation.SwitchParameter	Confirm 参数将导致命令暂停处理，并且需要您在处理继续之前确认该命令将执行的操作。不必为 Confirm 参数指定值。
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 参数定义联系人的家庭电话号码。
IgnoreDefaultScope	可选	System.Management.Automation.SwitchParameter	IgnoreDefaultScope 参数指示命令忽略 Exchange 命令行管理程序的默认收件人作用域设置，并使用整个林作为作用域。这样，该命令可以访问当前不在默认作用域中的 Active Directory 对象。使用 IgnoreDefaultScope 参数时将受到下列限制： 不能使用 DomainController 参数。该命令将自动使用相应的全局编录服务器。 仅可以对 Identity 参数使用 DN。不接受其他形式的标识，如别名或 GUID。
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 参数显示对象的备用说明。这组有限的字符由以下字符组成： abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789\"()+,-./:? 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 映射。
UseRusServer	可选	System.String	注意： 此参数仅在 Exchange 2007 SP2 中可用。 UseRusServer 参数指示该命令使用运行地址列表服务的邮箱服务器获取并设置邮箱和 Active Directory 用户属性。 地址列表服务是 Exchange 系统助理服务的一个组件。地址列表服务创建和维护 Active Directory 中 Exchange 特定的属性值。通过使用特定信息（如地址列表成员身份和电子邮件地址），您可以使用地址列表服务来更新域中的收件人对象。
WebPage	可选	System.String	WebPage 参数定义联系人的网页。
WhatIf	可选	System.Management.Automation.SwitchParameter	WhatIf 参数指示命令模拟对对象执行的操作。通过使用 WhatIf 参数，可以查看要发生的更改，而不必应用任何这些更改。不必为 WhatIf 参数指定值。
WindowsEmailAddress	可选	Microsoft.Exchange.Data.SmtpAddress	WindowsEmailAddress 参数指定存储在 Active Directory 中的联系人电子邮件地址。

输入类型

返回类型

错误

错误	说明

异常

异常	说明

示例

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

• 将市/县值更改为“Seattle”。

• 将公司值更改为“Contoso”。

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