Compartir a través de

  • Artículo

Set-CsSimpleUrlConfiguration

 

Última modificación del tema: 2012-10-17

Modifica una recopilación de configuraciones de URL sencillas. Las direcciones URL sencillas permiten a los usuarios unirse a reuniones y conferencias de manera más fácil; y también permiten a los administradores iniciar sesión en el Panel de control de Microsoft Lync Server 2010.

Sintaxis

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>]]

Descripción detallada

En Microsoft Office Communications Server 2007 R2, las reuniones tenían URL como la siguiente:

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

Sin embargo, estas URL no son especialmente intuitivas, y no son fáciles de transmitir a otra persona. Las nuevas direcciones URL sencillas de Lync Server 2010 evitan estos problemas al ofrecer a los usuarios una dirección con un aspecto similar a este:

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

Las direcciones URL sencillas son una gran mejora con respecto a las que se usaban en versiones anteriores de Office Communications Server. Aunque no se crean automáticamente: es necesario configurarlas. También puede, por ejemplo, crear registros del Sistema de nombres de dominio (DNS) para cada URL; configurar reglas de proxy inverso para el acceso externo; agregar las URL sencillas a sus certificados de Servidor front-end, etc.

Lync Server permite crear tres URL sencillas diferentes:

Meet: para reuniones. Debe haber al menos una dirección URL de tipo Meet para cada dominio SIP.

Admin: para dirigir a los administradores a Panel de control de Lync Server 2010.

Dialin: para la página web de conferencias de acceso telefónico.

Las direcciones URL sencillas se almacenan en recopilaciones de configuraciones de direcciones URL sencillas. Al instalar Lync Server, se crea una recopilación global automáticamente; también puede crear recopilaciones personalizadas en el ámbito de sitio. De este modo puede usar diferentes direcciones URL sencillas en cada sitio.

Las recopilaciones de configuraciones de direcciones URL sencillas se crean con el cmdlet New-CsSimpleUrlConfiguration; a continuación puede usar otros cmdlets, como New-CsSimpleUrl y Set-CsSimpleUrlConfiguration, para rellenar las configuraciones con direcciones URL sencillas. Una vez creadas las recopilaciones, Set-CsSimpleUrlConfiguration también permite modificar las direcciones URL almacenadas en dichas recopilaciones.

Agregar una URL sencilla a una colección es bastante fácil. Para empezar, se usan New-CsSimpleUrl y New-CsSimpleUrlEntry para crear una dirección URL en memoria. A continuación se usa el comando Add para agregar la dirección URL a la recopilación. También puede usar el método Replace para reemplazar todas las direcciones URL por la nueva.

Quitar una dirección URL de una recopilación es un proceso algo más complicado: es necesario crear una referencia a objeto a la dirección URL (una copia de la dirección), y usarla con el método Remove para eliminar la dirección URL.

Después de actualizar una recopilación de direcciones URL sencillas, es necesario ejecutar el cmdlet Enable-CsComputer.

Quién puede ejecutar este cmdlet: de forma predeterminada, están autorizados para ejecutar el cmdlet Set-CsSimpleUrlConfiguration localmente los miembros de los siguientes grupos: RTCUniversalServerAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC) a los que se ha asignado este cmdlet (incluidos los roles de RBAC personalizados que haya creado), ejecute el siguiente comando en el símbolo del sistema de Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

Identificador único de la recopilación de direcciones URL sencillas que se va a modificar. Para modificar la recopilación global, use esta sintaxis: -Identity global. Para modificar una recopilación del ámbito de sitio, use una sintaxis similar a ésta: -Identity "site:Redmond".

Si este parámetro no se especifica, se modificará la recopilación global.

Instance

Opcional

Objeto SimpleUrlConfiguration

Permite enviar una referencia a un objeto al cmdlet, en lugar de definir valores de parámetros individuales.

SimpleUrl

Opcional

Modificador de lista PS

Direcciones URL sencillas configuradas en esta recopilación. Estas direcciones URL deben crearse usando los cmdlets New-SimpleUrl y New-SimpleUrlEntry.

