Set-Contact (RTM)

Exchange 2007
 

適用版本: Exchange Server 2007

上次修改主題的時間: 2007-06-17

使用 Set-Contact 指令程式可以修改現有連絡人的設定。


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 指令程式來修改可以在 Active Directory 使用者和電腦中看到之連絡人物件的設定。如果連絡人擁有郵件功能,請使用 Set-MailContact 指令程式來修改無法使用 Set-Contact 指令程式來使用的連絡人電子郵件設定。如需 Set-MailContact 指令程式的相關資訊,請參閱 Set-MailContact (RTM)

若要執行 Get-Contact 指令程式,必須對您使用的帳戶委派下列項目:

  • 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 參數是在只允許有限的一組字元時,用來顯示物件的替代性描述。這組有限的字元是由 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

此參數指定撥號對應表的目錄物件識別碼。

UMDtmfMap

選用

Microsoft.Exchange.Data.MultiValuedProperty

此參數指定是否要為已啟用 UM 的連絡人建立使用者定義之 DTMF 對應。

WebPage

選用

System.String

WebPage 參數定義連絡人的網頁。

 

錯誤 描述

 

 

 

例外狀況 描述

 

 

下列程式碼範例顯示如何使用 Set-Contact 命令對名為 Ted Bremer 的現有連絡人進行下列變更,而此連絡人位在名為 contoso.com 之 Active Directory 網域的 Users 容器中:

  • 將 City 值變更為 Seattle。
  • 將 Company 值變更為 Contoso。
Set-Contact -Identity "contoso.com/Users/Ted Bremer" -City "Seattle" -Company "Contoso"
若要確保您目前閱讀的是最新資訊,並尋找其他的 Exchange Server 2007 說明文件,請造訪 Exchange Server 技術資源中心.
顯示: