Get-CsPublicProvider
上次修改主題的時間： 2012-03-23
傳回為已設定供您組織使用的公用提供者的相關資訊。公用提供者是一家提供立即訊息、目前狀態和相關服務給一般大眾的組織。Microsoft Lync Server 2010 隨附三個已設定但尚未啟用的公用提供者：Yahoo!、AOL 和 MSN。
語法
Get-CsPublicProvider [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsPublicProvider [-Filter <String>] [-LocalStore <SwitchParameter>]
詳細描述
同盟是兩個組織用來建立信任關係的方法，以促進兩個群組之間的溝通。建立同盟後，兩個組織的使用者便可互相傳送立即訊息、訂閱目前狀態通知，並使用如 Microsoft Lync 2010 等 SIP 應用程式互相通訊。Lync Server 2010 允許三種同盟：1) 您組織與其他組織之間的直接同盟；2) 您組織與公共供應商之間的同盟；3) 您組織與第三方代管供應商之間的同盟。
公用提供者是一家提供 SIP 通訊服務給一般大眾的組織。當您與公用提供者建立同盟關係時，實際上就等於和任何具有該提供者所提供帳戶的使用者建立同盟。例如，如果您與 MSN 結盟，您的使用者便能夠與任何具有 MSN 立即訊息帳戶的使用者交換立即訊息和目前狀態資訊。
若要與公用提供者結盟，您需要建立及啟用新的公用提供者 (此外，公用提供者也將需要與您建立同盟關係)。Get-CsPublicProvider 指令程式讓您可以傳回為已設定用於您組織的公用提供者相關資訊。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsPublicProvider Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsPublicProvider"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
字串 |
要傳回的公用提供者的唯一識別碼。Identity 通常是提供服務的網站名稱 (例如，Yahoo!、AOL、MSN 等)。 您無法在指定 Identity 時使用萬用字元。若要使用萬用字元傳回一或多個公用提供者，請改用 Filter 參數。 |
Filter |
選用 |
字串 |
讓您可以使用萬用字元傳回一或多個公用提供者。例如，若要傳回 Identity 是以字母 Y 開頭的所有公用提供者的集合，請使用此語法：-Filter "Y*"。若要傳回 Identity 中有出現字串值 "Windows" 的公用提供者的集合，請使用此語法：-Filter "*Windows*"。 |
LocalStore |
選用 |
切換參數 |
從中央管理存放區本機複本擷取公用提供者資料，而不是從中央管理存放區本身擷取。 |
輸入類型
無。Get-CsPublicProvider 不會接受管線傳送的輸入。
傳回類型
傳回 Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayPublicProvider 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Get-CsPublicProvider
範例 1 所示的命令會傳回設定用於組織中的所有公用提供者的集合。呼叫 Get-CsPublicProvider 且未搭配任何其他參數時，一律會傳回完整的公用提供者集合。
-------------------------- 範例 2 ------------------------
Get-CsPublicProvider -Identity "MSN"
範例 2 中，會傳回所有 Identity 為 MSN 的公用提供者。由於識別身分必須是公用提供者 (和代管供應商) 之中唯一的，因此這個命令一律最多只會傳回單一項目。
-------------------------- 範例 3 ------------------------
Get-CsPublicProvider -Filter W*
上述命令會傳回 Identity 是以字母 W 開頭的所有公用提供者。這可藉由包含 Filter 參數和篩選值 "W*" 來完成。
-------------------------- 範例 4 ------------------------
Get-CsPublicProvider | Where-Object {$_.Enabled -eq $False}
範例 4 所示的命令會傳回目前組織中停用的所有公用提供者的集合。為達成此目的，此命令會先呼叫 Get-CsPublicProvider，以傳回目前組織中已設定使用的所有公用提供者集合。接著將此集合傳送給 Where-Object 指令程式，這樣只會選取 Enabled 屬性等於 False 的提供者。
-------------------------- 範例 5 ------------------------
Get-CsPublicProvider | Where-Object {$_.VerificationLevel -ne "AlwaysVerifiable"}
前面的命令會傳回所有 VerificationLevel 屬性設為 AlwaysUnverifiable 或 UseSourceVerification 的公用提供者 (驗證層級可設為 AlwaysUnverifiable、UseSourceVerification 或 AlwaysVerifiable)。為了執行此工作，命令先呼叫 Get-CsPublicProvider 傳回目前組織中已設定使用的所有公用提供者的集合。接著將此集合傳送給 Where-Object，這樣只會挑出 VerificationLevel 屬性不等於 AlwaysVerifiable 的提供者。整體效果是：只會選取 VerificationLevel 屬性設為 AlwaysUnverifiable 或 UseSourceVerification 的公用提供者。