Condividi tramite

  • Articolo

Get-CsPublicProvider

 

Ultima modifica dell'argomento: 2012-03-23

Restituisce informazioni sui provider pubblici configurati 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

Get-CsPublicProvider [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]

Get-CsPublicProvider [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrizione dettagliata

La federazione è un mezzo per stabilire una relazione di trust tra due organizzazioni per agevolare la comunicazione tra i due gruppi. Una volta stabilita una federazione, gli utenti delle due organizzazioni possono scambiarsi messaggi istantanei, sottoscrivere l'opzione per notifiche di presenza e comunicare tra loro in altri modi utilizzando le applicazioni SIP come 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. Se ad esempio 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. Il cmdlet Get-CsPublicProvider consente di restituire informazioni sui provider pubblici che sono stati configurati per l'utilizzo nell'organizzazione.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Get-CsPublicProvider i membri dei seguenti gruppi: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control) a cui è stato assegnato questo cmdlet, inclusi gli eventuali ruoli RBAC personalizzati creati dall'utente, dal prompt di Windows PowerShell eseguire il seguente comando:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Stringa

Identificatore univoco per il provider pubblico da restituire. L'identità in genere corrisponde al nome del sito Web che fornisce i servizi, ad esempio Yahoo!, AOL, MSN e così via.

Non è possibile utilizzare caratteri jolly quando si specifica l'identità. Anziché utilizzare caratteri jolly per restituire uno o più provider pubblici, utilizzare il parametro Filter.

Filter

Facoltativo

Stringa

Consente di utilizzare valori con caratteri jolly per restituire uno o più provider pubblici. Per restituire ad esempio una raccolta di tutti i provider pubblici con valore Identity che inizia con la lettera Y, utilizzare la seguente sintassi: -Filter "Y*". Per restituire una raccolta di tutti i provider pubblici che includono il valore stringa "Windows" in un punto qualsiasi del valore Identity, utilizzare la seguente sintassi: -Filter "*Windows*".

LocalStore

Facoltativo

Parametro opzionale

Recupera i dati relativi ai provider pubblici dalla replica locale dell'archivio di gestione centrale anziché dall'archivio di gestione centrale stesso.

Tipi di input

Nessuno. Get-CsPublicProvider non accetta l'input da pipeline.

Tipi restituiti

Restituisce le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayPublicProvider.

Esempio

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

Get-CsPublicProvider

Con il comando mostrato nell'esempio 1 viene restituita una raccolta di tutti i provider pubblici che sono configurati per l'utilizzo nell'organizzazione. Se si chiama Get-CsPublicProvider senza parametri aggiuntivi, verrà restituita sempre la raccolta completa dei provider pubblici.

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

Get-CsPublicProvider -Identity "MSN"

Nell'esempio 2 vengono restituiti tutti i provider pubblici con valore identity MSN. Poiché le identità devono essere univoche tra i provider pubblici e tra quelli di hosting, il comando restituirà al massimo un elemento.

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

Get-CsPublicProvider -Filter W*

Con il comando precedente vengono restituiti tutti i provider pubblici con valore Identity che inizia con la lettera W. Questa operazione viene eseguita includendo il parametro Filter e il valore di filtro "W*".

-------------------------- Esempio 4 ------------------------

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

Con il comando mostrato nell'esempio 4 viene restituita una raccolta di tutti i provider pubblici che sono attualmente disabilitati. A tale scopo, il comando chiama innanzitutto Get-CsPublicProvider per restituire una raccolta di tutti i provider pubblici configurati per l'utilizzo nell'organizzazione. La raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona solo i provider con proprietà Enabled uguale a False.

-------------------------- Esempio 5 ------------------------

Get-CsPublicProvider | Where-Object {$_.VerificationLevel -ne "AlwaysVerifiable"}

Con il comando precedente vengono restituiti tutti i provider pubblici per cui la proprietà VerificationLevel è impostata su AlwaysUnverifiable o UseSourceVerification. (I livelli di verifica possono essere impostati su AlwaysUnverifiable, UseSourceVerification o AlwaysVerifiable). Per eseguire questa attività, il comando chiamato innanzitutto Get-CsPublicProvider per restituire una raccolta di tutti i provider pubblici configurati per l'utilizzo nell'organizzazione. La raccolta viene quindi inviata tramite pipe a Where-Object, che sceglie solo i provider con proprietà VerificationLevel non uguale a AlwaysVerifiable. Il risultato è che verranno selezionati solo i provider per cui la proprietà VerificationLevel è impostata su AlwaysUnverifiable o UseSourceVerification.