Condividi tramite

  • Articolo

Get-CsHostingProvider

 

Ultima modifica dell'argomento: 2012-03-23

Restituisce informazioni relative ai provider di hosting configurati per essere utilizzati nell'organizzazione. Un provider di hosting è un'organizzazione di terze parti che fornisce servizi di messaggistica istantanea, di presenza e altri servizi correlati a un dominio con il quale si desidera stabilire una federazione. I provider di hosting, ad esempio Microsoft Lync Online 2010, si differenziano dai provider pubblici, quali Yahoo!, MSN e AOL, in quanto non offrono servizi al pubblico.

Sintassi

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

Get-CsHostingProvider [-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. 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, Lync 2010. Microsoft 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 di hosting è un'organizzazione che fornisce servizi di comunicazione SIP ad altre organizzazioni; ad esempio, Fabrikam, Inc. potrebbe ospitare utenti di Contoso, Northwind Traders e Wingtip Toys. Quando si stabilisce una relazione di federazione con un provider di hosting, si definisce in realtà una federazione con tutte le organizzazioni ospitate da quel provider. Ad esempio, se un'organizzazione si associa tramite federazione a Fabrikam, gli utenti dell'organizzazione potranno scambiare messaggi istantanei e informazioni sulla presenza con gli utenti di Contoso, Northwind Traders e Wingtip Toys.

I provider di hosting vengono utilizzati anche nello scenario dei domini combinati. In uno scenario di dominio diviso, alcuni utenti di Lync Server 2010 dispongono di account ospitati in locale, ovvero ospitati nell'implementazione locale di Lync Server. Altri utenti dispongono invece di account gestiti in remoto da provider di hosting di terze parti. La federazione con il provider di hosting consente agli utenti in locale e in remoto di comunicare tra loro.

Il cmdlet Get-CsHostingProvider consente di restituire informazioni su tutti i provider di hosting che sono stati configurati per essere utilizzati nell'organizzazione.

Non è possibile attuare la federazione con un provider di hosting se gli Edge Server sono configurati per utilizzare il routing predefinito anziché il routing del server DNS (Domain Name System).

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi seguenti sono autorizzati a eseguire il cmdlet Get-CsHostingProvider in locale: RTCUniversalUserAdmins, 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 "Get-CsHostingProvider"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Stringa

Identificatore univoco per il provider di hosting da restituire. L'identità può essere il nome di dominio completo per provider di hosting (ad esempio fabrikam.com) o il nome dell'azienda che fornisce i servizi (Fabrikam, Inc.).

Se questo parametro non viene specificato, Get-CsHostingProvider restituirà una raccolta di tutti i provider di hosting configurati per essere utilizzati nell'organizzazione.

Filter

Facoltativo

Stringa

Consente di utilizzare valori con caratteri jolly per restituire uno o più provider di hosting. Ad esempio, per restituire tutti i provider di hosting che hanno un'identità che termina con il valore stringa ".com", utilizzare la sintassi seguente: -Filter "*.com". Per restituire tutti i provider di hosting che hanno un'identità che inizia con la stringa "Fabri", utilizzare la sintassi seguente: -Filter "Fabri*".

LocalStore

Facoltativo

Parametro opzionale

Recupera i dati del provider di hosting dalla replica locale del archivio di gestione centrale anziché dallo stesso archivio di gestione centrale.

Tipi di input

Nessuno. Get-CsHostingProvider non accetta input inviato tramite pipe.

Tipi restituiti

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

Esempio

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

Get-CsHostingProvider

Con il comando precedente viene restituita una raccolta di tutti i provider di hosting configurati per essere utilizzati nell'organizzazione. Se si chiama Get-CsHostingProvider senza parametri aggiuntivi, viene restituita la raccolta completa dei provider di hosting.

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

Get-CsHostingProvider -Identity Fabrikam.com

Nell'esempio 2 viene restituito il provider di hosting con identità Fabrikam.com. Poiché le identità devono essere univoche tra i provider di hosting, il comando non restituirà mai più di un elemento.

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

Get-CsHostingProvider -Filter *.org

Con il comando mostrato nell'esempio 3 viene restituita una raccolta di tutti i provider di hosting che hanno un'identità che termina con il valore stringa ".org", ad esempio, fabrikam.org e contoso.org.

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

Get-CsHostingProvider | Where-Object {$_.Enabled -eq $True}

Nell'esempio 4 vengono restituiti tutti i provider di hosting che sono attualmente abilitati per l'uso. Per questo scopo, viene chiamato prima Get-CsHostingProvider per restituire una raccolta di tutti i provider di hosting attualmente configurati nell'organizzazione. La raccolta così ottenuta viene quindi inviata tramite pipe al cmdlet Where-Object che seleziona solo quei provider in cui la proprietà Enabled è uguale a True.

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

Get-CsHostingProvider | Where-Object {$_.Enabled -eq $True -and $_.EnabledSharedAddressSpace -eq $True}

Con il comando precedente vengono restituiti tutti i provider di hosting che dispongono di uno spazio degli indirizzi condiviso e che ospitano utenti di Lync Server 2010. Di conseguenza, vengono restituiti tutti i provider di hosting che fanno parte di una configurazione con dominio diviso (per dominio diviso si intende che alcuni account di Lync Server vengono gestiti in locale mentre altri account vengono gestiti da un provider di hosting). Per questo scopo, viene utilizzato prima Get-CsHostingProvider per restituire una raccolta di tutti i provider di hosting attualmente configurati. La raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona solo i provider che soddisfano due criteri: 1) la proprietà Enabled è uguale a True e 2) la proprietà EnabledSharedAddressSpace è uguale a True.

-------------------------- Esempio 6 ------------------------

Get-CsHostingProvider | Select-Object *

Il comando riportato nell'Esempio 6 consente di visualizzare tutti i valori delle proprietà per i provider di hosting configurati per l'utilizzo nell'organizzazione. Per impostazione predefinita, i valori delle proprietà per EnabledSharedAddressSpace e HostsOCSUsers non vengono visualizzati quando si esegue Get-CsHostingProvider. Per visualizzare i valori per queste proprietà. le informazioni restituite da Get-CsHostingProvider vengono inviate tramite pipe al cmdlet Select-Object, mentre la sintassi "Select-Object *" indica a Get-CsHostingProvider di visualizzare tutte le proprietà ei valori delle proprietà per gli elementi restituiti.