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