Get-CsAutodiscoverConfiguration
Última modificación del tema: 2012-04-23
Devuelve información sobre las opciones de configuración de Detección automática que actualmente se usan en una organización. El servicio Detección automática ofrece una forma 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
Get-CsAutodiscoverConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsAutodiscoverConfiguration [-Filter <String>] [-LocalStore <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. El cmdlet Get-CsAutoDiscoverConfiguration ofrece una manera de devolver información sobre la configuración de Detección automática (y las URL de Detección automática) que está actualmente en uso en la organización.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Get-CsAutoDiscoverConfiguration de forma local: RTCUniversalServerAdmins.
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
Identidad XDS |
Identificador único de la recopilación de opciones de configuración de Detección automática que se va a recuperar. Para recuperar la configuración global, use esta sintaxis: -Identity "global" Para recuperar las opciones configuradas en el ámbito de sitio, use una sintaxis similar a esta: -Identity "site:Redmond" Si no se incluye este parámetro, Get-CsAutoDiscoverConfiguration devolverá toda la configuración de Detección automática que esté en uso en la organización. |
Filter |
Opcional |
Cadena de caracteres |
Permite usar caracteres comodín al especificar la identidad de las opciones de configuración de Detección automática que se van a devolver. Por ejemplo, usando esta sintaxis se devuelven todas las opciones del ámbito de sitio: -Filter "site:*" Tenga en cuenta que no es posible usar los parámetros Identity y Filter en el mismo comando. |
LocalStore |
Opcional |
Parámetro modificador |
Recupera los datos de la configuración de Detección automática desde la réplica local del Almacén de administración central, en lugar del almacén en sí. |
Tipos de entrada
Get-CsAutoDiscoverConfiguration no acepta entradas canalizadas.
Tipos de valores devueltos
Get-CsAutoDiscoverConfiguration devuelve instancias del objeto Microsoft.Rtc.Management.WriteableConfig.Settings.AutoDiscoverConfiguration.AutoDiscoverConfiguration.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Get-CsAutoDiscoverConfiguration
El comando del Ejemplo 1 devuelve todas las opciones de configuración de Detección automática en uso en la organización.
-------------------------- Ejemplo 2 --------------------------
Get-CsAutoDiscoverConfiguration -Identity "global"
En el Ejemplo 2, solo se devuelve una recopilación de opciones de configuración de Detección automática: la recopilación global.
-------------------------- Ejemplo 3 --------------------------
Get-CsAutoDiscoverConfiguration -Filter "site:*"
El comando anterior devuelve todas las opciones de configuración de Detección automática asignadas al ámbito de sitio. Para ello, se incluye el parámetro Filter junto con el valor de filtro "site:*"; este valor de filtro garantiza que la única configuración que se devuelva sea la que tenga una identidad que comience por el valor de cadena de caracteres "site:". Por definición, cualquier configuración que tenga una identidad que empiece por "site:" es una configuración definida en el ámbito de sitio.
-------------------------- Ejemplo 4 --------------------------
Get-CsAutoDiscoverConfiguration | Where-Object {$_.WebLinks -like "*fabrikam.com"}
El comando que se muestra en el Ejemplo 4 devuelve todas las opciones de configuración de Detección automática que incluyan una URL de Detección automática de fabrikam.com. Para realizar esta tarea, el comando primero llama a Get-CsAutoDiscoverConfiguration para devolver una recopilación de todas las opciones de Detección automática que estén en uso en la organización.