Condividi tramite


Get-CsSimpleUrlConfiguration

 

Ultima modifica dell'argomento: 2012-03-23

Restituisce informazioni sugli URL semplici configurati per l'utilizzo nell'organizzazione. 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

Get-CsSimpleUrlConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>] [-Tenant <Nullable>]

Get-CsSimpleUrlConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>] [-Tenant <Nullable>]

Descrizione dettagliata

In Microsoft Office Communications Server 2007 R2, per le riunioni si utilizzavano URL simili al seguente:

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

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.

Il cmdlet Get-CsSimpleUrlConfiguration consente di recuperare le informazioni su tutte le raccolte di configurazioni degli URL semplificati attualmente in uso nell'organizzazione.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Get-CsSimpleUrlConfiguration può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalUserAdmins, 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 "Get-CsSimpleUrlConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

XdsIdentity

Identificatore univoco della raccolta di URL semplificati da ottenere. Per ottenere la raccolta globale, utilizzare la seguente sintassi: -Identity global. Per ottenere una raccolta nell'ambito del sito, utilizzare una sintassi simile alla seguente: -Identity "site:Redmond." Si noti che non è consentito utilizzare i caratteri jolly per specificare l'identità. Se si desidera utilizzare i caratteri jolly, utilizzare invece il parametro Filter.

Se si utilizza il cmdlet Get-CsSimpleUrlConfiguration senza alcun parametro, vengono restituiti tutti gli URL semplificati configurati per l'utilizzo nell'organizzazione.

Filter

Facoltativo

Stringa

Consente di utilizzare i caratteri jolly per rendere più specifiche le raccolte di URL semplificati che si otterranno. Ad esempio, la seguente sintassi restituisce tutte le raccolte di URL semplificati configurate nell'ambito del sito: -Filter "site:*".

Si noti che non è possibile utilizzare entrambi i parametri Filter e Identity nello stesso comando.

Tenant

Facoltativo

Guid

Questo parametro non viene utilizzato con la versione locale di Lync Server 2010.

LocalStore

Facoltativo

Parametro opzionale

Consente di recuperare i dati di configurazione degli URL semplificati dalla copia locale di archivio di gestione centrale invece che da archivio di gestione centrale.

Tipi di input

Nessuno.

Tipi restituiti

Get-CsSimpleUrlConfiguration restituisce le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.SimpleUrl.SimpleUrlConfiguration.

Esempio

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

Get-CsSimpleUrlConfiguration

Il comando precedente consente di ottenere le informazioni su tutte le raccolte di configurazioni degli URL semplificati attualmente in uso nell'organizzazione. Per ottenere questo risultato, viene utilizzato il cmdlet Get-CsSimpleUrlConfiguration senza parametri aggiuntivi.

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

Get-CsSimpleUrlConfiguration -Identity "site:Redmond"

Nell'Esempio 2, vengono restituite informazioni inerenti una singola raccolta di configurazioni degli URL semplificati: la configurazione per Identity site:Redmond.

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

Get-CsSimpleUrlConfiguration -Filter "site:*"

L'Esempio 3 restituisce le informazioni su tutte le raccolte di configurazioni degli URL semplificati che sono state assegnate all'ambito del sito. Per ottenere questo risultato, viene utilizzato il cmdlet Get-CsSimpleUrlConfiguration insieme al parametro Filter; il valore del filtro "site:*" restituisce solo i dati relativi alle raccolte la cui identità inizia con "site:".

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

Get-CsSimpleUrlConfiguration | Select-Object -ExpandProperty SimpleUrl

Nell'Esempio 4, vengono visualizzate informazioni dettagliate su ciascun URL semplificato configurato per l'utilizzo nell'organizzazione. Per ottenere questo risultato, il comando utilizza il cmdlet Get-CsSimpleUrlConfiguration per ottenere una serie completa di informazioni sugli URL semplificati. Questi dati vengono quindi inviati tramite pipe al cmdlet Select-Object che utilizza il parametro ExpandProperty per "espandere" il valore della proprietà SimpleUrl. Espandendo il valore di una proprietà è possibile visualizzare tutte le informazioni archiviate in quella proprietà in un formato di facile lettura.

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

Get-CsSimpleUrlConfiguration | Select-Object -ExpandProperty SimpleUrl | Where-Object {$_.Component -eq "Meet"}

Il comando riportato nell'Esempio 5 consente di ottenere tutti gli URL semplificati per la gestione delle riunioni attualmente utilizzati nell'organizzazione. Per ottenere questo risultato, il comando utilizza il cmdlet Get-CsSimpleUrlConfiguration senza alcun parametro aggiuntivo; viene restituita una serie completa di informazioni sugli URL semplificati. Questi dati vengono quindi inviati tramite pipe al cmdlet Select-Object che utilizza il parametro ExpandProperty per "espandere" il valore della proprietà SimpleUrl. Questa raccolta filtrata viene quindi inviata tramite pipe al cmdlet Where-Object che seleziona solo quegli URL semplificati nei quali la proprietà Component è uguale a Meet.