Condividi tramite


New-CsSimpleUrlConfiguration

 

Ultima modifica dell'argomento: 2012-10-17

Crea una nuova raccolta di configurazione 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-CsSimpleUrlConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-SimpleUrl <PSListModifier>] [-Tenant <Nullable>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

In Microsoft Office Communications Server 2007 R2, le riunioni presentano URL simili al seguente:

https://imdf.litwareinc.com/Join?uri=sip%3Adavidegarghentini%40litwareinc.com%3Bgruu%3Bopaque%3Dapp%3Aconf%3Afocus%3Aid%3A125f95a0b0184dcea706f1a0191202a8\&key=EcznhLh5K5t

Tuttavia, tali URL non sono particolarmente intuitivi e non risultano facili da comunicare a un altro utente. Gli URL semplici introdotti in Lync Server 2010 risolvono questo tipo di problemi mettendo a disposizione degli utenti degli URL simili al seguente:

https://meet.litwareinc.com/davidegarghentini/071200

Gli URL semplici rappresentano un miglioramento rispetto agli URL utilizzati in Office Communications Server. Tuttavia, gli URL semplici non vengono creati automaticamente, ma devono essere configurati dall'utente. Inoltre, è necessario eseguire operazioni quali la creazione di record DNS (Domain Name System) per ogni URL, la configurazione di regole proxy inverso per l'accesso esterno, l'aggiunta degli URL semplici ai certificati server Front End e così via.

Lync Server consente di creare tre diversi tipi di URL semplici:

Meet – Usati per le riunioni. È necessario disporre di almeno un URL Meet per i singoli domini SIP in uso.

Admin: utilizzato per consentire agli amministratori di accedere al Pannello di controllo di Lync Server 2010.

Dialin – Utilizzati per la pagina Web delle conferenze telefoniche con accesso esterno.

Gli URL semplici vengono memorizzati nelle raccolte di configurazioni di URL semplici. Durante l'installazione di Lync Server, viene creata automaticamente una raccolta globale. È inoltre possibile creare raccolte personalizzate nell'ambito del sito. In questo modo è possibile utilizzare diversi URL semplici nei singoli siti.

Le raccolte di configurazione di URL semplici vengono create tramite il cmdlet New-CsSimpleUrlConfiguration. È quindi possibile utilizzare cmdlet aggiuntivi (come New-CsSimpleUrl e Set-CsSimpleUrlConfiguration) per popolare queste raccolte con URL semplici. Dopo aver aggiornato una raccolta di URL semplici, è necessario eseguire il cmdlet Enable-CsComputer.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet New-CsSimpleUrlConfiguration in locale: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control, controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (compresi eventuali ruoli RBAC personalizzati creati autonomamente), eseguire il cmdlet riportato di seguito dal prompt di Windows PowerShell:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Identità XDS

Identificatore univoco per la nuova raccolta di configurazione di URL semplici. Poiché le nuove raccolte possono essere create solo nell'ambito del sito, l'identità deve utilizzare il prefisso "site:" seguito dal nome del sito. Ad esempio, questa sintassi consente di creare una nuova raccolta per il sito Redmond: -Identity "site:Redmond".

SimpleUrl

Facoltativo

Modificatore elenco PS

Gli URL semplici configurati per questa raccolta. Questi URL devono essere creati tramite i cmdlet New-SimpleUrl e New-SimpleUrlEntry.

InMemory

Facoltativo

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.

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.

Tenant

Facoltativo

Guid

Questo parametro non è utilizzato nella versione locale di Lync Server.

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

Nessuno.

Tipi restituiti

New-CsSimpleUrlConfiguration consente di creare nuove istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.SimpleUrl.SimpleUrlConfiguration.

Esempio

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

New-CsSimpleUrlConfiguration -Identity "site:Redmond"

Il comando mostrato nell'esempio 1 consente di creare una nuova raccolta di URL semplici per il sito Redmond. Visto che nel comando non sono inclusi altri parametri oltre ad Identity, la nuova raccolta non conterrà alcun URL semplice. Questo comando avrà esito negativo se il sito Redmond ospita già una raccolta di URL semplici.

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

$urlEntry = New-CsSimpleUrlEntry -Url "https://dialin.fabrikam.com"
$simpleUrl = New-CsSimpleUrl -Component "dialin" -Domain "*" -SimpleUrlEntry $urlEntry -ActiveUrl "https://dialin.fabrikam.com"

$urlEntry2 = New-CsSimpleUrlEntry -Url "https://meet.fabrikam.com"
$simpleUrl2 = New-CsSimpleUrl -Component "meet" -Domain "fabrikam.com" -SimpleUrlEntry $urlEntry2 

New-CsSimpleUrlConfiguration -Identity "site:Redmond" -SimpleUrl @{Add=$simpleUrl,$simpleUrl2}

Con l'esempio precedente viene dimostrato come creare una nuova raccolta di URL semplici che include due URL semplici (uno per la gestione delle riunioni e uno per le conferenze telefoniche con accesso esterno). Per ottenere questo risultato, il primo comando riportato nell'esempio utilizza il cmdlet New-CsSimpleUrlEntry per creare una voce URL che punta al sito https://dialin.litwareinc.com; questa voce URL è memorizzata in una variabile denominata $urlEntry. Con il secondo comando viene quindi creata un'altra voce URL che fa riferimento a https://meet.fabrikam.com.

A seguire, viene utilizzato il cmdlet New-CsSimpleUrl per creare un'istanza solo in memoria di un URL semplice. In questo esempio, il componente URL è impostato su dialin, il dominio è impostato su un asterisco (*), ActiveUrl è impostato su https://dialin.fabrikam.com, mentre la proprietà SimpleUrl è impostata su $urlEntry, che rappresenta la voce URL creata nel primo comando. Un comando simile viene utilizzato per creare un URL semplice per meet.fabrikam.com.

Dopo aver creato gli URL (e dopo averli archiviati nei riferimenti a oggetto $simpleUrl e $simpleUrl2), l'ultimo comando nell'esempio crea una nuova raccolta di URL semplici per il sito Redmond e aggiunge i due nuovi URL solo in memoria a tale raccolta. I nuovi URL vengono aggiunto alla raccolta con il cmdlet New-CsSimpleUrlConfiguration, il parametro SimpleUrl e il valore di parametro @{Add=$simpleUrl, $simpleUrl2}. Questa sintassi indica semplicemente che gli URL memorizzati nei riferimenti oggetto $simpleUrl e $simpleUrl2 devono essere aggiunti alla proprietà SimpleUrl.