Remove-CsHostingProvider
上次修改主題的時間: 2012-03-25
移除組織目前使用的一或多個裝載提供者。裝載提供者是第三方組織,可提供立即訊息、目前狀態,以及與您想要同盟之網域相關的服務。裝載提供者 (如 Microsoft Lync Online 2010) 與公用提供者 (例如 Yahoo!、MSN 與 AOL) 不同,因為裝載提供者不對一般大眾提供服務。
語法
Remove-CsHostingProvider -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<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 本端實作)。其他使用者的帳戶由第三方代管供應商在外部部署維護。與代管供應商同盟可讓內部部署使用者與外部部署使用者互相通訊。
為了與第三方代管供應商同盟,您必須建立並啟用新的代管供應商。(此外,第三方供應商必須與您建立同盟關係)。如果您日後決定終止此關係,可以使用 Remove-CsHostingProvider 指令程式刪除代管供應商。當您刪除代管供應商後,會自同盟夥伴清單中移除該供應商;到時候重新建立關係的唯一方法就是重新建立供應商。如果您要暫時中止關係,請改用 Disable-CsHostingProvider 指令程式。當代管供應商為停用時,不會自同盟夥伴清單中刪除該供應商;而是標記為已停用,同時也會停用您組織與該供應商之間的通訊。若要重新建立關係,您可以使用 Enable-CsHostingProvider 重新啟用供應商。
誰可以執行此 Cmdlet:下列群組的成員預設會獲授權可以在本機上執行 Remove-CsHostingProvider Cmdlet:RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色),請在 Windows PowerShell 提示字元中執行下列命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsHostingProvider"}
參數
參數 | 必要 | 類型 | 描述 |
---|---|---|---|
Identity |
必要 |
字串 |
要移除之代管供應商的唯一識別碼。Identity 是字串值;Identity 可能是代管供應商的完整網域 (FQDN) 名稱 (例如 fabrikam.com),或者可能是提供服務的公司名稱 (Fabrikam, Inc.)。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果,但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayHostingProvider 物件。Remove-CsHostingProvider 會接受代管供應商物件的管線執行個體。
傳回類型
無。反之,指令程式會刪除 Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayHostingProvider 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Remove-CsHostingProvider -Identity "Fabrikam.com"
範例 1 所示的命令會顯示 Identity 為 Fabrikam.com 的代管供應商。在刪除該代管供應商後,與 Fabrikam.com (以及任何與 Fabrikam.com 關聯的網域) 之間的同盟將會終止。
-------------------------- 範例 2 ------------------------
Get-CsHostingProvider | Remove-CsHostingProvider
範例 2 會刪除所有設定用於組織的代管供應商。如果要執行這項作業,命令會先使用 Get-CsHostingProvider 以傳回所有目前正在使用的所有代管供應商集合。該集合接著被傳送到 Remove-CsHostingProvider,這會刪除集合中的每一個項目。當此命令完成時,便不再有任何設定使用的代管供應商。
-------------------------- 範例 3 ------------------------
Get-CsHostingProvider -Filter "*Fabrikam*" | Remove-CsHostingProvider
上述命令會刪除任何在供應商 Identity 的某處有出現字串值 "Fabrikam" 的代管供應商。為了完成此工作,命令會先呼叫 Get-CsHostingProvider 與 Filter 參數;篩選值 "*Fabrikam*" 會將傳回的資料限制在 Identity 的某處有 "Fabrikam" 字串值的任何代管供應商。例如,此命令會傳回像是 Fabrikam.com、Fabrikam.net 與 FabrikamUsers.com 等供應商。接著這個篩選後的集合會傳送到 Remove-CsHostingProvider,此指令程式會刪除集合中的每個項目。
-------------------------- 範例 4 ------------------------
Get-CsHostingProvider | Where-Object {$_.VerificationLevel -ne "AlwaysVerifiable"} | Remove-CsHostingProvider
在範例 4 中,會刪除所有驗證層級不是設為 AlwaysVerifiable 的代管供應商。做法是先呼叫不含任何額外參數的 Get-CsHostingProvider,這會傳回所有設定用於組織之所有代管供應商的集合。所產生的集合隨後便傳送到 Where-Object 指令程式,這樣只會挑選出 VerificationLevel 屬性不等於 AlwaysVerifiable 的供應商。然後,篩選過的集合會傳送到 Remove-CsHostingProvider,以移除該篩選過之集合中的每個供應商。
-------------------------- 範例 5 ------------------------
Get-CsHostingProvider | Where-Object {$_.Enabled -eq $False} | Remove-CsHostingProvider
上述命令會移除所有目前停用的代管供應商。如果要執行這項作業,命令會先使用 Get-CsHostingProvider 傳回設定用於組織之所有代管供應商的集合。此集合會傳送到 Where-Object,這樣只會挑選出已停用的供應商,亦即只挑出 Enabled 屬性等於 False 的供應商。篩選後的集合隨後便會傳送到 Remove-CsHostingProvider,此指令程式會刪除每個已停用的代管供應商。