Disable-CsHostingProvider
上次修改主題的時間： 2012-03-23
停用組織目前使用中的代管供應商。代管供應商是第三方組織，可提供立即訊息、目前狀態，以及與您想要同盟之網域相關的服務。代管供應商 (例如 Microsoft Lync Online 2010) 不同於公用提供者 (例如 Yahoo!、MSN 和 AOL)，因為其服務並非提供給一般大眾。
語法
Disable-CsHostingProvider [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Disable-CsHostingProvider [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]
詳細描述
「同盟」是兩個組織可建立信任關係的一種方法，此信任關係會簡化兩個團體之間的通訊。建立同盟後，兩個組織的使用者便可互相傳送立即訊息、訂閱目前狀態通知，並使用如 Microsoft 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 本機實作上)。其他使用者的帳戶由第三方代管供應商在外部部署維護。與代管供應商同盟可讓內部部署使用者與外部部署使用者互相通訊。
若要與第三方代管供應商同盟，您必須建立並啟用新的代管供應商 (此外，該第三方供應商也必須與您建立同盟關係)。您可以在建立代管供應商時啟用該供應商；或者，也可以事後使用 Enable-CsHostingProvider 指令程式來啟用該供應商。此外，您隨時可以使用 Disable-CsHostingProvider 指令程式停用關係。當您停用代管供應商時，該供應商仍保留有效的同盟夥伴；不過，您組織與該供應商之間的所有通訊活動將會擱置，直到重新啟用供應商為止。
請注意，如果您的 Edge Server 設定為使用預設路由，而非網域名稱系統 (DNS) 伺服器路由，則您無法與代管供應商同盟。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Disable-CsHostingProvider Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Disable-CsHostingProvider"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
選用 |
字串 |
要停用之代管供應商的唯一識別碼。Identity 可能是代管供應商的完整網域 (FQDN) 名稱 (例如 fabrikam.com)，或者可能是提供服務的公司名稱 (Fabrikam, Inc.)。 |
Instance |
選用 |
DisplayHostingProvider 物件 |
允許您將物件參照傳遞給 Cmdlet，而不設定個別參數值。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayHostingProvider 物件。Disable-CsHostingProvider 會接受代管供應商物件的管線執行個體。
傳回類型
無。而指令程式會停用 Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayHostingProvider 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Disable-CsHostingProvider -Identity "Fabrikam.com"
範例 1 所示的命令會停用代管供應商 Fabrikam.com。請注意，如果已經停用 Fabrikam.com，此命令將會傳回錯誤訊息。
-------------------------- 範例 2 ------------------------
Get-CsHostingProvider | Where-Object {$_.Enabled -eq $True} | Disable-CsHostingProvider
以上的命令會停用目前已啟用的所有代管供應商。若要這樣做，此命令會先呼叫 Get-CsHostingProvider 以傳回設定用於組織之所有代管供應商的集合。接著，該集合會傳送到 Where-Object 指令程式，該指令程式只挑出 Enabled 屬性等於 True 的供應商。然後，篩選過的集合會傳送到 Disable-CsHostingProvider，以停用集合中的每個供應商。
-------------------------- 範例 3 ------------------------
Get-CsHostingProvider | Where-Object {$_.VerificationLevel -ne "AlwaysVerifiable" -and $_.Enabled -eq $True} | Disable-CsHostingProvider
在範例 3 中，會停用驗證層級不等於 AlwaysVerifiable 的所有已啟用的代管供應商。若要執行此工作，此命令會先使用 Get-CsHostingProvider 傳回設定用於組織之所有代管供應商的集合。此集合會傳送到 Where-Object 指令程式，這樣只會選取符合下列兩個條件的供應商：1) VerificationLevel 屬性不等於 AlwaysVerifiable；且，2) Enabled 屬性等於 True。然後，篩選過的集合會傳送到 Disable-CsHostingProvider，以停用集合中的每個供應商。