Condividi tramite

  • Articolo

New-CsPublicProvider

 

Ultima modifica dell'argomento: 2012-03-26

Consente di creare una relazione federativa con un nuovo provider pubblico. Un provider pubblico è un'organizzazione che fornisce al pubblico servizi di messaggistica istantanea, presenza e altri servizi correlati. Microsoft Lync Server 2010 viene fornito con tre provider pubblici configurati, ma non abilitati: Yahoo!; AOL; MSN.

Sintassi

New-CsPublicProvider -Identity <XdsGlobalRelativeIdentity> -Enabled <$true | $false> -ProxyFqdn <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-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 si attua una federazione, gli utenti delle due organizzazioni federate possono inviarsi messaggi istantanei, sottoscrivere servizi di notifica della presenza e comunicare in altro modo utilizzando applicazioni SIP come Microsoft Lync 2010. Lync Server 2010 consente tre tipi di federazione: 1) federazione diretta tra la propria e un'altra organizzazione; 2) federazione tra la propria organizzazione e un provider pubblico; 3) federazione tra la propria organizzazione e un provider di hosting terzo.

Un provider pubblico è un'organizzazione che fornisce servii di comunicazione SIP al pubblico. Quando si instaura una federazione con un provider pubblico, la federazione viene in realtà estesa a chiunque abbia un account ospitato da quel 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 federarsi con un provider di pubblico, è necessario creare e abilitare un nuovo provider pubblico. A sua volta, il provider pubblico dovrà creare una relazione federativa con la nuova organizzazione. Il cmdlet Set-CsPublicProvider consente di modificare i valori delle proprietà di tutti i provider pubblici configurati per l'utilizzo nella propria organizzazione.

Non è possibile stabilire una federazione con un provider pubblico se i propri Edge Server sono configurati per utilizzare il routing predefinito anziché il routing del server DNS.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet New-CsPublicProvider può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalServerAdmins. Per ottenere un elenco di tutti i ruoli RBAC (controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati), utilizzare il seguente comando dal prompt di Windows PowerShell:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Stringa

Identificatore univoco per il provider pubblico da creare. Il valore di questo parametro corrisponde in genere al nome del sito Web che fornisce i servizi, ad esempio Yahoo!, AOL o MSN.

Le identità devono essere univoche non solo nell'ambito dei provider pubblici, ma anche nell'ambito dei provider di hosting. Si supponga di creare un nuovo provider pubblico con Identity Fabrikam. Il comando utilizzato avrà esito negativo in presenza di un provider pubblico o di hosting che abbia già quell'identità.

ProxyFqdn

Obbligatorio

Fqdn

Specifica il nome di dominio completo (FQDN), ad esempio proxyserver.fabrikam.com, del server proxy utilizzato dal provider pubblico.

Gli FQDN proxy devono essere univoci non solo nell'ambito dei provider pubblici, ma anche nell'ambito dei provider di hosting. Ad esempio, si supponga di creare un nuovo provider pubblico con FQDN proxy proxyserver.fabrikam.com. Questo comando avrà esito negativo, se esiste già un provider pubblico o di hosting con quello stesso FQDN proxy.

Enabled

Obbligatorio

Booleano

Indica se la federazione tra l'organizzazione e il provider pubblico è attiva o meno. Se impostato su True, gli utenti dell'organizzazione saranno in grado di scambiare messaggi istantanei e informazioni sulla presenza con gli utenti che hanno account ospitati dal provider pubblico. Se impostato su False, gli utenti dell'organizzazione non saranno in grado di scambiare messaggi istantanei e informazioni sulla presenza con gli utenti che hanno account ospitati dal provider pubblico. È possibile abilitare e disabilitare le relazioni federative utilizzando rispettivamente i cmdlet Enable-CsPublicProvider e Disable-CsPublicProvider.

VerificationLevel

Stringa

Indica come o se i messaggi inviati dal provider pubblico devono essere verificati per accertare che provengano effettivamente da quel provider. La proprietà VerificationLevel deve essere impostata 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

Parametro opzionale

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

InMemory

Parametro opzionale

Crea un riferimento a un oggetto senza eseguire realmente il commit dell'oggetto come modifica permanente. Se si assegna l'output del cmdlet chiamato con questo parametro a una variabile, è possibile apportare modifiche alle proprietà del riferimento all'oggetto e quindi eseguire il commit di queste modifiche chiamando il cmdlet Set- corrispondente.

WhatIf

Parametro opzionale

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

Confirm

Parametro opzionale

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

Tipi di input

Nessuno. New-CsPublicProvider non accetta input tramite pipeline.

Tipi restituiti

Consente di creare nuove istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayPublicProvider.

Esempio

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

New-CsPublicProvider -Identity "Fabrikam" -ProxyFqdn "proxyserver.fabrikam.com" -Enabled $True

Il comando riportato nell'Esempio 1 consente di creare una nuova relazione federativa con un provider pubblico con Identity Fabrikam. Oltre a specificare l'identità, occorre impostare anche altri due valori di proprietà e i corrispondenti parametri: ProxyFqdn (impostato su proxyserver.fabrikam.com) e Enabled (che, in questo caso, è impostato su True).

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

$x = New-CsPublicProvider -Identity "Fabrikam" -ProxyFqdn "proxyserver.fabrikam.com" -Enabled $True -InMemory
$x.VerificationLevel = "AlwaysUnverifiable"
Set-CsPublicProvider -Instance $x

L'Esempio 2 dimostra come sia possibile creare un nuovo provider pubblico solo in memoria, modificarne le proprietà e quindi trasformare quel provider virtuale in un vero provider che può essere effettivamente utilizzato dall'organizzazione. A tal fine, il primo comando nell'esempio crea un provider pubblico con Identity Fabrikam. Oltre a includere i parametri necessari (–Identity, -ProxyFqdn e –Enabled), il comando aggiunge il parametro -InMemory; questo parametro crea solo in memoria un'istanza del provider, che viene quindi memorizzata in una variabile denominata $x.

Una volta creata l'istanza del provider solo in memoria il secondo comando nell'esempio modifica il valore di VerificationLevel del provider virtuale. L'ultimo comando, infine, utilizza il cmdlet Set-CsPublicProvider per trasformare il provider virtuale, memorizzato nella variabile $x, in un provider pubblico effettivo. Se non si utilizza il cmdlet Set-CsPublicProvider il provider effettivo non verrà creato. A sua volta, il provider virtuale verrà eliminato al momento della chiusura delle sessione Windows PowerShell o quando si elimina la variabile $x.