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