Set-Contact

 

適用版本： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

上次修改主題的時間： 2009-05-12

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

語法

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

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

• 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	此參數指定撥號對應表的目錄物件識別碼。
UMDtmfMap	選用	Microsoft.Exchange.Data.MultiValuedProperty	此參數指定是否要為已啟用 UM 的連絡人建立使用者定義之 DTMF 對應。
UseRusServer	選用	System.String	附註： 只有在 Exchange 2007 SP2 中才能使用此參數。 UseRusServer 參數會指示此命令，使用通訊清單服務執行所在的指定信箱伺服器來取得並設定信箱及 Active Directory 使用者屬性。 通訊清單服務是 Exchange System Attendant 服務的一個元件。通訊清單服務會在 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 網域的 Users 容器中：

• 將 City 值變更為 Seattle。
• 將 Company 值變更為 Contoso。

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

若要確保您目前閱讀的是最新資訊，並尋找其他的 Exchange Server 2007 說明文件，請造訪 Exchange Server 技術資源中心.