Set-CsExUmContact
上次修改主題的時間： 2012-03-25
修改主控 Exchange Unified Messaging (UM) 的現有自動語音應答或訂戶存取連絡人物件。
語法
Set-CsExUmContact -Identity <UserIdParameter> [-AutoAttendant <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-DisplayNumber <String>] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-EnterpriseVoiceEnabled <$true | $false>] [-PassThru <SwitchParameter>] [-SipAddress <String>] [-WhatIf [<SwitchParameter>]]
詳細描述
Microsoft Lync Server 2010 搭配 Exchange UM 一起提供多項語音相關功能，包括自動語音應答和訂戶存取。以主控服務 (非內部實作) 形式提供 Exchange UM 時，必須使用 Windows PowerShell 建立連絡人物件以套用「自動語音應答」和「訂戶存取」功能。這些物件可透過呼叫 New-CsExUmContact 指令程式來建立，而且以後可以使用 Set-CsExUmContact 指令程式修改。
使用這個指令程式通常最簡單的方法是先呼叫 Get-CsExUmContact，以擷取您要修改之連絡人物件的執行個體。只要將 Get-CsExUmContact 命令的輸出傳送到 Set-CsExUmContact 指令程式，並將值指派給您要變更之屬性的參數 (如需詳細資料，請參閱本主題中的＜範例＞區段)。或者，可以呼叫 Set-CsExUmContact 指令程式，將您要修改之連絡人物件的 Identity 傳遞給它。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Set-CsExUmContact Cmdlet：RTCUniversalUserAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsExUmContact"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
UserIdParameter |
您要修改之連絡人物件的唯一識別碼。可以使用下列四種格式的其中一種來指定連絡人識別身分：1) 連絡人的 SIP 位址；2) 連絡人的使用者主體名稱 (UPN)；3) 連絡人的網域名稱和登入名稱，格式為 domain\logon (例如 litwareinc\exum1)；和 4) 連絡人的 Active Directory 顯示名稱 (例如 Team Auto Attendant)。 完整資料類型：Microsoft.Rtc.Management.AD.UserIdParameter |
AutoAttendant |
選用 |
布林值 |
如果連絡人物件是自動語音應答，將參數設定為 True。這個參數預設為 False。 |
Description |
選用 |
字串 |
此連絡人的描述。描述可供系統管理員用來識別連絡人的類型 (自動語音應答或訂戶存取)、位置、供應商，或可識別每一個 Exchange UM 連絡人目的的其他任何資訊。 |
DisplayNumber |
選用 |
字串 |
連絡人的電話號碼。每位連絡人的顯示號碼都必須是唯一的 (任兩位 Exchange UM 連絡人不能擁有相同的顯示號碼)。變更這個值也會變更 LineURI 屬性的值。 此值的開頭可以是加號 (+) 且可以包含任何數目的數字。第一個位數不能為零。 |
Enabled |
選用 |
布林值 |
表示是否已為 Lync Server 2010 啟用連絡人。將這個參數設定為 False 會停用連絡人，而且與這個連絡人相關聯的自動語音應答或訂戶存取將不再作用。 如果您使用 Enabled 參數停用帳戶，將會保留與該帳戶相關聯的資訊 (包括指定的主控語音信箱原則)。如果稍後使用 Enable 參數重新啟用帳戶，將會還原相關聯的帳戶資訊。 |
EnterpriseVoiceEnabled |
選用 |
布林值 |
表示是否已為 Enterprise Voice 啟用連絡人。如果這個值設定為 False，將無法再使用與這個連絡人相關聯的自動語音應答或訂戶存取功能。 |
SipAddress |
選用 |
字串 |
連絡人的 SIP 位址。這必須是尚未以使用者或連絡人形式存在 Active Directory 網域服務 (AD DS) 中的新位址。 變更這個值也會變更儲存在 OtherIpPhone 屬性中的 SIP 位址。 可以使用 SipAddress 做為 Identity 值，讓 Get-CsExUmContact 命令擷取特定的連絡人。呼叫該指令程式時，會使用新的 SipAddress；查詢舊 SIP 位址不會傳回物件。 |
DomainController |
選用 |
Fqdn |
容許您指定網域控制站。若未指定網域控制站，則會使用第一個可用的網域控制站。 |
PassThru |
選用 |
切換參數 |
傳回命令的結果。根據預設，這個指令程式不會產生任何輸出。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.ADConnect.Schema.OCSADExUmContact 物件。接受 Exchange UM 連絡人物件管線傳送的輸入。
傳回類型
此指令程式會修改類型為 Microsoft.Rtc.Management.ADConnect.Schema.OCSADExUmContact 的物件。使用 PassThru 參數時，也會傳回此類型的物件。
範例
-------------------------- 範例 1 --------------------------
Get-CsExUmContact -Identity sip:exumsa4@fabrikam.com | Set-CsExUmContact -AutoAttendant $True
這個範例會將 SIP 位址為 exumsa4@fabrikam.comis 的 Exchange UM 連絡人的 AutoAttendant 屬性設定為 True。我們先呼叫 Get-CsExUmContact 物件以擷取連絡人物件 (我們也可能使用連絡人的 Active Directory 顯示名稱、連絡人的使用者主體名稱或連絡人的登入名稱)。這個命令會擷取具有所提供 Identity 的連絡人。然後將該連絡人傳遞到 Set-CsExUmContact 指令程式，將其 AutoAttendant 參數設定為 True。
-------------------------- 範例 2 --------------------------
Set-CsExUmContact -Identity "CN={1bf6208d-2847-45d0-828f-636f14da858b},OU=ExUmContacts,DC=litwareinc,DC=com" -AutoAttendant $True
這個範例和範例 1 相同，但是我們擷取連絡人時並不是呼叫 Get-CsExUmContact 及將該物件傳送到 Set-CsExUmContact，而是提供 Set-CsExUmContact 我們要修改之連絡人的 Identity。請注意 Identity 的格式：此情況下，我們已經使用連絡人物件的完整辨別名稱，包括自動產生的 GUID (在建立連絡人時產生)。然後將連絡人的 AutoAttendant 參數設定為 True。