Remove-CsPublicProvider
上次修改主題的時間： 2012-03-26
移除已設定用於您組織的公用提供者。公用提供者是一家提供立即訊息 (IM)、目前狀態和相關服務給一般大眾的組織。Microsoft Lync Server 2010 隨附三個已設定但尚未啟用的公用提供者：Yahoo!、AOL 和 MSN。
語法
Remove-CsPublicProvider -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
同盟是兩個組織用來建立信任關係的方法，以促進兩個群組之間的溝通。建立同盟後，兩個組織的使用者便可互相傳送立即訊息、訂閱目前狀態通知，並使用如 Microsoft Lync 2010 等 SIP 應用程式互相通訊。Lync Server 2010 允許三種同盟：1) 您組織與其他組織之間的直接同盟；2) 您組織與公共供應商之間的同盟；3) 您組織與第三方代管供應商之間的同盟。
公用提供者是一家提供 SIP 通訊服務給一般大眾的組織。當您與公用提供者建立同盟關係時，實際上就等於和任何具有該提供者所提供帳戶的使用者建立同盟。例如，如果您與 MSN 結盟，您的使用者便能夠與任何具有 MSN 立即訊息帳戶的使用者交換立即訊息和目前狀態資訊。
若要與公用提供者結盟，您需要建立及啟用新的公用提供者 (此外，公用提供者也將需要與您建立同盟關係)。如果您之後決定要終止此關係，可以用 Remove-CsPublicProvider 指令程式刪除此公用提供者。刪除公用提供者時，會從您的同盟夥伴清單中移除提供者；在這之後，要重新建立關係的唯一方法是重新建立提供者。如果您想要暫停關係，改用 Disable-CsPublicProvider 指令程式。當公用提供者被停用時，不會從同盟夥伴清單中移除提供者；而是將提供者標示為已停用，而您的組織與該提供者之間的通訊也暫停。若要重新建立關係，只要使用 Enable-CsPublicProvider 重新啟用提供者即可。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Remove-CsPublicProvider Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsPublicProvider"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
字串 |
要移除的公用提供者的唯一識別碼。Identity 通常是提供服務的網站名稱 (例如，Yahoo!、AOL、MSN 等)。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayPublicProvider 物件。Remove-CsPublicProvider 接受公用提供者物件管線傳送的執行個體。
傳回類型
無。反之，指令程式會設定 Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayPublicProvider 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Remove-CsPublicProvider -Identity "MSN"
前面的命令會刪除 Identity 為 MSN 的公用提供者。此命令完成後，設定好的公用提供者清單中不會再出現 MSN；在這之後，要與 MSN 重新建立同盟唯一的方法是重新建立此提供者。
-------------------------- 範例 2 ------------------------
Get-CsPublicProvider | Remove-CsPublicProvider
範例 2 會刪除所有已設定在組織中使用的公用提供者。為達成此目的，此命令會先使用 Get-CsPublicProvider，以傳回目前設定使用的所有公用提供者之集合。然後將集合傳送給 Remove-CsPublicProvider，以刪除集合中的每一個提供者。
-------------------------- 範例 3 ------------------------
Get-CsPublicProvider | Where-Object {$_.Enabled -eq $False} | Remove-CsPublicProvider
在範例 3 中，將所有目前停用的公用提供者，從已設定的公用提供者集合中移除。為了執行此作業，命令會先使用 Get-CsPublicProvider 傳回目前已設定使用的所有公用提供者的集合。此集合會傳送給 Where-Object 指令程式，這樣只會挑出 Enabled 屬性等於 False 的提供者。然後將篩選過的集合傳送給 Remove-CsPublicProvider，以刪除集合中的所有項目。