Get-CsAccessEdgeConfiguration
Última modificación del tema: 2012-03-23
Devuelve información sobre las opciones de configuración para equipos que ejecutan el Servicio perimetral de acceso en la organización (también conocidos como servidores perimetrales de acceso). Los servidores perimetrales de acceso le proporcionan a los usuarios fuera de la red interna una manera de comunicarse con los usuarios dentro de la red interna.
Sintaxis
Get-CsAccessEdgeConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsAccessEdgeConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
Descripción detallada
Los servidores perimetrales de acceso (también conocidos como servidores proxy de acceso) le proporcionan una manera de extender las capacidades de Microsoft Lync Server 2010 a personas que no han iniciado sesión en su red interna. Por ejemplo, si tiene usuarios remotos, es decir, usuarios autenticados que inician sesión en Lync Server 2010 por Internet en lugar de la red interna, necesitará configurar un servidor perimetral de acceso. Además, los servidores perimetrales son necesarios si desea establecer una federación con otra organización o si desea brindar a sus usuarios el derecho de comunicarse con personas que tienen cuentas con un servicio de mensajería instantánea pública como Yahoo!, AOL o MSN. Los servidores perimetrales de acceso se ubican en la red perimetral y se usan para realizar y validar conexiones SIP entre usuarios dentro y fuera de su red interna.
En Lync Server, los servidores perimetrales de acceso se administran mediante una única recopilación global de opciones de configuración. El cmdlet Get-CsAccessEdgeConfiguration le permite devolver información sobre estas configuraciones globales. Recuerde que los valores de propiedades devueltos por Get-CsAccessEdgeConfiguration variarán según el tipo de enrutamiento que ha configurado en sus servidores perimetrales. Si necesita información detallada, consulte el tema de ayuda Set-CsAccessEdgeConfiguration.
Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Get-CsAccessEdgeConfiguration 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-CsAccessEdgeConfiguration"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
Identidad Xds |
Identificador único de las opciones de configuración perimetral de acceso que se devolverán. Debido a que solo puede tener una instancia única y global de estas configuraciones, no debe incluir la identidad al llamar a Get-CsAccessEdgeConfiguration. Sin embargo, puede usar la siguiente sintaxis para recuperar las opciones de configuración globales: -Identity global. |
Filter |
Opcional |
Cadena de caracteres |
Lo habilita a usar comodines al especificar las opciones de configuración perimetral de acceso que se devolverán. Debido a que solo puede tener una instancia única y global de estas configuraciones, no existe motivo suficiente para usar el parámetro Filter. Sin embargo, si lo prefiere, puede usar una sintaxis similar a la siguiente para recuperar las configuraciones globales: -Identity "g*". |
LocalStore |
Opcional |
Parámetro modificador |
Recupera los datos de configuración perimetral de acceso desde la réplica local de Almacén de administración central, en lugar de Almacén de administración central en sí. |
Tipos de entrada
Ninguno. Get-CsAccessEdgeConfiguration no acepta entradas canalizadas.
Tipos de valores devueltos
Get-CsAccessEdgeConfiguration devuelve instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayAccessEdgeSettingsDnsSrvRouting o del objeto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayAccessEdgeSettingsDefaultRoute.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Get-CsAccessEdgeConfiguration
En el Ejemplo 1 se demuestra el uso básico de Get-CsAccessEdgeConfiguration: la llamada al cmdlet sin parámetros adicionales devuelve todos los valores de propiedades de su implementación de servidor perimetral de acceso. Recuerde que no hay necesidad de incluir los parámetros Identity o Filter; eso se debe a que existe solo un conjunto de datos de configuración de servidor perimetral de acceso.
-------------------------- Ejemplo 2 --------------------------
Get-CsAccessEdgeConfiguration | Select-Object Allow*
El comando anterior solo devuelve tres valores de propiedades de su configuración de servidor perimetral de acceso: AllowAnonymousUsers; AllowFederatedUsers; y AllowOutsideUsers. Para ello, el comando primero usa Get-CsAccessEdgeConfiguration para devolver todos los valores de propiedad de servidor perimetral de acceso. Esta información después se canaliza al cmdlet Select-Object, que elige solo aquellas propiedades que comienzan con el valor de cadena "Allow". A su vez, esos son los únicos valores de propiedades que se muestran en pantalla.
-------------------------- Ejemplo 3 --------------------------
(Get-CsAccessEdgeConfiguration).EnablePartnerDiscovery
El comando que se muestra en el Ejemplo 3 devuelve el valor de una única propiedad de configuración del servidor perimetral de acceso: EnablePartnerDiscovery. Para ello, primero se llama a Get-CsAccessEdgeConfigurationa fin de devolver todos los valores de propiedades de configuración del servidor perimetral de acceso. La llamada a Get-CsAccessEdgeConfiguration se cierra entre paréntesis; de este modo, se asegura que Windows PowerShell complete este comando antes de hacer cualquier otra cosa. Después de que se han devuelto todos los valores de las propiedades, se usa "dot notation" (el nombre del objeto seguido de un punto seguido de un nombre de propiedad) para mostrar el valor de una única propiedad: EnablePartnerDiscovery.