Compartir a través de


New-CsSimpleUrlConfiguration

 

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

Crea una nueva colección de configuraciones de URL sencillas. Las direcciones URL sencillas permiten a los usuarios unirse a reuniones y conferencias. También permiten que a los administradores les resulte más fácil iniciar sesión en Panel de control de Microsoft Lync Server 2010.

Sintaxis

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

Descripción detallada

En Microsoft Office Communications Server 2007 R2, las reuniones tienen direcciones URL parecidas a las siguientes:

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

Sin embargo, estas direcciones URL no resultan especialmente intuitivas ni son fáciles de intercambiar con otros usuarios. Las direcciones URL sencillas que se han integrado en Lync Server 2010 ayudan a solucionar esos problemas en tanto se proporcionan al usuario direcciones URL con un aspecto similar al siguiente:

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

Las direcciones URL sencillas constituyen una mejora con respecto a las usadas en Office Communications Server. Sin embargo, no se crean automáticamente, sino que será necesario configurarlas. Además, deberá llevar a cabo otras acciones como, entre otras, crear registros de Sistema de nombres de dominio (DNS) para cada dirección URL, configurar reglas de proxy inverso para el acceso externo, agregar direcciones URL sencillas a los certificados de Servidor front-end.

Lync Server permite crear tres tipos de direcciones URL sencillas:

Meet: se usa para reuniones en línea. Debe tener al menos una URL de reunión para cada uno de sus dominios SIP.

Admin: se utiliza para señalar el Panel de control de Lync Server 2010 a los administradores.

Dialin: se usa para la página web de conferencia de acceso telefónico.

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

Las colecciones de configuraciones de direcciones URL sencillas se crean con el cmdlet New-CsSimpleUrlConfiguration; puede usar otros cmdlets, como New-CsSimpleUrl y Set-CsSimpleUrlConfiguration, para rellenar las configuraciones con direcciones URL sencillas. Después de actualizar una colección de direcciones URL sencillas es necesario ejecutar el cmdlet Enable-CsComputer.

Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet New-CsSimpleUrlConfiguration localmente: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en rol (RBAC), este rol se ha asignado (así como cualquier otro rol RBAC personalizado que haya creado) para ejecutar el siguiente comando desde el símbolo del sistema Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Identidad Xds

Identificador único para la nueva colección de configuraciones de URL sencilla. Como las colecciones nuevas solo se pueden crear en el ámbito de sitio, Identity debe componerse del prefijo "site:" seguido del nombre del sitio. Por ejemplo, esta sintaxis crea una colección nueva para el sitio Redmond: -Identity "site:Redmond".

SimpleUrl

Opcional

Modificador de lista PS

Las URL sencillas que se han configurado para esta colección. Estas direcciones URL deben crearse usando los cmdlets New-SimpleUrl y New-SimpleUrlEntry.

InMemory

Opcional

Parámetro modificador

Crea una referencia de objeto sin confirmar realmente el objeto como cambio permanente. Si se asigna la salida de este cmdlet llamado con este parámetro en una variable, puede realizar cambios en las propiedades de la referencia del objeto y después confirmar estos cambios, llamando a este conjunto coincidente de cmdlet, - cmdlet.

Force

Opcional

Parámetro modificador

Suprime la visualización de los mensajes de error que no son graves y que pueden surgir al ejecutar el comando.

Tenant

Opcional

Identificador único global

Este parámetro no se usa con las implementaciones locales de Lync Server.

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

Ninguno.

Tipos de valores devueltos

New-CsSimpleUrlConfiguration crea nuevas instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.SimpleUrl.SimpleUrlConfiguration.

Ejemplo

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

New-CsSimpleUrlConfiguration -Identity "site:Redmond"

El comando que se muestra en el ejemplo 1 crea una nueva colección de URL sencillas para el sitio Redmond. Como con este comando no se incluye ningún parámetro (aparte de Identity), la nueva colección no contendrá ninguna URL sencilla. Este comando dará error si el sitio Redmond ya hospeda una colección de URL sencillas.

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

En el ejemplo anterior se muestra cómo se puede crear una nueva colección de URL sencillas que incluya dos direcciones URL sencillas (una para la administración de reuniones y otra para las conferencias de acceso telefónico). Para ello, el primer comando en el ejemplo usa New-CsSimpleUrlEntry a fin de crear una entrada de URL que apunte a https://dialin.litwareinc.com. Esta entrada de URL se almacena en una variable llamada $urlEntry. A continuación, el segundo comando crea una segunda entrada de URL, que apunta a la dirección URL https://meet.fabrikam.com.

A continuación, se usa el cmdlet New-CsSimpleUrl para crear una instancia en memoria de una dirección URL sencilla. En este ejemplo, el componente URL se establece en dialin, el dominio se establece en un asterisco (*), la propiedad ActiveUrl se establece en https://dialin.fabrikam.com y la propiedad SimpleUrl se establece en $urlEntry ($urlEntry representa la entrada de URL creada en el primer comando). Tras ello, se usa un comando parecido para crear una dirección URL sencilla para meet.fabrikam.com.

Una vez que las direcciones URL se han creado (y almacenado en las referencias de objeto $simpleUrl y $simpleUrl2), el último comando del ejemplo crea una nueva colección de direcciones URL sencillas para el sitio Redmond y agrega las dos nuevas URl de solo en memoria a dicha colección. Las nuevas direcciones URL se agregan a la colección por medio del cmdlet New-CsSimpleUrlConfiguration, el parámetro SimpleUrl y el valor de parámetro @{Add=$simpleUrl, $simpleUrl2}. Esta sintaxis hace que las direcciones URL almacenadas en las referencias del objeto $simpleUrl y $simpleUrl2 se agreguen a la propiedad SimpleUrl.