New-CsExUmContact
上次修改主題的時間： 2012-03-25
為託管的 Exchange Unified Messaging (UM) 建立新的自動語音應答或訂戶存取連絡人。
語法
New-CsExUmContact -DisplayNumber <String> -OU <OUIdParameter> -RegistrarPool <Fqdn> -SipAddress <String> [-AutoAttendant <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
Microsoft Lync Server 2010 搭配 Exchange UM 一起提供多項語音相關功能，包括自動語音應答和訂戶存取。以託管服務 (非內部部署) 形式提供 Exchange UM 時，必須以此指令程式建立連絡人物件，以套用自動語音應答和訂戶存取功能。您可以呼叫 New-CsExUmContact 指令程式來建立這些物件。
必須套用設定連絡人路由的託管語音信箱原則，使用此指令程式所建立的連絡人物件才可在系統內使用。您可以呼叫 Get-CsHostedVoicemailPolicy 指令程式來擷取託管的語音信箱原則。從擷取的原則中，您可以判斷是否存在適當的通用或網站原則，或是否存在需要授與此連絡人的個別使用者原則。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 New-CsExUmContact Cmdlet：RTCUniversalUserAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsExUmContact"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
SipAddress |
必要 |
字串 |
連絡人的 SIP 位址。這必須是尚未以使用者或連絡人形式存在 Active Directory 網域服務 (AD DS) 中的新位址。此值的開頭必須是 sip: 字串，後面再接著 SIP 位址。 |
RegistrarPool |
必要 |
Fqdn |
正在執行登錄器服務之集區的完整網域名稱 (FQDN)。 請注意，Lync Server 2010 中的 Exchange UM 連絡人不能移至屬於 Microsoft Office Communications Server 2007 或 Microsoft Office Communications Server 2007 R2 部署的集區。 完整資料類型：Microsoft.Rtc.Management.Deploy.Fqdn |
DisplayNumber |
必要 |
字串 |
連絡人的電話號碼。每一個連絡人的顯示號碼必須是唯一的 (例如，兩個 Exchange UM 連絡人不能有相同的顯示號碼)。 此值的開頭可以是加號 (+) 且可以包含任何數目的數字。第一個位數不能為零。 |
OU |
必要 |
OUIdParameter |
此連絡人在 Active Directory 中所在的組織單位 (OU)。 完整資料類型：Microsoft.Rtc.Management.AD.OUIdParameter |
AutoAttendant |
選用 |
布林值 |
指定此連絡人物件是否為自動語音應答 (自動語音應答提供一組語音提示，可讓來電者瀏覽電話系統並連絡上預期的通話方)。 預設值：False |
Description |
選用 |
字串 |
此連絡人的描述。描述可供系統管理員用來識別連絡人的類型 (自動語音應答或訂戶存取)、位置、供應商，或可識別每一個 Exchange UM 連絡人目的之其他任何資訊。 |
PassThru |
選用 |
切換參數 |
傳回此命令的結果。執行此指令程式會顯示新建立的物件；加上此參數只會重複該輸出，導致此參數變得多餘。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
無。
傳回類型
建立 Microsoft.Rtc.Management.ADConnect.Schema.OCSADExUmContact 類型的物件。
範例
-------------------------- 範例 1 --------------------------
New-CsExUmContact -SipAddress sip:exumsa1@fabrikam.com -RegistrarPool RedmondPool.litwareinc.com -OU "OU=ExUmContacts,DC=litwareinc,DC=com" -DisplayNumber 2065554567
此範例會呼叫 New-CsExUmContact 指令程式，以建立新的 Exchange UM Active Directory 連絡人物件。若要建立新連絡人，您必須提供自動語音應答或訂戶存取的 SIP 位址 (此範例中為 sip:exumsa1@fabrikam.com)。此外，您必須提供正在執行 Lync Server 2010 登錄器服務之集區的名稱 (RedmondPool.litwareinc.com)、將儲存此資訊的 OU (OU=ExUmContacts,DC=litwareinc,DC=com)，以及自動語音應答或訂閱者存取 (2065554567) 的電話號碼。因為我們未明確設定 AutoAttendant 參數，所以會套用預設值 False，且會假設此連絡人物件為訂戶存取連絡人。
-------------------------- 範例 2 --------------------------
New-CsExUmContact -SipAddress sip:exumaa1@fabrikam.com -RegistrarPool RedmondPool.litwareinc.com -OU "OU=ExUmContacts,DC=litwareinc,DC=com" -DisplayNumber 2065559876 -AutoAttendant $True
此範例類似於範例 1，因為它會呼叫 New-CsExUmContact 指令程式以建立新的 Exchange UM 連絡人。我們再次建立新的自動語音應答或訂閱者存取連絡人，這一次使用 SIP 位址 sip:exumaa1@fabrikam.com。接著會提供正在執行 Lync Server 2010 登錄器服務之集區的名稱 (RedmondPool.litwareinc.com)、將儲存此資訊的 OU (OU=ExUmContacts,DC=litwareinc,DC=com)，以及自動語音應答或訂閱者存取 (2065554567) 的電話號碼。此範例中的差別在於將選擇性參數 AutoAttendant 設為 True ($True)，以表示此物件實際上是自動語音應答連絡人。