Set-Contact (RTM)

 

適用版本： 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 技術資源中心.