Force

Opcional

Parámetro modificador

Suprime la visualización de los mensajes de error que no sean irrecuperables y que puedan surgir al ejecutar el comando.

Tenant

Opcional

Identificador único global

Este parámetro no se usa en la versión local de Lync Server 2010.

WhatIf

Opcional

Parámetro modificador

Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente.

Confirm

Opcional

Parámetro modificador

Solicita confirmación antes de ejecutar el comando.

Tipos de entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.SimpleUrl.SimpleUrlConfiguration. Set-CsSimpleUrlConfiguration acepta instancias por canalización del objeto de configuración de URL sencillas.

Tipos de valores devueltos

Ninguno.

Ejemplo

-------------------------- Ejemplo 1 ------------------------

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

El comando del Ejemplo 1 quita todas las direcciones URL sencillas del sitio Redmond, pero no quita la recopilación real de direcciones URL sencillas. (La recopilación se mantendrá, pero no contendrá ninguna dirección URL.) Para ello, el comando usa el parámetro SimpleUrl y lo define como valor nulo ($Null). De este modo, se quitan todas las direcciones URL sencillas de la recopilación.

-------------------------- Ejemplo 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}

El ejemplo anterior muestra cómo agregar una dirección URL a una recopilación de direcciones URL sencillas. Para empezar, el primer comando del ejemplo usa New-CsSimpleUrlEntry para crear una entrada de URL que hace referencia a https://meet.fabrikam.com; esta entrada de URL se almacena en una variable llamada $urlEntry.

En el segundo comando, se usa New-CsSimpleUrl para crear una instancia en memoria de una URL sencilla. En este ejemplo, el Componente URL se define como Meet; el dominio se define como fabrikam.com; el parámetro ActiveUrl se define como https://meet.fabrikam.com y la propiedad SimpleUrl se define como $urlEntry, donde $urlEntry es la entrada de URL creada en el primer comando.

Después de haber creado la URL (y de haberla almacenado en la referencia del objeto $simpleUrl), el comando final del ejemplo agrega la nueva URL a la colección de URL sencillas para el sitio Redmond. Para ello, se usa el cmdlet Set-CsSimpleUrlConfiguration, el parámetro SimpleUrl y el valor de parámetro @{Add=$simpleUrl}. Esta sintaxis hace que la URL almacenada en la referencia del objeto $simpleUrl se agregue a la propiedad SimpleUrl.

-------------------------- Ejemplo 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}

Los comandos del Ejemplo 3 muestran cómo eliminar una única dirección URL de una recopilación de direcciones URL sencillas. Set-CsSimpleUrlConfiguration solo funciona con objetos URL, por eso el ejemplo comienza con la creación de un objeto que contiene los mismos valores de propiedades que la dirección URL que se eliminará. Para ello, el primer comando usa New-CsSimpleUrlEntry para crear una entrada de URL que hace referencia a https://meet.fabrikam.com; esta entrada de URL se almacena en una variable llamada $urlEntry.

Una vez creada la entrada URL, el segundo comando usa New-CsSimpleUrl para crear una instancia en memoria de una dirección URL sencilla. En este ejemplo, el Componente URL se define como Meet; el dominio se define como fabrikam.com; el parámetro ActiveUrl se define como https://meet.fabrikam.com y la propiedad SimpleUrl se define como $urlEntry, donde $urlEntry es la entrada de URL creada en el primer comando. De este modo se crea una dirección URL en memoria ($simpleUrl) con los mismos valores de propiedades que la dirección URL que se eliminará.

El último comando del ejemplo elimina la dirección URL de la recopilación de direcciones URL sencillas del sitio Redmond. Para ello, se usa el cmdlet Set-CsSimpleUrlConfiguration, el parámetro SimpleUrl y el valor de parámetro @{Remove=$simpleUrl}. La sintaxis hace que la dirección URL almacenada en la referencia a objeto $simpleUrl se quite de la propiedad SimpleUrl.