Set-CsWebServer
Última modificación del tema: 2012-03-25
Modifica uno o más de los servicios del servidor web que utiliza Microsoft Lync Server 2010.
Sintaxis
Set-CsWebServer [-Identity <XdsGlobalRelativeIdentity>] [-AppSharingPortCount <UInt16>] [-AppSharingPortStart <UInt16>] [-Confirm [<SwitchParameter>]] [-ExternalFqdn <Fqdn>] [-ExternalHttpPort <UInt16>] [-ExternalHttpsPort <UInt16>] [-Force <SwitchParameter>] [-InternalFqdn <Fqdn>] [-McxSipExternalListeningPort <UInt16>] [-McxSipPrimaryListeningPort <UInt16>] [-PrimaryHttpPort <UInt16>] [-PrimaryHttpsPort <UInt16>] [-PublishedExternalHttpPort <UInt16>] [-PublishedExternalHttpsPort <UInt16>] [-PublishedPrimaryHttpPort <UInt16>] [-PublishedPrimaryHttpsPort <UInt16>] [-ReachExternalPsomServerPort <UInt16>] [-ReachPrimaryPsomServerPort <UInt16>] [-UserServer <String>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Lync Server 2010 utiliza servidores web y servicios web para muchas de sus funciones. Por ejemplo, las consultas de la Libreta de direcciones se pueden realizar utilizando servicios web (el servicio de consultas web de la libreta de direcciones). Lync Server también hospeda páginas web con las que los usuarios podrán realizar operaciones como configurar su número de identificación personal (PIN) para las conferencias de acceso telefónico. Si tenemos en cuenta la gran importancia de los servidores web y servicios web, es esencial que los administradores sepan cómo configurar estos servidores y servicios. Esta información se puede devolver mediante el siguiente comando:
Get-CsService –WebServer
También hay veces en las que es crucial que los administradores puedan cambiar la configuración de sus servidores web. Por ejemplo, podría necesitar modificar el puerto utilizado para las conexiones HTTP o HTTPS externas. Cambios de puerto como estos (entre otras modificaciones) se pueden realizar mediante el cmdlet Set-CsWebServer.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Set-CsWebServer de forma local: RTCUniversalServerAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC) a los que se ha asignado este cmdlet (incluido cualquier otro rol RBAC personalizado que usted mismo haya creado), ejecute el siguiente comando desde Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsWebServer"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
Identidad Xds |
Identificador único del grupo de servicios web. Por ejemplo: -Identity "WebServer:atl-cs-001.litwareinc.com". Tenga en cuenta que no es necesario utilizar el prefijo "WebServer:" cuando se especifica un servidor web. Por ejemplo: -Identity "atl-cs-001.litwareinc.com". |
AppSharingPortCount |
Opcional |
Entero |
Cantidad total de puertos asignados para compartir aplicaciones. Los puertos que se abrirán en la práctica comenzarán en el valor configurado en AppSharingPortStart y continuarán hasta la cantidad especificada en AppSharingPortCount. Por ejemplo, si se establece que el valor de AppSharingPortStart es 60000 y el de AppSharingPortCount es 100, se usarán los puertos del 60000 al 60099 para compartir aplicaciones. El valor predeterminado es 16383. |
AppSharingPortStart |
Opcional |
Entero |
Primer puerto del intervalo de puertos asignados para compartir aplicaciones. El valor predeterminado es 49152. |
ExternalFqdn |
Opcional |
Cadena de caracteres |
Nombre de dominio completo (FQDN) que utilizan las personas que se conectan al grupo de servicios web desde fuera de la red interna. Por ejemplo: -ExternalFqdn "www.litwareinc.com". |
ExternalHttpPort |
Opcional |
Entero |
Número de puerto para las conexiones web externas realizadas mediante el protocolo HTTP. El valor predeterminado es el puerto 8080. |
ExternalHttpsPort |
Opcional |
Entero |
Número de puerto para las conexiones web externas realizadas mediante el protocolo HTTPS. El valor predeterminado es el puerto 4443. |
InternalFqdn |
Opcional |
Cadena de caracteres |
Nombre de dominio completo de los servicios de movilidad. Solo se debe poder obtener acceso a InternalFqdn desde dentro del firewall de la organización. |
McxSipExternalListeningPort |
Opcional |
Entero |
Puerto de escucha externo del servicio de movilidad. |
McxSipPrimaryListeningPort |
Opcional |
Entero |
Puerto de escucha interno del servicio de movilidad. |
PrimaryHttpPort |
Opcional |
Entero |
Número de puerto para las conexiones web internas realizadas mediante el protocolo HTTP. El valor predeterminado es el puerto 80. |
PrimaryHttpsPort |
Opcional |
Entero |
Número de puerto para las conexiones web internas realizadas mediante el protocolo HTTPS. El valor predeterminado es el puerto 443. |
PublishedExternalHttpsPort |
Opcional |
Entero |
Puerto externo del servicio de movilidad |
PublishedPrimaryHttpsPort |
Opcional |
Entero |
Puerto interno del servicio de movilidad. |
ReachExternalPsomServerPort |
Opcional |
Entero |
Número de puerto externo para el protocolo de Modelo de objetos compartidos persistentes, un protocolo de Microsoft que se usa para las conferencias. El número de puerto predeterminado es 8061. |
ReachPrimaryPsomServerPort |
Opcional |
Entero |
Número de puerto primario para el protocolo de Modelo de objetos compartidos persistentes (PSOM), un protocolo de Microsoft que se usa para las conferencias. El número de puerto predeterminado es 8060. |
UserServer |
Opcional |
Cadena de caracteres |
Id. de servicio del grupo de servicios de usuario asociado al grupo de servicios web. Por ejemplo: -UserServer "UserServer:atl-cs-001.litwareinc.com". |
Force |
Opcional |
Parámetro modificador |
Suprime la visualización de los mensajes de error que no sean graves y que puedan surgir al ejecutar el comando. |
WhatIf |
Opcional |
Parámetro modificador |
Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente. |
Confirm |
Opcional |
Parámetro modificador |
Solicita confirmación antes de ejecutar el comando. |
Tipos de entrada
Ninguno. Set-CsWebServer no acepta los datos transferidos.
Tipos de valores devueltos
Ninguno. En lugar de eso, Set-CsWebServer modifica instancias del objeto Microsoft.Rtc.Management.Xds.DisplayWebServer.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
Set-CsWebServer -Identity "WebServer:atl-cs-001.litwareinc.com" -PrimaryHttpPort 89
El comando que se muestra en el Ejemplo 1 cambia el PrimaryHttpPort de un solo grupo de servicios web: el grupo con Identidad WebServer:atl-cs-001.litwareinc.com. En este ejemplo, se cambia el puerto al número de puerto 89.
-------------------------- Ejemplo 2 ------------------------
Get-CsService -WebServer | ForEach-Object {Set-CsWebServer -Identity $_.Identity -PrimaryHttpPort 89}
El comando que se muestra en el Ejemplo 2 es una variación del descrito en el Ejemplo 1; en este caso, el PrimaryHttpPort se modifica en todos los grupos de servicios web de la organización. Para hacerlo, el comando usa primero Get-CsService y el parámetro WebServer para devolver una colección de todos los grupos de servicios web que se usan actualmente. A continuación, se transfiere esta colección al cmdlet ForEach-Object, que cambia el PrimaryHttpPort al puerto 89 en cada grupo de la colección. Los datos deben transferirse a ForEach-Object porque el cmdlet Set-CsWebServer no puede aceptar por sí mismo datos canalizados.