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 参数可以将下列任意值作为联系人对象。
如果指定了 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"