Get-CsHostingProvider
上次修改主題的時間： 2012-03-23
傳回已設定為供組織使用的代管供應商相關資訊。代管供應商是第三方組織，可提供立即訊息、目前狀態，以及與您想要同盟之網域相關的服務。代管供應商 (例如 Microsoft Lync Online 2010) 不同於公用提供者 (例如 Yahoo!、MSN 和 AOL)，因為其服務並非提供給一般大眾。
語法
Get-CsHostingProvider [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsHostingProvider [-Filter <String>] [-LocalStore <SwitchParameter>]
詳細描述
同盟是兩個組織用來建立信任關係的方法，以促進兩個群組之間的溝通。建立同盟後，兩個組織的使用者便可互相傳送立即訊息、訂閱目前狀態通知，並使用如 Lync 2010 等 SIP 應用程式互相通訊。Microsoft Lync Server 2010 允許三種同盟：1) 您組織與其他組織之間的直接同盟；2) 您組織與公共供應商之間的同盟；3) 您組織與第三方代管供應商之間的同盟。
代管供應商是為其他組織提供 SIP 通訊服務的組織；例如 Fabrikam, Inc. 可能為 Contoso、Northwind Traders、Wingtip Toys 的使用者提供主機服務。當您與代管供應商建立同盟關係時，便能夠有效率地與該供應商所託管的任何組織建立同盟關係。例如，如果您與 Fabrikam Hosting 同盟，您的使用者便能夠與 Contoso、Northwind Traders 及 Wingtip Toys 的使用者交換立即訊息和目前狀態的資訊。
代管供應商也用於分割網域案例。在分隔網域的案例中，您的部分 Lync Server 2010 使用者會擁有在內部主控的帳戶 (也就是在 Lync Server 的本機實作上進行主控)。其他使用者的帳戶由第三方代管供應商在外部部署維護。與代管供應商同盟可讓內部部署使用者與外部部署使用者互相通訊。
Get-CsHostingProvider 指令程式會為您提供一個方式，來傳回已設定為供組織使用的所有代管供應商相關資訊。
請注意，如果您的 Edge Server 設定為使用預設路由，而非網域名稱系統 (DNS) 伺服器路由，則您無法與代管供應商同盟。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsHostingProvider Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsHostingProvider"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
字串 |
要傳回之代管供應商的唯一識別碼。Identity 可能是代管供應商的完整網域 (FQDN) 名稱 (例如 fabrikam.com)，或者可能是提供服務的公司名稱 (Fabrikam, Inc.)。 如果未指定此參數，Get-CsHostingProvider 將傳回已設定為供組織使用的所有代管供應商的集合。 |
Filter |
選用 |
字串 |
讓您能夠使用萬用字元值，傳回一或多個代管供應商。例如，若要傳回 Identity 是以字串值 ".com" 結尾的所有代管供應商，請使用下列語法：-Filter "*.com"。若要傳回 Identity 是以字串 "Fabri" 開頭的所有代管供應商，請使用下列語法：-Filter "Fabri*"。 |
LocalStore |
選用 |
切換參數 |
從 中央管理存放區 的本機複本擷取代管供應商資料，而非從 中央管理存放區 本身擷取。 |
輸入類型
無。Get-CsHostingProvider 不會接受管線傳送的資料。
傳回類型
傳回 Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayHostingProvider 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Get-CsHostingProvider
上述命令會傳回已設定為供組織使用的所有代管供應商集合。呼叫 Get-CsHostingProvider 且未指定任何其他參數時，會傳回代管供應商的完整集合。
-------------------------- 範例 2 ------------------------
Get-CsHostingProvider -Identity Fabrikam.com
範例 2 傳回 Identity 為 Fabrikam.com 的代管供應商。由於 Identity 在代管供應商之間必須是唯一的，因此，此命令絕對不會傳回一個以上的項目。
-------------------------- 範例 3 ------------------------
Get-CsHostingProvider -Filter *.org
範例 3 所示的命令會傳回 Identity 以字串值 ".org" 結束 (例如，fabrikam.org 和 contoso.org) 的所有代管供應商集合。
-------------------------- 範例 4 ------------------------
Get-CsHostingProvider | Where-Object {$_.Enabled -eq $True}
在範例 4 中，會傳回目前已啟用為可供使用的所有代管供應商。為達成此目的，會先呼叫 Get-CsHostingProvider，以傳回目前設定用於組織之所有代管供應商的集合。然後將此集合傳送到 Where-Object 指令程式，這樣只會挑選出 Enabled 屬性等於 True 的供應商。
-------------------------- 範例 5 ------------------------
Get-CsHostingProvider | Where-Object {$_.Enabled -eq $True -and $_.EnabledSharedAddressSpace -eq $True}
上述命令會傳回具有共用位址空間和主控 Lync Server 2010 使用者的所有代管供應商；根據定義，這表示命令會傳回隸屬於「分隔網域」設定一部分的所有代管供應商 (簡單來說，分隔網域代表您的部分 Lync Server 帳戶是在內部維護，而其他帳戶是由代管供應商所維護)。為了執行此作業，命令會先使用 Get-CsHostingProvider，來傳回目前設定的所有代管供應商集合。這個集合會被傳送到 Where-Object 指令程式，這樣只會選取那些符合兩個準則的供應商：1) Enabled 屬性等於 True；且 2) EnabledSharedAddressSpace 屬性等於 True。
-------------------------- 範例 6 ------------------------
Get-CsHostingProvider | Select-Object *
範例 6 所示的命令會顯示針對在組織中使用而設定之所有代管供應商的屬性值。根據預設，當您執行 Get-CsHostingProvider 時，EnabledSharedAddressSpace 和 HostsOCSUsers 的屬性值不會出現。為了查看這些屬性的值，系統會將 Get-CsHostingProvider 傳回的資訊傳送到 Select-Object 指令程式；語法 "Select-Object *" 會指示 Get-CsHostingProvider 顯示所有屬性及傳回項目的屬性值。