共用方式為


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

note附註:
只有在 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 技術資源中心.