Get-CsSimpleUrlConfiguration
Última modificación del tema: 2012-03-23
Devuelve información sobre las rutas de URL sencillas configuradas en una organización. Las direcciones URL sencillas les simplifican a los usuarios la tarea de unirse a reuniones y conferencias; y también permiten que los administradores inicien sesión en Panel de control de Microsoft Lync Server 2010 con mayor facilidad.
Sintaxis
Get-CsSimpleUrlConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>] [-Tenant <Nullable>]
Get-CsSimpleUrlConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>] [-Tenant <Nullable>]
Descripción detallada
En Microsoft Office Communications Server 2007 R2, las reuniones tenían direcciones URL similares a la siguiente:
Sin embargo, dichas direcciones URL no son particularmente intuitivas y no se pueden transferir a otra persona fácilmente. Las direcciones URL sencillas escritas en Lync Server 2010 ayudan a solucionar esos problemas y proporcionan al usuario direcciones URL que son más similares a ésta:
https://meet.litwareinc.com/kenmyer/071200
Las direcciones URL sencillas son una mejora respecto de las direcciones URL que se usan en Office Communications Server. Sin embargo, las direcciones URL sencillas no se crean automáticamente, ya que usted mismo debe configurarlas. (Asimismo, usted debe crear registros de Sistemas de nombres de dominio (DNS) para cada dirección URL, configurar reglas de proxy inverso para acceso externo, agregar direcciones URL sencillas a los certificados de Servidor front-end, etc.).
Lync Server le permite generar tres direcciones URL sencillas diferentes:
Meet: se usa para reuniones. Debe tener, al menos, una Meet URL para cada uno de sus dominios SIP.
Admin: se utiliza para dirigir a los administradores hacia Panel de control de Lync Server 2010.
Dialin: se usa para la página web de conferencia de acceso telefónico local.
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 del sitio. Esto le brinda la posibilidad de usar diferentes direcciones URL sencillas en cada sitio.
El cmdlet Get-CsSimpleUrlConfiguration brinda una forma de recuperar información acerca de todas las recopilaciones de configuración de direcciones URL sencillas que están actualmente en uso en la organización.
Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Get-CsSimpleUrlConfiguration localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en roles (RBAC) que se han asignado a este cmdlet (incluidos los roles personalizados RBAC que haya creado usted), ejecute el siguiente comando en el aviso de Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-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 devolverán. Para devolver la recopilación global, use esta sintaxis: -Identity global. Para devolver una recopilación en el ámbito del sitio, use una sintaxis similar a la siguiente: -Identity "site:Redmond" Tenga en cuenta que no es posible usar comodines al especificar un parámetro Identity. Si desea usar comodines, use, en cambio, el parámetro Filter. El llamado de Get-CsSimpleUrlConfiguration sin ningún parámetro devuelve todas las direcciones URL sencillas configuradas para su uso en la organización. |
Filter |
Opcional |
Cadena de caracteres |
Permite usar caracteres comodines para especificar la recopilación (o las recopilaciones) de direcciones URL sencillas que se devolverán. Por ejemplo, esta sintaxis devuelve todas las recopilaciones de direcciones URL sencillas que se configuraron en el ámbito del sitio: -Filter "site:*". Tenga en cuenta que no se pueden usar ambos parámetros, Filter e Identity, en el mismo comando. |
Tenant |
Opcional |
Identificador único global |
Este parámetro no se usa con la versión interna de Lync Server 2010. |
LocalStore |
Opcional |
Parámetro modificador |
Recupera los datos de configuración de direcciones URL sencillas de la réplica local de Almacén de administración central, en lugar de Almacén de administración central. |
Tipos de entrada
Ninguno.
Tipos de valores devueltos
Get-CsSimpleUrlConfiguration devuelve instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.SimpleUrl.SimpleUrlConfiguration.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Get-CsSimpleUrlConfiguration
El comando anterior devuelve información acerca de todas las recopilaciones de configuración de direcciones URL sencillas que se encuentran actualmente en uso en la organización. Esto se logra mediante el llamado de Get-CsSimpleUrlConfiguration sin ningún parámetro adicional.
-------------------------- Ejemplo 2 --------------------------
Get-CsSimpleUrlConfiguration -Identity "site:Redmond"
En el Ejemplo 2, la información se devuelve para una recopilación de configuraciones de URL sencillas: la configuración con parámetro Identity es site:Redmond.
-------------------------- Ejemplo 3 --------------------------
Get-CsSimpleUrlConfiguration -Filter "site:*"
En el Ejemplo 3, se devuelve información para todas las recopilaciones de configuraciones de URL sencillas que se asignaron en el ámbito del sitio. Para llevar a cabo esta acción, se llama a Get-CsSimpleUrlConfiguration junto con el parámetro Filter; el valor de filtro "site:*" limita los datos devueltos a las recopilaciones cuyo parámetro Identity comienza con el valor de cadena "site:".
-------------------------- Ejemplo 4 --------------------------
Get-CsSimpleUrlConfiguration | Select-Object -ExpandProperty SimpleUrl
En el Ejemplo 4, se muestra información detallada para cada dirección URL sencilla configurada para su uso en la organización. Para llevar a cabo esta tarea, el comando primero llama a Get-CsSimpleUrlConfiguration para devolver un conjunto completo de información de direcciones URL sencillas. Estos datos después se redireccionan al cmdlet Select-Object, que usa el parámetro ExpandProperty para "expandir" el valor de la propiedad SimpleUrl. La expansión de un valor de propiedad muestra todos los datos almacenados en esa propiedad en un formato de fácil lectura.
-------------------------- Ejemplo 5 --------------------------
Get-CsSimpleUrlConfiguration | Select-Object -ExpandProperty SimpleUrl | Where-Object {$_.Component -eq "Meet"}
El comando que se muestra en el Ejemplo 5 devuelve todas las direcciones URL sencillas para la administración de reuniones que están actualmente en uso en la organización. Para llevar a cabo esta acción, el comando llama primero a Get-CsSimpleUrlConfiguration sin ningún parámetro adicional; esto devuelve un conjunto completo de información de direcciones URL sencillas. Estos datos después se redireccionan al cmdlet Select-Object, que usa el parámetro ExpandProperty para expandir el valor de la propiedad SimpleUrl. Esta recopilación filtrada se redirecciona a Where-Object, que elige sólo aquellas direcciones URL sencillas donde la propiedad Component es igual a "Meet".
Vea también
Otros recursos
New-CsSimpleUrlConfiguration
Remove-CsSimpleUrlConfiguration
Set-CsSimpleUrlConfiguration