Condividi tramite


Enable-CsPublicProvider

 

Ultima modifica dell'argomento: 2012-03-23

Configura un provider pubblico per l'utilizzo nell'organizzazione. Un provider pubblico è un'organizzazione che offre servizi di messaggistica istantanea, presenza e altri servizi correlati al pubblico. Microsoft Lync Server 2010 supporta tre provider pubblici, che sono configurati ma non abilitati: Yahoo!, AOL e MSN.

Sintassi

Enable-CsPublicProvider [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Enable-CsPublicProvider [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

La federazione è un mezzo per stabilire una relazione di trust tra due organizzazioni per agevolare la comunicazione tra i due gruppi. Quando è stata stabilita una federazione, gli utenti delle due organizzazioni possono inviarsi messaggi istantanei, sottoscrivere l'opzione di notifiche di presenza e comunicare in altri modi tra loro utilizzando le applicazioni SIP, ad esempio Microsoft Lync 2010. Lync Server 2010 supporta tre tipi di federazione: 1) federazione diretta tra due organizzazioni; 2) federazione tra un'organizzazione e un provider pubblico; e 3) federazione tra un'organizzazione e un provider di hosting di terze parti.

Un provider pubblico è un'organizzazione che fornisce servizi di comunicazione SIP al pubblico. Quando si stabilisce una relazione di federazione con un provider pubblico, in realtà si stabilisce una federazione con qualsiasi utente che disponga di un account ospitato da tale provider. Ad esempio, se si stabilisce una federazione con MSN, gli utenti potranno scambiare messaggi istantanei e informazioni sulla presenza con chiunque disponga di un account di messaggistica istantanea MSN.

Per poter stabilire una federazione con un provider pubblico, è necessario crearne e abilitarne uno nuovo, e il provider pubblico dovrà creare una relazione di federazione con l'utente o l'organizzazione. È possibile abilitare i provider pubblici al momento della creazione oppure una volta stabilita la federazione tramite il cmdlet Enable-CsPublicProvider.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Enable-CsPublicProvider in locale: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control, controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (compresi eventuali ruoli RBAC personalizzati creati autonomamente), eseguire il cmdlet riportato di seguito dal prompt di Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Enable-CsPublicProvider"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Stringa

Un identificatore univoco per il provider pubblico da abilitare. L'identità è in genere il nome del sito Web che fornisce i servizi (ad esempio Yahoo!, AOL o MSN).

Instance

Facoltativo

Oggetto DisplayPublicProvider

Consente di passare al cmdlet un riferimento a un oggetto anziché impostare singoli valori di parametro.

Force

Facoltativo

Parametro opzionale

Consente di evitare la visualizzazione di qualunque messaggio di errore non grave che potrebbe essere generato nel corso dell'esecuzione del comando.

WhatIf

Facoltativo

Parametro opzionale

Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.

Confirm

Facoltativo

Parametro opzionale

Viene visualizzata una richiesta di conferma prima di eseguire il comando.

Tipi di input

Oggetto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayPublicProvider. Enable-CsPublicProvider consente di accettare le istanze da pipeline dell'oggetto provider pubblico.

Tipi restituiti

Nessuno. Il cmdlet, invece, consente di abilitare le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayPublicProvider.

Esempio

-------------------------- Esempio 1 ------------------------

Enable-CsPublicProvider -Identity "MSN"

Il comando mostrato nell'esempio 1 consente di abilitare il provider pubblico con Identity MSN. Se MSN è già abilitato, il comando restituirà un errore.

-------------------------- Esempio 2 ------------------------

Get-CsPublicProvider | Where-Object {$_.Enabled -eq $False} | Enable-CsPublicProvider

l comando precedente consente di abilitare tutti i provider pubblici attualmente disabilitati. Per eseguire questa operazione, il comando utilizza per prima cosa Get-CsPublicProvider per restituire una raccolta di tutti i provider pubblici configurati per l'utilizzo nell'organizzazione. Questa raccolta viene quindi inviata tramite pipe a Where-Object, che seleziona solo i provider in cui la proprietà Enabled equivale a False. La raccolta filtrata viene quindi inviata tramite pipe a Enable-CsPublicProvider, che abilita ciascun provider all'interno di essa.

-------------------------- Esempio 3 ------------------------

Get-CsPublicProvider | Where-Object {$_.VerificationLevel -eq "AlwaysVerifiable" -and $_.Enabled -eq $False} | Enable-CsPublicProvider

Nell'esempio 3 vengono abilitati tutti i provider pubblici che attualmente non sono abilitati, purché il livello di verifica di tali provider sia impostato su AlwaysVerifiable. Per ottenere tale risultato, il comando chiama per prima cosa Get-CsPublicProvider per restituire una raccolta di tutti i provider pubblici attualmente in uso nell'organizzazione. Questa raccolta viene inviata tramite pipe a Where-Object, che seleziona i provider che soddisfano i due criteri seguenti: 1) la proprietà VerificationLevel equivale a AlwaysVerifiable e 2) la proprietà Enabled è uguale a False. L'operatore -and indica a Where-Object che gli oggetti dovranno essere selezionati solo se soddisfano tutti i criteri specificati. La raccolta filtrata viene quindi inviata tramite pipe a Enable-CsPublicProvider, che abilita ciascun provider all'interno di essa.