Get-CsSipDomain
上次修改主題的時間： 2012-03-23
傳回已設定為要用於您組織的 SIP 網域的相關資訊。SIP 網域是有權傳送及接收 SIP 流量的網域，在指派 SIP 位址給使用者時會用到。
語法
Get-CsSipDomain [-Identity <XdsGlobalRelativeIdentity>]
Get-CsSipDomain [-Filter <String>]
詳細描述
為了設定 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 指令程式的作用之一。
Get-CsSipDomain 指令程式提供一種方法，可讓您傳回已授權在組織中使用之 SIP 網域的相關資訊。Get-CsSipDomain 也會識別您組織的預設 SIP 網域；這是未指定 SIP 網域時，Microsoft Lync Server 2010 預設會使用的網域。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsSipDomain Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsSipDomain"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
字串 |
要傳回之 SIP 網域的完整網域名稱 (FQDN) (例如 fabrikam.com)。如果既未指定此參數也未指定 Filter 參數，則會傳回所有已授權在您組織中使用的 SIP 網域。 |
Filter |
選用 |
字串 |
可讓您在指定要傳回之 SIP 網域的 Identity 時使用萬用字元。例如，篩選值 "*.org" 會傳回其 Identity 以字串值 ".org" 結尾之所有授權 SIP 網域的集合。 |
輸入類型
無。Get-CsSipDomain 不接受管線傳送的資料。
傳回類型
Get-CsSipDomain 會傳回 Microsoft.Rtc.Management.Xds.SipDomain 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Get-CsSipDomain
在範例 1 中，會呼叫沒有任何參數的 Get-CsSipDomain；這會傳回已設定要用於您組織的所有 SIP 網域相關資訊。
-------------------------- 範例 2 ------------------------
Get-CsSipDomain -Identity fabrikam.com
範例 2 所示的命令會傳回其 Identity 為 fabrikam.com 之任何 SIP 網域的資訊。由於 SIP 網域 Identity 必須是唯一的，因此這個命令永遠不會傳回多於一個項目。
-------------------------- 範例 3 ------------------------
Get-CsSipDomain -Filter "f*"
上述命令會使用 Get-CsSipDomain 和 Filter 參數，來傳回其 Identity 以字母 "f" 開頭之所有 SIP 網域的相關資訊。例如：fabrikam.com、fabrikam.org、fabrikam-users.com 等等。
-------------------------- 範例 4 ------------------------
Get-CsSipDomain | Where-Object {$_.IsDefault -eq $True}
範例 4 所示的命令會傳回預設 SIP 網域的相關資訊。為達成此目的，會先呼叫沒有任何參數的 Get-CsSipDomain，以便傳回已設定要用於您組織的所有 SIP 網域集合。然後，將此集合傳送至 Where-Object 指令程式，這個指令程式只會選取一個其 IsDefault 內容等於 True 的網域。