Set-CsAutodiscoverConfiguration
Última modificación del tema: 2012-04-23
Modifica una recopilación existente de opciones de configuración de Detección automática. El servicio Detección automática ofrece una manera de que las aplicaciones cliente tales como Lync Web Access o Microsoft Lync Mobile localicen los recursos clave tales como el grupo de servidores principales de un usuario o la URL para participar en una conferencia de acceso telefónico local.
Sintaxis
Set-CsAutodiscoverConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WebLinks <PSListModifier>] [-WhatIf [<SwitchParameter>]]
Set-CsAutodiscoverConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WebLinks <PSListModifier>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Para que las aplicaciones cliente hagan el uso más efectivo posible de Microsoft Lync Server 2010, tienen que saber dónde se encuentran los componentes de Lync Server 2010 clave. Por ejemplo, los usuarios autenticados deben ser capaces de localizar su grupo de servidores principales; al fin y al cabo, solo les puede autenticar ese grupo de servidores principales. Asimismo, los usuarios no autenticados también tienen que poder realizar acciones tales como localizar la URL utilizada para participar en una conferencia.
Si todos sus usuarios iniciaran sesión detrás del firewall de la organización, sería bastante fácil detectar estas ubicaciones. Sin embargo, esta tarea relativamente sencilla se va complicando gradualmente a medida que los usuarios obtienen acceso al sistema desde ubicaciones externas con Microsoft Lync Mobile o con Lync Web Access.
Esto se cumple sobre todo en escenarios de dominios divididos, en los que algunos de los usuarios de una organización tienen cuentas en la versión local de Lync Server, mientras que otros tienen cuentas en Microsoft Office 365. En casos como este, las cuentas de usuario pueden estar situadas en bosques de Active Directory diferentes. Esto puede resultar problemático: por ejemplo, si un usuario situado en los EE.UU. inicia sesión desde Europa, el sistema tiene que ser capaz de reconocer el bosque del usuario y, a continuación, reenviar la solicitud de inicio de sesión al grupo adecuado.
El servicio Detección automática se introdujo en la versión de Lync Server de noviembre de 2011 para tratar estos problemas. Cuando una aplicación cliente intenta obtener acceso a Lync Server, el servicio Detección automática analiza la dirección SIP de cliente y después redirige dicha solicitud al grupo adecuado. Las aplicaciones cliente se conectan al servicio Detección automática a través del envío de una solicitud HTTP a una URL de Detección automática. Para que el servicio Detección automática funcione, es necesario que estas URL las hayan configurado los administradores. (Tenga en cuenta que, además de configurar las URL, los administradores también tienen que crear registros DNS que se correspondan a estas URL.)
Las direcciones URL de Detección automática se asignan a las opciones de configuración de Detección automática; a su vez, estas opciones se pueden aplicar al ámbito global o al ámbito de sitio. Al instalar Lync Server, se creará automáticamente una recopilación global de opciones. (Sin embargo, no se asignará ninguna URL de Detección automática a dicha recopilación.) Si una recopilación de opciones de Detección automática no satisface sus necesidades, puede usar el cmdlet New-CsAutoDiscoverConfiguration para crear opciones de configuración adicionales en el ámbito de sitio. Desde ese punto, puede usar el cmdlet Set-CsAutoDiscoverConfiguration para agregar o quitar las URL de Detección automática desde la recopilación global o desde cualquier recopilación con ámbito de sitio.
Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos están autorizados para ejecutar localmente el cmdlet Set-CsAutoDiscoverConfiguration: RTCUniversalServerAdmins.
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
Identidad XDS |
Identificador único de las opciones de configuración de la recopilación de Detección automática que se van a modificar. Para modificar en la recopilación global, use la siguiente sintaxis: -Identity "global" Para modificar una recopilación configurada en el ámbito de sitio, use una sintaxis similar a esta: -Identity "site:Redmond" Si no se especifica este parámetro, Set-CsAutoDiscoverConfiguration modificará automáticamente la configuración global. |
Instance |
Opcional |
Objeto AutoDiscoverConfiguration |
Permite enviar una referencia a un objeto al cmdlet, en lugar de definir valores de parámetro individuales. |
WebLinks |
Opcional |
Modificador de lista PS |
Recopilación de direcciones URL de Detección automática. Estas URL deben crearse usando el cmdlet New-CsWebLink. |
Force |
Opcional |
Parámetro modificador |
Suprime la visualización de los mensajes de error que no sean graves y que puedan producirse al ejecutar el comando. |
Tipos de entrada
Set-CsAutoDiscoverConfiguration acepta entradas transferidas del objeto Microsoft.Rtc.Management.WriteableConfig.Settings.AutoDiscoverConfiguration.AutoDiscoverConfiguration.
Tipos de valores devueltos
Ninguno. Set-CsAutoDiscoverConfiguration modifica instancias del objeto Microsoft.Rtc.Management.WriteableConfig.Settings.AutoDiscoverConfiguration.AutoDiscoverConfiguration.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
$Link1 = New-CsWebLink -Token "Fabrikam" -Href "http://LyncDiscover.fabrikam.com"
Set-CsAutoDiscoverConfiguration -Identity "site:Redmond" -WebLinks @{Add=$Link1}
Los comandos que se muestran en el Ejemplo 1 agregan una URL de Detección automática nueva (http://LyncDiscover.fabrikam.com) a las opciones de configuración de Detección automática que están asignadas al sitio de Redmond. Para ello, el primer comando del ejemplo usa el cmdlet New-CsWebLink para crear una URL de Detección automática; esa URL se almacena en una variable denominada $Link1. En el segundo comando, Set-CsAutoDiscoverConfiguration se usa para agregar la URL nueva a cualquier URL que ya esté asignada a esta configuración. Esto se realiza mediante el parámetro WebLinks y el valor de parámetro @{Add=$Link1}.
-------------------------- Ejemplo 2 --------------------------
$Link1 = Get-CsAutoDiscoverConfiguration -Identity "site:Redmond" | Select-Object -ExpandProperty WebLinks | Where-Object {$_.Token -eq "Fabrikam"}
Set-CsAutoDiscoverConfiguration -Identity "site:Redmond" -WebLinks @{Remove=$Link1}
Con los comandos anteriores se muestra cómo puede quitar una URL de una recopilación de opciones de configuración de Detección automática. Para ello, el primer comando de la recopilación recupera una referencia de objeto en la URL que se va a quitar (una URL que tiene un símbolo [token] igual a "Fabrikam"). Esto se hace llamando primero al cmdlet Get-CsAutoDiscoverConfiguration para recuperar las opciones de Detección automática del sitio de Redmond. Dicha recopilación se transmite a continuación al cmdlet Select-Object, que usa el parámetro ExpandProperty para "ampliar" la propiedad WebLinks. (Cuando se amplía una propiedad, Get-CsAutoDiscoverConfiguration obtiene acceso a los objetos concretos almacenados en la propiedad.) Estos objetos WebLinks se transmiten a continuación al cmdlet Where-Object, que selecciona el único objeto en el que la propiedad Token es igual a "Fabrikam". Dicho objeto WebLinks se almacena después en una variable denominada $Link1.
Después de eso, el segundo comando del ejemplo utiliza Set-CsAutoDiscoverConfiguration para quitar el objeto almacenado en $Link1. Para ello, el comando usa el parámetro WebLinks y el valor de parámetro @{Remove=$Link1}.
-------------------------- Ejemplo 3 --------------------------
$Link2 = New-CsWebLink -Token "Contoso" -Href "http://LyncDiscover.contoso.com"
Set-CsAutoDiscoverConfiguration -Identity "site:Redmond" -WebLinks @{Replace=$Link2}
En el Ejemplo 3 se muestra cómo puede sustituir una recopilación existente de URL de Detección automática con, en este caso, una sola URL. Para llevar a cabo esta tarea, el primer comando del ejemplo utiliza el cmdlet New-CsWebLink para crear una URL de Detección automática nueva para http://LyncDiscover.contoso.com; y la URL que se obtiene se almacena en una variable denominada $Link2. A continuación, el segundo comando usa Set-CsAutoDiscoverConfiguration y el parámetro WebLinks para quitar cualquier URL que antes estuviera asignada al sitio de Redmond y sustituirla por la URL para http://LyncDiscover.contoso.com. Para ello, el comando usa el método Replace en vez del Add o del Remove.
-------------------------- Ejemplo 4 --------------------------
Set-CsAutoDiscoverConfiguration -Identity "site:Redmond" -WebLinks $Null
El comando que se muestra en el Ejemplo 4 quita todas las URL de Detección automática que se han asignado al sitio de Redmond. Para ello, el comando define la propiedad WebLinks en un valor nulo; a su vez, esto elimina cualquier URL que se hubiera asignado antes a esa propiedad.