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