Compartir a través de

  • Artículo

Get-CsWebServiceConfiguration

 

Última modificación del tema: 2012-03-23

Devuelve información acerca de todas las opciones de configuración de Servicios web en uso en la organización.

Sintaxis

Get-CsWebServiceConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsWebServiceConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]

Descripción detallada

Muchos componentes de Microsoft Lync Server 2010 están basados en web: utilizan servicios web o páginas web para llevar a cabo sus tareas. Por ejemplo, los usuarios utilizan un servicio web cuando buscan contactos nuevos en la libreta de direcciones o cuando usan la expansión de grupos para ver los miembros individuales de un grupo de distribución. Del mismo modo, los componentes, desde las conferencias de acceso telefónico hasta Panel de control de Microsoft Lync Server 2010, usan páginas web como interfaz entre Lync Server 2010 y los usuarios.

Los cmdlets CsWebServiceConfiguration permiten a los administradores controlar las opciones de configuración de Servicios web en toda la organización. Esto incluye la administración de expansión de grupos, la configuración de certificados y los métodos de autenticación permitidos. Al poder configurar diferentes opciones en los ámbitos global, de sitio y de servicio (aunque solamente con el servicio WebServer), puede personalizar las funcionalidades de Servicios web para diferentes usuarios y ubicaciones.

El cmdlet Get-CsWebServiceConfiguration permite devolver información detallada acerca de las opciones de configuración del Servicios web que se usan actualmente en la organización.

Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Get-CsWebServiceConfiguration localmente: RTCUniversalUserAdmins, 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 "Get-CsWebServiceConfiguration"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

Identificador único de las opciones de configuración de Servicios web que se devolverán. Para devolver la configuración global, use la siguiente sintaxis: -Identity global. Para devolver la configuración definida en el ámbito de sitio, use la sintaxis siguiente: -Identity "site:Redmond". Las configuraciones del ámbito de servicio pueden devolverse con una sintaxis como la siguiente: -Identity "service:WebServer:atl-cs-001.litwareinc.com".

No se pueden usar los parámetros –Identity y –Filter en el mismo comando. Si no se especifica ningún parámetro, Get-CsWebServiceConfiguration devolverá todas las colecciones de configuraciones de Servicios web que se usan actualmente en la organización.

Filter

Opcional

Cadena de caracteres

Permite usar comodines al especificar la colección (o colecciones) de configuraciones de Servicios web que se devolverán. Por ejemplo, esta sintaxis devuelve todas las configuraciones definidas en el ámbito de sitio: -Filter "site:*".

No se pueden usar los parámetros –Identity y –Filter en el mismo comando.

LocalStore

Opcional

Parámetro modificador

Recupera los datos de aviso de configuración de Servicios web a partir de una réplica local de Almacén de administración central en lugar de hacerlo directamente desde Almacén de administración central.

Tipos de entrada

Ninguno. Get-CsWebServiceConfiguration no acepta entradas transferidas.

Tipos de valores devueltos

Get-CsWebServiceConfiguration devuelve instancias del objeto Microsoft.Rtc.Management.WritableConfig.Web.WebServiceSettings.

Ejemplo

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

Get-CsWebServiceConfiguration

El comando anterior devuelve información sobre todas las opciones de configuración de Servicios web que están en uso en la organización.

-------------------------- Ejemplo 2 ------------------------

Get-CsWebServiceConfiguration -Identity site:Redmond

El comando que se muestra en el ejemplo 2 devuelve información acerca de las opciones de configuración de Servicios web que tienen Identity site:Redmond.

-------------------------- Ejemplo 3 ------------------------

Get-CsWebServiceConfiguration -Filter "site:*"

En el ejemplo 3 se devuelven todas las opciones de configuración de Servicios web que se han asignado al ámbito del sitio. Para ello, se incluye el parámetro Filter al llamar a Get-CsWebServiceConfiguration; el valor de filtro "site:*" garantiza que sólo se devuelvan aquellas configuraciones que tienen una Identidad que empieza con el valor de cadena "site:" es el resultado devuelto.

-------------------------- Ejemplo 4 ------------------------

Get-CsWebServiceConfiguration | Where-Object {$_.UsePinAuth -eq $False}

En el ejemplo 4, el comando devuelve todas las opciones de configuración de Servicios web que no permiten la autenticación de números de identificación personal (PIN). Esto se lleva a cabo llamando primero a Get-CsWebServiceConfiguration para devolver todas las opciones de configuración de Servicios web que se usan actualmente. A continuación, esta colección se transfiere al cmdlet Where-Object, que selecciona únicamente aquellas configuraciones en las que la propiedad UsePinAuth es igual a False.

-------------------------- Ejemplo 5 ------------------------

Get-CsWebServiceConfiguration | Where-Object {$_.MaxGroupSizeToExpand -gt 100}

El comando anterior devuelve todas las opciones de configuración de Servicios web en las que el tamaño de expansión del grupo máximo es superior a 100. Para ello, el comando usa primero Get-CsWebServiceConfiguration para devolver todas las opciones de configuración de Servicios web que se usan actualmente. Después, se transfiere esta información al cmdlet Where-Object, que selecciona únicamente aquellas configuraciones en las que la propiedad MaxGroupSizeToExpand es superior a 100.