New-CsSimpleUrl
Ultima modifica dell'argomento: 2012-10-17
Consente di creare un nuovo URL semplice che può essere poi aggiunto alla raccolta di configurazioni di URL semplici. Gli URL semplici consentono agli utenti di partecipare con facilità a riunioni e conferenze e permettono agli amministratori di accedere più facilmente al Pannello di controllo di Microsoft Lync Server 2010.
Sintassi
New-CsSimpleUrl -Component <String> -Domain <String> [-ActiveUrl <String>] [-SimpleUrlEntry <PSListModifier>]
Descrizione dettagliata
In Microsoft Office Communications Server 2007 R2, per le riunioni si utilizzavano URL simili al seguente:
Tuttavia, URL di questo tipo non sono particolarmente intuitivi e facili da comunicare ad altri utenti. Gli URL semplificati introdotti in Lync Server 2010 risolvono questo tipo di problema mettendo a disposizione degli utenti degli URL simili al seguente:
https://meet.litwareinc.com/davidegarghentini/071200
Gli URL semplificati rappresentano un miglioramento notevole rispetto agli URL utilizzati in Office Communications Server. Tenere presente che gli URL semplificati non vengono creati automaticamente, ma devono essere configurati dall'utente. Inoltre, è necessario creare i record DNS (Domain Name System) per ciascun URL, configurare regole proxy inverse per gli accessi esterni, aggiungere gli URL semplificati ai certificati server Front End e così via.
Lync Server consente di creare tre diversi tipi di URL semplificati:
Meet: utilizzato per le riunioni. Occorre avere almeno un URL di tipo Meet per ciascuno dei propri domini SIP.
Admin: utilizzato per consentire agli amministratori di accedere al Pannello di controllo di Lync Server 2010.
Dialin: utilizzato per le pagine Web delle conferenze telefoniche con accesso esterno.
Gli URL semplificati vengono memorizzati nelle raccolte di configurazioni di URL semplificati. Quando si installa Lync Server, viene creata automaticamente una raccolta globale. È inoltre possibile creare raccolte personalizzate nell'ambito del sito. In questo modo, è possibile utilizzare diversi URL semplificati nei singoli siti.
Per aggiungere un URL effettivo a una raccolta di URL semplificati, è necessario innanzitutto creare l'URL utilizzando i cmdlet New-CsSimpleUrl e New-CsSimpleUrlEntry. Il cmdlet New-CsSimpleUrlEntry consente di creare una voce URL: un URL (ad esempio, https://meet.litwareinc.com) che può essere utilizzato come URL semplificato per riunioni, amministrazione o conferenze telefoniche con accesso esterno. L'oggetto creato dal cmdlet New-CsSimpleUrlEntry viene aggiunto alla proprietà SimpleUrlEntry di un nuovo URL semplificato. È necessario utilizzare un altro cmdlet per creare l'oggetto, in quanto la proprietà SimpleUrlEntry può contenere diversi URL. Tuttavia, di questi URL solo uno può essere designato come URL attivo. L'URL attivo rappresenta l'URL effettivo utilizzato per riunioni, amministrazione o conferenze telefoniche.
Dopo avere creato una voce URL semplificato, utilizzare il cmdlet New-CsSimpleUrl per creare nella sola memoria un'istanza di un URL semplificato, definendo alcune impostazioni come il componente (il tipo di URL semplificato), il dominio, l'URL attivo e tutte le voci relative all'URL semplificato. Una volta creato, l'oggetto che rappresenta l'URL semplificato può essere aggiunto a una raccolta nuova o esistente di URL semplificati. Dopo aver aggiornato una raccolta di URL semplificati, è necessario utilizzare il cmdlet Enable-CsComputer.
Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet New-CsSimpleUrl 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-CsSimpleUrl\b"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Component |
Obbligatorio |
Stringa |
Indica il tipo di URL semplificato da creare. I valori validi sono: Meet – URL utilizzato per la gestione delle riunioni. Admin – URL che punta a Pannello di controllo di Lync Server 2010. Dialin – URL utilizzato per le conferenze telefoniche con accesso esterno. Ad esempio: -Component "Meet". |
Domain |
Obbligatorio |
Stringa |
Dominio SIP dell'URL semplificato. Ad esempio: -Domain "litwareinc.com". |
SimpleUrlEntry |
Facoltativo |
Modificatore dell'elenco PS |
Raccolta di URL per il componente specificato. Ad esempio, sia https://meet.litwareinc.com sia https://litwareinc.com/meet potrebbero essere configurati come voci URL per il componente Meet. Tuttavia, solo uno di quei due URL può (e deve) essere configurato come URL attivo. Le voci URL semplificati devono essere create tramite il cmdlet New-CsSimpleUrlEntry. |
ActiveUrl |
Facoltativo |
Stringa |
Indica l'URL a cui stanno effettivamente accedendo gli utenti. La proprietà SimpleUrlEntry può contenere diversi URL, ma solo uno di quegli URL può essere attivo in un dato momento nel tempo. Se si tenta di impostare il parametro ActiveUrl su un valore non incluso nella proprietà SimpleUrlEntry, si riceve un messaggio di errore. Per assegnare un URL attivo, utilizzare semplicemente lo stesso URL come valore del parametro. Ad esempio: -ActiveUrl https://meet.litwareinc.com". |
Tipi di input
Nessuno. New-CsSimpleUrl non accetta dati tramite pipeline.
Tipi restituiti
New-CsSimpleUrl crea nuove istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.SimpleUtl.SimpleUrl.
Esempio
-------------------------- Esempio 1 --------------------------
$urlEntry = New-CsSimpleUrlEntry -Url "https://meet.fabrikam.com"
$simpleUrl = New-CsSimpleUrl -Component "meet" -Domain "fabrikam.com" -SimpleUrlEntry $urlEntry -ActiveUrl "https://meet.fabrikam.com"
Set-CsSimpleUrlConfiguration -Identity "site:Redmond" -SimpleUrl @{Add=$simpleUrl}
Nell'esempio precedente viene illustrato come aggiungere un nuovo URL a una raccolta esistente di URL semplificati. Innanzitutto, il primo comando nell'esempio utilizza il cmdlet New-CsSimpleUrlEntry per creare un URL che punta a https://meet.fabrikam.com. Questo URL viene memorizzato in una variabile denominata $urlEntry.
Nel secondo comando viene utilizzato il cmdlet New-CsSimpleUrl per creare un'istanza di un URL semplice solo in memoria. In questo esempio il parametro Component è impostato su Meet, il dominio (Domain) è impostato su fabrikam.com, ActiveUrl è impostato su https://meet.fabrikam.com e la proprietà SimpleUrlEntry è impostata su $urlEntry, dove $urlEntry è la voce URL creata nel primo comando.
Dopo aver creato l'URL e averlo memorizzato nel riferimento oggetto $simpleUrl, l'ultimo comando nell'esempio consente di aggiungere il nuovo URL alla raccolta di URL semplificati per il sito Redmond. Per ottenere questo risultato viene utilizzato il cmdlet Set-CsSimpleUrlConfiguration, il parametro SimpleUrl e il valore del parametro @{Add=$simpleUrl}. Questa sintassi fa in modo che l'URL memorizzato nel riferimento oggetto $simpleUrl venga aggiunto alla proprietà SimpleUrl.