Condividi tramite

  • Articolo

Set-CsPublicProvider

 

Ultima modifica dell'argomento: 2012-03-25

Modifica un provider pubblico attualmente configurato per essere utilizzato 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

Set-CsPublicProvider [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-VerificationLevel <AlwaysVerifiable | AlwaysUnverifiable | UseSourceVerification>] [-WhatIf [<SwitchParameter>]]

Set-CsPublicProvider [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-VerificationLevel <AlwaysVerifiable | AlwaysUnverifiable | UseSourceVerification>] [-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; 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, in base alla configurazione del sistema, 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, sarà necessario crearne e abilitarne uno nuovo, e il provider pubblico dovrà creare una relazione di federazione con l'utente o l'organizzazione. Lync Server include tre provider pubblici già configurati: Yahoo!, AOL e MSN. Quando diventano disponibili altri provider pubblici, è possibile creare relazioni di federazione con tali nuovi provider utilizzando il cmdlet New-CsPublicProvider. Dopo aver stabilito le relazioni federate, è possibile utilizzare Set-CsPublicProvider per modificare due importanti valori delle proprietà, ovvero Enabled e VerificationLevel, di tali relazioni.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi seguenti sono autorizzati a eseguire il cmdlet Set-CsPublicProvider in locale: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli del controllo di accesso basato sui ruoli (RBAC) ai quali è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati creati dall'utente), eseguire il comando seguente dal prompt di Windows PowerShell:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Stringa

Identificatore univoco per il provider pubblico da modificare. Il parametro Identity in genere corrisponde al nome del sito Web che fornisce i servizi, ad esempio Yahoo!, AOL, MSN e così via.

Instance

Facoltativo

Oggetto DisplayPublicProvider

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

Enabled

Facoltativo

Parametro opzionale

Indica se la relazione di federazione tra l'organizzazione e il provider pubblico è attiva o meno. Se è impostato su True, gli utenti dell'organizzazione potranno scambiare messaggi istantanei e informazioni sulla presenza con utenti che dispongono di un account ospitato dal provider pubblico. Se è impostato su False, gli utenti dell'organizzazione non potranno scambiare messaggi istantanei e informazioni sulla presenza con utenti che dispongono di un account ospitato dal provider pubblico.

VerificationLevel

Facoltativo

Stringa

Indica come o se i messaggi inviati dal provider pubblico devono essere verificati per accertare che provengano effettivamente da quel provider. È necessario impostare VerificationLevel su uno dei seguenti valori:

AlwaysVerifiable. Tutti i messaggi che risultano inviati da questo provider verranno accettati. Se nel messaggio non viene rilevata alcuna intestazione di verifica, questa verrà aggiunta da Lync Server 2010. Questo è il valore predefinito.

AlwaysUnverifiable. Tutti i messaggi che risultano inviati da un provider pubblico vengono considerati non verificati. Essi verranno recapitati solo se inviati da una persona inclusa nell'elenco dei contatti del destinatario. Ad esempio, se Davide Garghentini è incluso nell'elenco dei contatti di un utente, questo utente potrà ricevere il messaggio inviato da Davide Garghentini. Se Luisa Cazzaniga non è inclusa nell'elenco dei contatti dell'utente, l'utente non sarà in grado di ricevere messaggi da lei.

UseSourceVerification. Utilizza l'intestazione di verifica aggiunta al messaggio dal provider pubblico. Se mancano le informazioni di verifica, il messaggio verrà rifiutato.

Force

Facoltativo

Parametro opzionale

Consente di evitare la visualizzazione di prompt di conferma o messaggi di errore non irreversibile che possono verificarsi quando si esegue il cmdlet.

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. Set-CsPublicProvider accetta istanze inviate tramite pipe dell'oggetto provider pubblico.

Tipi restituiti

Set-CsPublicProvider non restituisce un valore o un oggetto. In realtà, il cmdlet configura istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayPublicProvider.

Esempio

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

Set-CsPublicProvider -Identity "MSN" -VerificationLevel "UseSourceVerification"

Con il comando precedente viene impostato il parametro VerificationLevel per il provider pubblico con identità MSN. Questa operazione viene eseguita includendo il parametro VerificationLevel e il valore di parametro UseSourceVerification.

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

Get-CsPublicProvider | Set-CsPublicProvider -VerificationLevel "UseSourceVerification"

Nell'esempio 2 il livello di verifica viene modificato per tutti i provider pubblici attualmente utilizzati nell'organizzazione. Per questo scopo, viene chiamato prima Get-CsPublicProvider senza parametri per restituire una raccolta di tutti i provider pubblici attualmente configurati per l'utilizzo. La raccolta viene quindi inviata tramite pipe a Set-CsPublicProvider, che seleziona ogni provider nella raccolta e ne modifica il valore della proprietà VerificationLevel in UseSourceVerification.

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

Get-CsPublicProvider | Where-Object {$_.VerificationLevel -eq "AlwaysVerifiable"} | Set-CsPublicProvider -VerificationLevel "UseSourceVerification"

Con il comando mostrato nell'esempio 3 viene modificato il livello di verifica per qualsiasi provider pubblico per cui il livello sia attualmente impostato su AlwaysVerifiable. Per eseguire questa attività, viene chiamato prima Get-CsPublicProvider per restituire una raccolta di tutti i provider pubblici configurati per l'utilizzo nell'organizzazione. La raccolta così ottenuta viene quindi inviata tramite pipe al cmdlet Where-Object che seleziona solo quei provider in cui la proprietà VerificationLevel è uguale a AlwaysVerifiable. Questa raccolta filtrata viene quindi inviata tramite pipe a Set-CsPublicProvider, che modifica la proprietà VerificationLevel per ogni provider nella raccolta in UseSourceVerification.