Set-Contact

內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 有些參數和設定可能是某一個環境所專屬。

使用 Set-Contact Cmdlet 來修改連絡人物件設定。 如果連絡人是郵件連絡人,您可以使用 Set-MailContact Cmdlet 來修改其他無法使用 Set-Contact Cmdlet 的 Microsoft Exchange 設定。

如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法

Syntax

Set-Contact
   [-Identity] <ContactIdParameter>
   [-AllowUMCallsFromNonUsers <AllowUMCallsFromNonUsersFlags>]
   [-AssistantName <String>]
   [-City <String>]
   [-Company <String>]
   [-Confirm]
   [-CountryOrRegion <CountryInfo>]
   [-CreateDTMFMap <Boolean>]
   [-Department <String>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-Fax <String>]
   [-FirstName <String>]
   [-GeoCoordinates <GeoCoordinates>]
   [-HomePhone <String>]
   [-IgnoreDefaultScope]
   [-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>]
   [-SeniorityIndex <Int32>]
   [-SimpleDisplayName <String>]
   [-StateOrProvince <String>]
   [-StreetAddress <String>]
   [-TelephoneAssistant <String>]
   [-Title <String>]
   [-UMCallingLineIds <MultiValuedProperty>]
   [-UMDtmfMap <MultiValuedProperty>]
   [-WebPage <String>]
   [-WhatIf]
   [-WindowsEmailAddress <SmtpAddress>]
   [<CommonParameters>]

Description

您必須已獲指派權限,才能執行此指令程式。 雖然本主題已列出這個指令程式的所有參數,不過,如果某些參數並未包含在指派給您的權限中,您可能就無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 Find the permissions required to run any Exchange cmdlet

範例

範例 1

Set-Contact -Identity "contoso.com/Users/Arlene Huff" -City "Seattle" -Company "Contoso"

本範例會對 Active Directory 網域中 Users 容器中名為 Arlene Huff 的現有連絡人進行下列變更 contoso.com:

將 City 參數值變更為 Seattle。

將公司參數值變更為 Contoso。

參數

-AllowUMCallsFromNonUsers

此參數僅適用於內部部署 Exchange。

AllowUMCallsFromNonUsers 參數會指定是否要從整合通訊目錄搜尋中排除連絡人。

Type:AllowUMCallsFromNonUsersFlags
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-AssistantName

AssistantName 參數會指定連絡人助理的名稱。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-City

City 參數會指定連絡人的城市。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Company

Company 參數會指定連絡人的公司。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Confirm

Confirm 參數會指定要顯示或隱藏確認提示。 這個參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續作業。

  • 例如,具破壞性的 Cmdlet (例如 Remove-* Cmdlet) 內建暫停,可強制您在繼續之前確認命令。 對於這些 Cmdlet,您可以使用以下確切語法來略過確認提示:-Confirm:$false
  • 其他大部分的 Cmdlet (例如,New-* 和 Set-* Cmdlet) 沒有內建暫停。 在使用這些 Cmdlet 時,指定不含任何值的 Confirm 參數會引入強迫您認可命令後才繼續作業的暫停。
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-CountryOrRegion

CountryOrRegion 參數會指定連絡人的國家或地區。 有效值是有效的 ISO 3166-1 兩個字母的國家/地區代碼 (例如澳大利亞) 或國家/地區 (的對應易記名稱,這可能與官方 ISO 3166 維護機構簡短名稱) 不同。

兩個字母的國家/地區代碼參考可在國家/ 地區代碼清單取得。

Get-Contact Cmdlet 會在 CountryOrRegion 屬性值中傳回易記名稱,但您可以在篩選作業中使用易記名稱或兩個字母的國家/地區代碼。

Type:CountryInfo
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-CreateDTMFMap

此參數僅適用於內部部署 Exchange。

CreateDTMFMap 參數會指定是否要為收件者建立雙色調多頻率 (DTMF) 對應。 這可讓您在整合通訊 (UM) 環境中使用電話按鍵來識別收件者。 有效值為:

  • $true:系統會為收件者建立 DTMF 對應。 這是預設值。
  • $true:為收件者建立 DTMF 對應。此為預設值。
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Department

