Remove-CsExUmContact
上次修改主題的時間： 2012-03-25
移除主控 Exchange Unified Messaging (UM) 的自動語音應答或訂戶存取連絡人物件。
語法
Remove-CsExUmContact -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
詳細描述
Microsoft Lync Server 2010 搭配 Exchange UM 一起提供多項語音相關功能，包括自動語音應答和訂戶存取。以主控服務 (非內部部署) 形式提供 Exchange UM 時，必須使用 Windows PowerShell 建立連絡人物件以套用「自動語音應答」和「訂戶存取」功能。建立的任何物件可以使用 Remove-CsExUmContact 指令程式移除。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Remove-CsExUmContact Cmdlet：RTCUniversalUserAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsExUmContact"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
UserIdParameter |
您要移除之連絡人物件的唯一識別碼。可以使用下列四種格式的其中一種來指定連絡人識別身分：1) 連絡人的 SIP 位址；2) 連絡人的使用者主體名稱 (UPN)；3) 連絡人的網域名稱和登入名稱，格式為 domain\logon (例如 litwareinc\exum1)；和 4) 連絡人的 Active Directory 顯示名稱 (例如 Team Auto Attendant)。 完整資料類型：Microsoft.Rtc.Management.AD.UserIdParameter |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.ADConnect.Schema.OCSADExUmContact 物件。接受 Exchange UM 連絡人物件管線傳送的輸入。
傳回類型
這個指令程式不會傳回物件。它會移除 Microsoft.Rtc.Management.ADConnect.Schema.OCSADExUmContact 類型的物件。
範例
-------------------------- 範例 1 --------------------------
Remove-CsExUmContact -Identity sip:exumsa1@fabrikam.com
這個範例會移除 SIP 位址為 exumsa1@fabrikam.com 的 Exchange UM 連絡人。
-------------------------- 範例 2 --------------------------
Get-CsExUmContact -Filter {LineURI -like "tel:425*"} | Remove-CsExUmContact
這個範例會移除 LineURI 值的開頭為 425 的所有 Exchange UM 連絡人。此命令的第一部分會呼叫 Get-CsExUmContact 指令程式並搭配 Filter 參數，並使用下列運算式做為篩選器：LineURI -like "tel:425*"。該篩選器指定我們想要擷取 LineURI 符合萬用字元字串 425\* 的 Exchange UM 連絡人物件。換言之，以字串 425 開頭，且以任何字元集結尾的所有 Line URI。取得該物件集合後，將集合傳送到 Remove-CsExUmContact 指令程式，它會移除集合中所有的項目。