New-CsPublicProvider
上次修改主題的時間： 2012-03-26
與新的公用提供者建立同盟關係。公用提供者是為大眾提供立即訊息、目前狀態及相關服務的組織。Microsoft Lync Server 2010 隨附於下列三個已設定但未啟用的公用提供者：Yahoo!、AOL 和 MSN。
語法
New-CsPublicProvider -Identity <XdsGlobalRelativeIdentity> -Enabled <$true | $false> -ProxyFqdn <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-VerificationLevel <AlwaysVerifiable | AlwaysUnverifiable | UseSourceVerification>] [-WhatIf [<SwitchParameter>]]
詳細描述
同盟是兩個組織用來建立信任關係的方法，以促進兩個群組之間的溝通。如果建立了同盟，兩個組織中的使用者就可以互相傳送立即訊息、訂閱目前狀態通知，以及使用 SIP 應用程式 (例如 Microsoft Lync 2010) 相互進行通訊。Lync Server 2010 允許下列三種同盟類型：1) 您的組織與其他組織之間的直接同盟；2) 您的組織與公用提供者之間的同盟；以及 3) 您的組織與第三方代管供應商之間的同盟。
公用提供者是為大眾提供 SIP 通訊服務的組織。當您與公用提供者建立同盟關係時，實際上是與在該提供者之主機上擁有帳戶的所有使用者建立同盟。例如，如果您與 MSN 結盟，您的使用者便能夠與任何具有 MSN 立即訊息帳戶的使用者交換立即訊息和目前狀態資訊。
若要與公用提供者同盟，您必須建立並啟用新的公用提供者 (此外，該公用提供者也必須與您建立同盟關係)。Set-CsPublicProvider 可讓您修改已設定為在組織中使用之任何公用提供者的屬性值。
請注意，如果您的 Edge Server 已設為使用預設路由，而非 DNS 伺服器路由，您將無法與公用提供者結盟。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 New-CsPublicProvider Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsPublicProvider"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
必要 |
字串 |
要建立之公用提供者的唯一識別碼。Identity 通常是提供服務的網站名稱 (例如，Yahoo!、AOL 或 MSN )。 Identity 不只在公用提供者間必須是唯一的，在代管供應商間也必須是唯一的。假設您嘗試建立 Identity 為 Fabrikam 的新公用提供者。如果具有該 Identity 的公用提供者或代管供應商已經存在，則命令將會失敗。 |
ProxyFqdn |
必要 |
Fqdn |
指定公用提供者所使用之 Proxy 伺服器的完整網域名稱 (FQDN) (例如，proxyserver.fabrikam.com)。 Proxy FQDN 不只在公用提供者間必須是唯一的，在代管供應商間也必須是唯一的。例如，假設您嘗試建立 Proxy FQDN 為 proxyserver.fabrikam.com 的新公用提供者。如果具有該 Proxy FQDN 的公用提供者或代管供應商已存在，則命令將會失敗。 |
Enabled |
必要 |
布林值 |
指出您的組織與公用提供者之間是否仍存在同盟關係。如果設為 True，組織中的使用者將可以與在該公用提供者之主機上擁有帳戶的使用者交換立即訊息和目前狀態資訊。如果設為 False，組織中的使用者將無法與在該公用提供者之主機上擁有帳戶的使用者交換立即訊息和目前狀態資訊。您隨時可以分別使用 Enable-CsPublicProvider 與 Disable-CsPublicProvider 指令程式來啟用及停用同盟關係。 |
VerificationLevel |
字串 |
表示如何驗證 (或是否驗證) 從公用提供者傳送的訊息，以確認它們確實是傳送自該提供者。VerificationLevel 必須設為下列其中一個值： AlwaysVerifiable。據稱是此提供者傳送的所有訊息都會接受。如果訊息中找不到驗證標頭，則 Lync Server 2010 將會新增驗證標頭。此為預設值。 AlwaysUnverifiable。據稱是公用提供者傳送的所有訊息都會被視為未驗證。只有當訊息是由收件者連絡人清單上的人員所傳送時，才會傳遞那些訊息。例如，如果 Ken Myer 在您的連絡人清單上，您將可以接收他的訊息。如果 Pilar Ackerman 不在您的連絡人清單上，則您將無法接收她的訊息。 UseSourceVerification。使用公用提供者新增至訊息的驗證標頭。如果缺少驗證資訊，則會拒絕該訊息。 |
|
Force |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
|
InMemory |
切換參數 |
建立物件參照，但而不實際將物件認可為永久變更。若將此參數所呼叫的 Cmdlet 輸出指派給變數，將可變更物件參照的屬性，然後呼叫此 Cmdlet 的對應 Set- Cmdlet 認可這些變更。 |
|
WhatIf |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
|
Confirm |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
無。New-CsPublicProvider 不接受管線傳送的輸入。
傳回類型
建立 Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayPublicProvider 物件的新執行個體。
範例
-------------------------- 範例 1 ------------------------
New-CsPublicProvider -Identity "Fabrikam" -ProxyFqdn "proxyserver.fabrikam.com" -Enabled $True
範例 1 所示的命令會與 Identity 為 Fabrikam 的公用提供者建立新的同盟關係。除了指定 Identity 之外，也必須設定以下其他兩個屬性值 (及其對應參數)：ProxyFqdn (設為 proxyserver.fabrikam.com) 及 Enabled (在此例中設為 True)。
-------------------------- 範例 2 ------------------------
$x = New-CsPublicProvider -Identity "Fabrikam" -ProxyFqdn "proxyserver.fabrikam.com" -Enabled $True -InMemory
$x.VerificationLevel = "AlwaysUnverifiable"
Set-CsPublicProvider -Instance $x
範例 2 會示範如何僅在記憶體中建立新的公用提供者、修改該提供者的屬性，然後將該虛擬提供者轉變成組織中可使用的實際提供者。若要這樣做，範例中的第一個命令會建立 Identity 為 Fabrikam 的公用提供者。除了加入必要參數 (Identity、ProxyFQDN 及 Enabled) 之外，該命令還會加入 InMemory 參數；這會建立提供者僅在記憶體中的執行個體，而且該提供者稍後會以名稱為 $x 的變數儲存。
建立提供者的記憶體內執行個體之後，範例中的第二個命令會修改虛擬提供者的 VerificationLevel。然後，最後一個命令會使用 Set-CsPublicProvider，將虛擬提供者 (以 $x 儲存) 轉變成實際的公用提供者。如果您沒有呼叫 Set-CsPublicProvider，將不會建立實際提供者。接著，當您結束 Windows PowerShell 工作階段或刪除變數 $x 時，虛擬提供者將會消失。