Department 參數會指定連絡人的部門。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-DisplayName

DisplayName 參數會指定連絡人的顯示名稱。 顯示名稱會顯示在 Exchange 系統管理中心和通訊清單中。 最大長度為 256 個字元。 如果值包含空格,請使用引號 (") 括住值。

只有在連絡人已啟用郵件功能時,此參數才有意義。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-DomainController

此參數僅適用於內部部署 Exchange。

DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如,dc01.contoso.com。

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Fax

Fax 參數會指定連絡人的傳真號碼。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-FirstName

FirstName 參數可指定使用者的名字。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-GeoCoordinates

GeoCoordinates 參數會在緯度、經度和 (選擇性地) 高度座標中指定連絡人的位置。 此參數的有效值會使用下列其中一種格式:

  • 緯度和經度:例如,「47.644125;-122.122411」
  • 緯度、經度和高度:例如,「47.644125;-122.122411;161.432」

注意:如果期間分隔符號不適用於您,請改用逗號。

Type:GeoCoordinates
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-HomePhone

HomePhone 參數會指定連絡人的住家電話號碼。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Identity

Identity 參數會指定您要修改的連絡人。 您可以使用任何可唯一識別連絡人的值。 例如:

  • 名稱
  • 辨別名稱 (DN)
  • 辨別名稱 (DN)
  • GUID
Type:ContactIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-IgnoreDefaultScope

此參數僅適用於內部部署 Exchange。

IgnoreDefaultScope 參數會指示命令忽略 Exchange PowerShell 會話的預設收件者範圍設定,並使用整個樹系作為範圍。 您不需要使用此參數指定值。

此參數可讓 命令存取預設範圍中目前無法使用的 Active Directory 物件,但也引進下列限制:

  • 您不能使用 DomainController 參數。 此命令會自動使用適當的通用類別目錄伺服器。
  • 您不能使用 DomainController 參數。 此命令會自動使用適當的通用類別目錄伺服器。
Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Initials

Initials 參數會指定使用者的中間名縮寫。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-LastName

LastName 參數可指定使用者的姓氏。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Manager

Manager 參數會指定連絡人的管理員。

Type:UserContactIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-MobilePhone

MobilePhone 參數會指定連絡人的主要行動電話號碼。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Name

Name 參數會指定連絡人的唯一名稱。 最大長度為 64 個字元。 如果值包含空格,請使用引號 (") 括住值。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Notes

Notes 參數會指定有關物件的額外資訊。 如果值包含空格,請使用引號 (") 括住值。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Office

Office 參數會指定使用者的實際辦公室名稱或號碼。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-OtherFax

OtherFax 參數會指定連絡人的替代傳真號碼。

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-OtherHomePhone

OtherHomePhone 參數會指定連絡人的替代住家電話號碼。

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-OtherTelephone

OtherTelephone 參數會指定連絡人的替代辦公室電話號碼。

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Pager

Pager 參數會指定連絡人的呼叫器號碼。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Phone

Phone 參數會指定連絡人的辦公室電話號碼。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-PhoneticDisplayName

PhoneticDisplayName 參數指定使用者姓名的替代拼字,其用於整合通訊 (UM) 環境中的文字轉換語音。 一般而言,當使用者姓名的發音和拼字不符時,您需要使用此參數。 最大長度為 256 個字元。 如果值包含空格,請使用引號 (") 括住值。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-PostalCode

PostalCode 參數會指定連絡人的郵遞區號。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-PostOfficeBox

PostOfficeBox 參數會指定連絡人的郵政信箱號碼。

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-SeniorityIndex

SeniorityIndex 參數會指定此連絡人在階層式通訊錄中顯示的順序。 值為 2 的連絡人會在通訊錄中顯示高於值為 1 的連絡人。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-SimpleDisplayName

如果只允許一組有限的字元,則會使用 SimpleDisplayName 參數來顯示物件的替代描述。 有效字元為:

  • SimpleDisplayName 參數是在只允許有限的一組字元時,用來顯示物件的替代性描述。有效的字元為:
  • a - z
  • A - Z
  • 空格
  • " ' ( ) + , - . / : ?

只有在連絡人已啟用郵件功能時,此參數才有意義。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-StateOrProvince

StateOrProvince 參數會指定連絡人的州或省。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-StreetAddress

StreetAddress 參數會指定連絡人的實體位址。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-TelephoneAssistant

TelephoneAssistant 參數會指定連絡人助理的電話號碼。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Title

Title 參數會指定連絡人的標題。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-UMCallingLineIds

此參數僅適用於內部部署 Exchange。

UMCallingLineIds 參數會指定可對應至已啟用整合通訊 (UM) 之使用者的電話號碼或分機。 您可以為每個使用者指定多個電話號碼,並以逗號分隔。 此參數的值長度必須小於 128 個字元,而且可能包含數位前面的選擇性加號 (+) 。 每個已啟用 UM 的使用者都必須擁有唯一的 UMCallingLineIds 參數值。

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-UMDtmfMap

此參數僅適用於內部部署 Exchange。

UMDtmfMap 參數會指定 DTMF (雙調多頻率) 收件者的對應值。 這可讓您在整合通訊 (UM) 環境中使用電話按鍵來識別收件者。 這些 DTMF 值通常會自動建立和更新,但您可以使用此參數手動進行變更。 此參數使用下列語法:

  • emailAddress:<integers>
  • lastNameFirstName:<integers>
  • firstNameLastName:<integers>

若要輸入覆寫所有現有專案的值,請使用下列語法: emailAddress:<integers>,lastNameFirstName:<integers>,firstNameLastName:<integers>

如果您使用此語法並省略任何 DTMF 對應值,則會從收件者中移除這些值。 例如,如果您只 emailAddress:<integers> 指定 ,則會移除所有現有的 lastNameFirstName 和 firstNameLastName 值。

若要新增或移除值而不影響其他現有的專案,請使用下列語法: @{Add="emailAddress:<integers>","lastNameFirstName:<integers>","firstNameLastName:<integers>"; Remove="emailAddress:<integers>","lastNameFirstName:<integers>","firstNameLastName:<integers>"}

如果您使用此語法,則不需要指定所有 DTMF 對應值,而且可以指定多個 DTMF 對應值。 例如,您可以使用 @{Add="emailAddress:<integers1>","emailAddress:<integers2>} 來新增 emailAddress 的兩個新值,而不會影響現有的 lastNameFirstName 和 firstNameLastName 值。

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-WebPage

WebPage 參數會指定連絡人的網頁。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-WhatIf

WhatIf 參數會模擬命令的動作。 使用此參數時,您不需要實際套用變更即可檢視可能會發生的變更。 您不需要使用此參數指定值。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-WindowsEmailAddress

WindowsEmailAddress 參數會指定此收件者的 Windows 電子郵件地址。 這是存在於所有環境中的常見 Active Directory 屬性,包括沒有 Exchange 的環境。 在收件者上使用 WindowsEmailAddress 參數有下列其中一個結果:

  • 在收件者受限於電子郵件地址原則 (EmailAddressPolicyEnabled 屬性設定為收件者) 的 True 值時,WindowsEmailAddress 參數不會影響 WindowsEmailAddress 屬性或主要電子郵件地址值。
  • 在收件者不受電子郵件地址原則約束的環境中 (EmailAddressPolicyEnabled 屬性會設定為收件者) 的 False 值,WindowsEmailAddress 參數會將 WindowsEmailAddress 屬性和主要電子郵件地址更新為相同的值。

WindowsEmailAddress 屬性會顯示在電子郵件屬性中Active Directory 消費者和電腦收件者。 屬性一般名稱是 E-mail-Addresses,而 Ldap-Display-Name 是 mail。 如果您在 Active Directory 中修改此屬性,收件者的主要電子郵件地址不會更新為相同的值。

Type:SmtpAddress
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

輸入

Input types

若要查看此指令程式可接受的輸入類型,請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的,表示指令程式不接受輸入資料。

輸出

Output types

若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型),請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的,表示指令程式不會傳回資料。