Enable-CsHostingProvider
Ultima modifica dell'argomento: 2012-03-23
Consente di abilitare un provider di hosting per l'utilizzo nella propria 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 quali Microsoft Lync Online 2010, si differenziano dai provider pubblici (quali Yahoo!, MSN e AOL) in quanto non offrono servizi al pubblico.
Sintassi
Enable-CsHostingProvider [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Enable-CsHostingProvider [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
La federazione è un mezzo tramite il quale due organizzazioni possono instaurare una relazione di trust che facilita la comunicazione tra i due gruppi. Quando viene creata una federazione, gli utenti delle due organizzazioni possono scambiare messaggi istantanei, sottoscrivere i servizi di notifica della presenza e comunicare in altri modi tra loro utilizzando le applicazioni SIP (ad esempio, Microsoft Lync 2010). Microsoft Lync Server 2010 supporta 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 di hosting è un'organizzazione che fornisce servizi di comunicazione SIP ad altre organizzazioni, ad esempio Fabrikam, Inc. può ospitare utenti di Contoso, Northwind Traders e Wingtip Toys. Quando si instaura una federazione con un provider di hosting, la federazione viene in realtà estesa a qualunque organizzazione ospitata 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 sono anche utilizzati in scenari di dominio diviso. 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 possono avere i propri account ospitati in remoto presso 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.
Per attuare la federazione con un provider di hosting di terze parti è necessario creare e abilitare un nuovo provider di hosting. A sua volta, il provider di hosting terzo dovrà creare una relazione federativa con la nuova organizzazione. È possibile abilitare un provider di hosting al momento della sua creazione; in alternativa, è possibile abilitare il provider successivamente tramite il cmdlet Enable-CsHostingProvider
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 autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Enable-CsHostingProvider 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 "Enable-CsHostingProvider"}
Parametri
Parametro | Obbligatorio | Tipo | Descrizione |
---|---|---|---|
Identity |
Facoltativo |
Stringa |
Identificatore univoco del provider di hosting da abilitare. L'identità può essere il nome di dominio completo (FQDN) del provider di hosting (ad esempio, fabrikam.com) o il nome dell'azienda che fornisce i servizi (Fabrikam, Inc.). |
Instance |
Facoltativo |
Oggetto DisplayHostingProvider |
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.DisplayHostingProvider. Enable-CsHostingProvider accetta le istanze dell'oggetto provider di hosting inviate tramite pipeline.
Tipi restituiti
Nessuno. Il cmdlet abilita invece le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayHostingProvider.
Esempio
-------------------------- Esempio 1 --------------------------
Enable-CsHostingProvider -Identity Fabrikam.com
Nell'Esempio 1, viene abilitato il provider di hosting con Identity Fabrikam.com. Si noti che questo comando restituisce un errore, se Fabrikam.com è già stato abilitato.
-------------------------- Esempio 2 --------------------------
Get-CsHostingProvider | Where-Object {$_.Enabled -eq $False} | Enable-CsHostingProvider
L'Esempio 2 mostra come abilitare tutti i provider di hosting che sono attualmente disabilitati. Per ottenere questo risultato, il comando utilizza prima il cmdlet Get-CsHostingProvider senza parametri aggiuntivi per ottenere una raccolta di tutti i provider di hosting attualmente configurati per l'utilizzo nell'organizzazione. La raccolta così ottenuta viene inviata tramite pipe al cmdlet Where-Object che seleziona i provider in cui la proprietà Enabled è uguale a False; per definizione, si tratta di qualunque provider attualmente disabilitato. Questa raccolta filtrata viene quindi inviata tramite pipe al cmdlet Enable-CsHostingProvider che abilita ciascun provider nella raccolta.
-------------------------- Esempio 3 --------------------------
Get-CsHostingProvider | Where-Object {$_.EnabledSharedAddressSpace -eq $True -and $_.Enabled -eq $False} | Enable-CsHostingProvider
Nell'Esempio 3, vengono abilitati tutti i provider di hosting utilizzati in una configurazione di "dominio diviso". Un dominio combinato è un dominio in cui alcuni account Lync Server dell'organizzazione vengono gestiti localmente e altri account sono gestiti dal provider di hosting. Per questo scopo, il comando utilizza 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 quei provider che soddisfano due criteri: 1) la proprietà EnabledSharedAddressSpace è uguale a True; 2) la proprietà Enabled è uguale a False. A questo punto, la raccolta filtrata viene inviata tramite pipe al cmdlet Enable-CsHostingProvider che abilita ogni provider incluso nella raccolta.
Vedere anche
Ulteriori risorse
Disable-CsHostingProvider
Get-CsHostingProvider
New-CsHostingProvider
Remove-CsHostingProvider
Set-CsHostingProvider