Condividi tramite

  • Articolo

Set-CsSimpleUrlConfiguration

 

Ultima modifica dell'argomento: 2012-10-17

Modifica una raccolta delle configurazioni esistente 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

Set-CsSimpleUrlConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-SimpleUrl <PSListModifier>] [-Tenant <Nullable>] [-WhatIf [<SwitchParameter>]]

Set-CsSimpleUrlConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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 semplificati 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 costituiscono un miglioramento degli URL utilizzati nella precedente versione di Office Communications Server. Tuttavia, gli URL semplici non vengono creati automaticamente, ma devono essere configurati dall'utente. È inoltre necessario creare record DNS per ciascun URL, configurare le regole del proxy inverso per l'accesso esterno, aggiungere gli URL semplici ai certificati server Front End e così via.

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

Meet: utilizzato 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 a Pannello di controllo di Lync Server 2010.

Dialin – utilizzato 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 creato le raccolte, utilizzando Set-CsSimpleUrlConfiguration è inoltre possibile modificare gli URL memorizzati in tali raccolte.

L'aggiunta di un URL semplice ad una raccolta è ragionevolmente semplice. Per iniziare, utilizzare New-CsSimpleUrl e New-CsSimpleUrlEntry per creare un URL solo in memoria. Utilizzare quindi il comando Add per aggiungere il nuovo URL alla raccolta esistente. In alternativa, è possibile utilizzare il metodo della sostituzione per sostituire tutti gli URL esistenti con uno nuovo.

La rimozione di un URL da una raccolta risulta invece più difficile, in quanto si deve prima creare un nuovo riferimento oggetto per l'URL interessato (che simuli l'URL esistente), quindi si deve utilizzare tale riferimento oggetto e il metodo della sostituzione per eliminare l'URL.

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 seguenti sono autorizzati a eseguire il cmdlet Set-CsSimpleUrlConfiguration in locale: 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 "Set-CsSimpleUrlConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identità XDS

L'identificatore univoco per la raccolta di URL semplici da modificare. Per modificare la raccolta globale, utilizzare la seguente sintassi: -Identity global. Per modificare una raccolta dall'ambito sito, utilizzare una sintassi simile alla seguente: -Identity "site:Redmond."

Se il parametro non viene specificato, verrà modificata la raccolta globale.

Instance

Facoltativo

Oggetto SimpleUrlConfiguration

Consente di passare al cmdlet un riferimento a un oggetto anziché impostare singoli valori di parametro.

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.

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 con le versioni locali di Lync Server 2010.

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.SimpleUrl.SimpleUrlConfiguration. Set-CsSimpleUrlConfiguration accetta istanze inviate tramite pipe dell'oggetto di configurazione URL semplice.

Tipi restituiti

Nessuno.

Esempio

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

Set-CsSimpleUrlConfiguration -Identity "site:Redmond" -SimpleUrl $Null

Il comando indicato nell'esempio 1 consente di rimuovere tutti gli URL semplici dal sito di Redmond, ma non di rimuovere la raccolta effettiva degli URL semplici. La raccolta sarà ancora presente, ma non conterrà alcun URL. A tale scopo, il comando utilizza il parametro –SimpleUrl ed imposta il valore del parametro su NULL ($Null). Questo consente di rimuovere tutti gli URL semplici dalla raccolta.

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

$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 semplici. Per iniziare, il primo comando nell'esempio utilizza New-CsSimpleUrlEntry per creare un URL che punti a https://meet.fabrikam.com. Questo URL viene memorizzato in una variabile denominata $urlEntry.

Nel secondo comando, New-CsSimpleUrl viene utilizzato per creare un'istanza solo in memoria di un URL semplice. In questo esempio, il parametro URL Component è impostato su Meet; il dominio è impostato su fabrikam.com; ActiveUrl è impostato su https://meet.fabrikam.com; la proprietà SimpleUrl è 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 riportato nell'esempio consente di aggiungere un nuovo URL alla raccolta di URL semplificati per il sito Redmond. Questo si esegue utilizzando il cmdlet Set-CsSimpleUrlConfiguration, il parametro –SimpleUrl e il valore del parametro @{Add=$simpleUrl}. Questa sintassi indica che l'URL memorizzato nel riferimento oggetto $simpleUrl deve essere aggiunto alla proprietà SimpleUrl.

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

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

Set-CsSimpleUrlConfiguration -Identity "site:Redmond" -SimpleUrl @{Remove=$simpleUrl}

Nei comandi indicati nell'esempio 3 viene illustrato come eliminare un singolo URL dalla raccolta di URL semplici. Poiché Set-CsSimpleUrlConfiguration necessita di oggetti URL, l'esempio inizia con la creazione di un nuovo oggetto che contiene esattamente gli stessi valori di proprietà dell'URL da eliminare. A tale scopo, il primo comando utilizza New-CsSimpleUrlEntry per creare un URL che punti a https://meet.fabrikam.com. Questo URL viene memorizzato in una variabile denominata $urlEntry.

Dopo aver creato l'URL, il secondo comando utilizza New-CsSimpleUrl per creare un'istanza solo in memoria di un URL semplice. In questo esempio, il parametro URL Component è impostato su Meet; il dominio è impostato su fabrikam.com; ActiveUrl è impostato su https://meet.fabrikam.com; la proprietà SimpleUrl è impostata su $urlEntry, dove $urlEntry è la voce URL creata nel primo comando. In questo modo viene creato un URL in memoria ($simpleUrl) che presenta gli stessi valori di proprietà dell'URL da eliminare.

Il comando finale nell'esempio consente di eliminare l'URL dalla raccolta di URL semplici per il sito di Redmond. Questo si esegue utilizzando il cmdlet Set-CsSimpleUrlConfiguration, il parametro –SimpleUrl e il valore del parametro @{Remove=$simpleUrl}. Tale sintassi indica che l'URL memorizzato nel riferimento oggetto $simpleUrl deve essere rimosso dalla proprietà SimpleUrl.