Set-CsSipDomain
上次修改主題的時間： 2012-03-27
可讓您修改組織中 SIP 網域的屬性值。SIP 網域是有權傳送及接收 SIP 流量的網域，在指派 SIP 位址給使用者時會用到。
語法
Set-CsSipDomain [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-IsDefault <$true | $false>] [-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 網域。Set-CsSipDomain 指令程式提供一種方式，讓您能夠變更預設的 SIP 網域。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Set-CsSipDomain Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsSipDomain"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
字串 |
已設定為預設網域之 SIP 網域的完整網域名稱 (FQDN)。例如：-Identity fabrikam.com。 |
IsDefault |
選用 |
布林值 |
表示該網域是否是預設 SIP 網域，也就是每次未明確指定網域名稱時，Lync Server 2010 所使用的網域。如果設為 True，則新網域會成為新的預設網域。您無法將此值設定為 False，因為這樣會讓您沒有預設的 SIP 網域。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
無。Set-CsSipDomain 不會接受管線傳送的資料。
傳回類型
Set-CsSipDomain 不會傳回任何物件或值。而是使用指令程式修改 Microsoft.Rtc.Management.Xds.SipDomain 物件的現有執行個體。
範例
-------------------------- 範例 1 ------------------------
Set-CsSipDomain -Identity fabrikam.com -IsDefault $True
顯例 1 所示的命令會使 SIP 網域 fabrikam.com 成為預設 SIP 網域；這可以透過使用 IsDefault 參數和參數值 $True 完成。執行此命令時，Fabrikam.com 會成為預設網域，而先前當做預設值的網域將會「降級」。那是因為您只能有一個預設網域。