Remove-CsSipDomain
上次修改主題的時間： 2012-03-27
移除先前設定為在組織內使用的 SIP 網域。SIP 網域是有權傳送及接收 SIP 流量的網域，在指派 SIP 位址給使用者時會用到。
語法
Remove-CsSipDomain -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
為了設定 SIP 位址給您的使用者 (進而讓他們能夠使用 Microsoft Lync 2010 之類的 SIP 相關軟體)，您需要兩項資訊：使用者 ID (例如 Ken.Myer) 和 SIP 網域 (例如 litwareinc.com)。用來建構 SIP 位址的 SIP 網域必須是您 Active Directory 樹系內有權傳送及接收流量的網域。例如，假設您有名為 litwareinc.com、fabrikam.com 和 contoso.com 的網域，但是只有 litwareinc.com 已識別為 SIP 網域。在此情況下，您無法使用 sip:Ken.Myer@fabrikam.com 或 sip:Ken.Myer@contoso.com 這類的 SIP 位址，除非將 fabrikam.com 和 contoso.com 設定作為有效的 SIP 網域。這就是執行 New-CsSipDomain 指令程式的作用之一。
對於「已經過授權」的 SIP 網域，您可以使用 Remove-CsSipDomain 指令程式來取消授權。此指令程式可將核准 SIP 網域清單中的指定網域移除。請注意，儘管如此，您仍然無法移除預設網域。如果您需要移除預設網域，必須先將其他 SIP 網域設定為預設網域。如果您只有一個 SIP 網域，系統便會自動將該網域設定為預設網域，而您也無法移除這個網域。
此外，您無法移除任何擁有一或多個已指派給它之 SIP 位址的 SIP 網域。例如，如果 Ken Myer 的 SIP 位址為 "sip:kenmyer@contoso.com"，則您無法將 Contoso.com 當成 SIP 網域來移除。若要移除目前正在使用的 SIP 網域，必須先將新的 SIP 位址指派給 SIP 位址中含有該網域的所有使用者。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Remove-CsSipDomain Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsSipDomain"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
字串 |
要移除之 SIP 網域的完整網域名稱 (FQDN)：例如：-Identity fabrikam.com。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.Xds.SipDomain 物件。Remove-CsSipDomain 接受 SIP 網域物件管線傳送的執行個體。
傳回類型
無。而 Remove-CsSipDomain 會刪除 Microsoft.Rtc.Management.Xds.SipDomain 物件的現有執行個體。
範例
-------------------------- 範例 1 ------------------------
Remove-CsSipDomain -Identity fabrikam.com
上述命令可自支援的網域名稱清單中移除 Identity 為 fabrikam.com 的 SIP 網域。請注意，如果 fabrikam.com 是組織中目前正在使用的唯一一個 SIP 網域，此命令將會失敗。失敗原因在於您的拓撲至少必須包含一個 SIP 網域。
-------------------------- 範例 2 ------------------------
Get-CsSipDomain | Where-Object {$_.IsDefault -ne $True} | Remove-CsSipDomain
範例 2 所示的命令會刪除組織中除預設網域之外的所有 SIP 網域。為達成此目的，此命令需要先呼叫 Get-CsSipDomain，以傳回所有 SIP 網域的集合。接著，這個集合會傳送到 Where-Object 指令程式，這樣只會挑出 IsDefault 屬性不等於 True 的網域。整體效果是：篩選掉預設網域，並將剩餘的網域傳送到 Remove-CsSipDomain 並刪除。