Set-CsWebServiceConfiguration
Última modificación del tema: 2012-04-23
Modifica una recopilación de parámetros de configuración del Servicios web.
Sintaxis
Set-CsWebServiceConfiguration [-Identity <XdsIdentity>] [-AllowAnonymousAccessToLWAConference <$true | $false>] [-CASigningKeyLength <UInt64>] [-Confirm [<SwitchParameter>]] [-DefaultValidityPeriodHours <UInt64>] [-EnableCertChainDownload <$true | $false>] [-EnableGroupExpansion <$true | $false>] [-Force <SwitchParameter>] [-InferCertChainFromSSL <$true | $false>] [-MACResolverUrl <String>] [-MaxCSRKeySize <UInt64>] [-MaxGroupSizeToExpand <UInt32>] [-MaxValidityPeriodHours <UInt64>] [-MinCSRKeySize <UInt64>] [-MinValidityPeriodHours <UInt64>] [-SecondaryLocationSourceUrl <String>] [-ShowDownloadCommunicatorAttendeeLink <$true | $false>] [-ShowJoinUsingLegacyClientLink <$true | $false>] [-TrustedCACerts <PSListModifier>] [-UseCertificateAuth <$true | $false>] [-UsePinAuth <$true | $false>] [-UseWindowsAuth <None | Negotiate | NTLM>] [-WhatIf [<SwitchParameter>]]
Set-CsWebServiceConfiguration [-AllowAnonymousAccessToLWAConference <$true | $false>] [-CASigningKeyLength <UInt64>] [-Confirm [<SwitchParameter>]] [-DefaultValidityPeriodHours <UInt64>] [-EnableCertChainDownload <$true | $false>] [-EnableGroupExpansion <$true | $false>] [-Force <SwitchParameter>] [-InferCertChainFromSSL <$true | $false>] [-Instance <PSObject>] [-MACResolverUrl <String>] [-MaxCSRKeySize <UInt64>] [-MaxGroupSizeToExpand <UInt32>] [-MaxValidityPeriodHours <UInt64>] [-MinCSRKeySize <UInt64>] [-MinValidityPeriodHours <UInt64>] [-SecondaryLocationSourceUrl <String>] [-ShowDownloadCommunicatorAttendeeLink <$true | $false>] [-ShowJoinUsingLegacyClientLink <$true | $false>] [-TrustedCACerts <PSListModifier>] [-UseCertificateAuth <$true | $false>] [-UsePinAuth <$true | $false>] [-UseWindowsAuth <None | Negotiate | NTLM>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Muchos componentes de Microsoft Lync Server 2010 están basados en web: estos componentes usan Servicios web o páginas web para llevar a cabo estas tareas. Por ejemplo, los usuarios usan 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 los Servicios web en toda la organización. Esto incluye la administración de la 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 Web Services), puede personalizar las funcionalidades de Servicios web para diferentes usuarios y ubicaciones. Los cmdlets CsWebServiceConfiguration (Get-CsWebServiceConfiguration, New-CsWebServiceConfiguration, Remove-CsWebServiceConfiguration y Set-CsWebServiceConfiguration) permiten a los administradores gestionar las opciones de configuración de Servicios web en toda la organización. Esto incluye la administración de la expansión de grupos, la configuración de certificados y los métodos de autenticación permitidos. Dado que es posible configurar distintas opciones en el ámbito global, de sitio y de servicio (aunque solo para el servicio Web Services), puede personalizar las capacidades de Servicios web para los distintos usuarios y ubicaciones.
Las configuraciones personalizadas (por ejemplo, los periodos de validez personalizados) se puede especificar al crear una recopilación de opciones de configuración de Servicios web. Por otro lado, puede modificar los valores de propiedad para cualquier recopilación existente mediante el uso del cmdlet Set-CsWebServiceConfiguration.
Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Set-CsWebServiceConfiguration localmente: 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 "Set-CsWebServiceConfiguration"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
Identidad Xds |
Identificador único para las opciones de configuración de Servicios web que deben modificarse. Para modificar las configuraciones establecidas en el ámbito de sitio, use una sintaxis similar a esta: -Identity "site:Redmond". Para modificar las opciones configuradas en el ámbito de servicios, use una sintaxis similar a la siguiente: -Identity "service:WebServer:atl-cs-001.litwareinc.com". Para modificar las configuraciones establecidas en el ámbito de sitio, use esta sintaxis: -identity global. Si el parámetro Identity no se usa, entonces, Set-CsWebServiceConfiguration modificará automáticamente la recopilación global. |
Instance |
Requerido |
Objeto WebServiceSettings |
Permite enviar una referencia a un objeto al cmdlet, en lugar de definir valores de parámetros individuales. |
AllowAnonymousAccessToLWAConference |
Opcional |
Booleano |
Cuando se establece en True, los usuarios anónimos podrán asistir a conferencias de Lync Web App (LWA). |
CASigningKeyLength |
Opcional |
Integer |
Configura el tamaño de la clave de firmas de la CA, la clave privada usada por una entidad de certificación (CA) para firmar certificados digitales. La longitud de la clave de firma se puede establecer en cualquier valor íntegro entre 2048 y 16384 bytes; el valor predeterminado es 2048. |
DefaultValidityPeriodHours |
Opcional |
Integer |
Al usar la certificación de autenticación, los clientes pueden solicitar el periodo de tiempo (en horas) que el certificado es válido. DefaultValidityPeriodHours representa la cantidad de tiempo que un certificado tendrá validez si el cliente no solicita un periodo de validez personalizado. DefaultValidityPeriodHours puede ser cualquier valor entero entre 8 horas y 8760 horas (365 días). El valor predeterminado es 4320 (180 días). |
EnableCertChainDownload |
Opcional |
Booleano |
Si se establece en True, los servidores que se presentan con un certificado de autenticación descargarán la cadena de certificados para ese certificado. La cadena del certificado busca el certificado en la CA. Los certificados no se aceptarán para la autenticación salvo que se confíe en la CA del certificado. |
EnableGroupExpansion |
Opcional |
Si se establece en True, la expansión de grupos se habilitará en Microsoft Lync 2010. Con la expansión de grupos, los usuarios pueden configurar un grupo de distribución como un contacto y, luego, "expandir" ese grupo. Cuando se expande un grupo, los usuarios pueden ver los miembros individuales de un grupo y su información de presencia actual. |
|
InferCertChainFromSSL |
Opcional |
Booleano |
Si se establece en True, los servidores usarán la información de certificado incluida en el protocolo de la Capa de sockets seguros (SSL) para determinar la CA emisora. Los certificados no se aceptarán para la autenticación salvo que se confíe en la CA del certificado. |
MACResolverUrl |
Opcional |
Cadena de caracteres |
URL de un servicio web capaz de realizar resoluciones de Media Access Control (MAC). La resolución de MAC implica tomar una dirección IP y determinar la dirección de MAC de la tarjeta de red asociada con esa dirección IP. |
MaxCSRKeySize |
Opcional |
Integer |
Establece el tamaño máximo de la clave de la Solicitud de firma de certificado (CRS). (Una CSR es un mensaje enviado de un solicitante a una CA para solicitar un certificado digital). El tamaño máximo de una clave CSR puede definirse en cualquier valor entero entre 1.024 y 16.384, ambos incluidos. El valor predeterminado es 16384. |
MaxGroupSizeToExpand |
Opcional |
Integer |
Representa el número máximo de personas que se mostrarán al expandir un grupo. Por ejemplo, si MaxGroupSizeToExpand se expande a 75, solo se mostrarán los primeros 75 miembros del grupo cada vez que este se expanda. MaxGroupSizeToExpand puede establecerse en cualquier valor entero entre 1 y 1000, inclusive. El valor predeterminado es 100. |
MaxValidityPeriodHours |
Opcional |
Integer |
Al usar la certificación de autenticación, los clientes pueden solicitar el periodo de tiempo (en horas) que el certificado es válido. MaxValidityPeriodHours representa la cantidad de tiempo máxima con la que cuenta un cliente para realizar una solicitud. MaxValidityPeriodHours puede ser cualquier valor entero entre 8 horas y 8760 horas (365 días). El valor predeterminado es 8760. |
MinCSRKeySize |
Opcional |
Integer |
Establece el tamaño mínimo de la clave de la Solicitud de firma de certificado (CRS). El tamaño mínimo puede definirse en cualquier valor entero entre 1.024 y 16.384, ambos incluidos. El valor predeterminado es 16384. |
MinValidityPeriodHours |
Opcional |
Integer |
Al usar la certificación de autenticación, los clientes pueden solicitar el periodo de tiempo (en horas) que el certificado es válido. MinValidityPeriodHours representa la cantidad de tiempo mínima con la que cuenta un cliente para realizar una solicitud. MinValidityPeriodHours puede ser cualquier valor entero entre 8 horas y 4320 horas (180 días). El valor predeterminado es 8. |
SecondaryLocationSourceUrl |
Opcional |
Cadena de caracteres |
URL de un servicio web que puede procesar una solicitud de ubicación. Este servicio sólo se usa cuando las solicitudes de ubicación no pueden resolverse de manera local. |
ShowDownloadCommunicatorAttendeeLink |
Opcional |
Booleano |
Si se configura como True (el valor predeterminado), los usuarios que se unan a una reunión usando una aplicación que no sea Lync 2010 verán un vínculo que les llevará a una descarga de Lync 2010 Attendee. |
ShowJoinUsingLegacyClientLink |
Opcional |
Booleano |
Si se configura como True, los usuarios que se unan a una reunión usando una aplicación cliente que no sea de Lync 2010 tendrán la oportunidad de unirse a la reunión usando su aplicación cliente actual. El valor predeterminado es False. |
TrustedCACerts |
Opcional |
Colección de certificados |
Colección de certificados que representa las cadenas de certificados de confianza para el servidor web. Los certificados nuevos agregados a la recopilación deben crearse usando el cmdlet New-CsWebTrustedCACertificate. Esta recopilación no se usa si la propiedad InferCertChainFromSSL está establecida en True. |
UseCertificateAuth |
Opcional |
Booleano |
Cuando está establecido en True (el valor predeterminado), los clientes se pueden autenticar mediante el uso de certificados. Configure este valor como False para deshabilitar la autenticación de certificados. |
UsePinAuth |
Opcional |
Booleano |
Cuando se configura como True (el valor predeterminado), los clientes pueden autenticarse usando números de identificación personal (PIN). Configure este valor como False para deshabilitar la autenticación de PIN. |
UseWindowsAuth |
Opcional |
Modificador de lista PS |
Determina cómo (y si) los usuarios se autenticarán mediante el uso de la autenticación de Windows; es decir, mediante el uso de las mismas credenciales usadas al iniciar sesión en Windows. Los valores válidos son: Negotiate: el cliente y el servidor trabajarán conjuntamente para determinar el protocolo de autenticación adecuado (ya sea Kerberos o NTLM). NTLM; se permitirá la autenticación de Windows, pero solo mediante el uso del protocolo NTLM. None: no se permitirá la autenticación de Windows. |
Force |
Opcional |
Parámetro modificador |
Suprime cualquier aviso de confirmación o mensaje de error leve que se pueda producir al ejecutar el cmdlet. |
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
Objeto Microsoft.Rtc.Management.WritableConfig.Settings.Web.WebServiceSettings. Set-CsWebServiceConfiguration acepta entradas canalizadas del objeto de opciones de configuración de Servicios web.
Tipos de valores devueltos
Set-CsWebServiceConfiguration no devuelve ningún valor ni objeto. En su lugar, el cmdlet configura instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.Web.WebServiceSettings.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Set-CsWebServiceConfiguration -Identity site:Redmond -EnableGroupExpansion $True
En el Ejemplo 1 se habilita una expansión de grupos para las opciones de configuración de Servicios web aplicadas al sitio de Redmond (-Identity site:Redmond). Esto se realiza al incluir la propiedad EnableGroupExpansion y establecer el valor de parámetro en True.
-------------------------- Ejemplo 2 --------------------------
Get-CsWebServiceConfiguration -Filter "site:*" | Set-CsWebServiceConfiguration -MaxValidityPeriodHours 16
En el Ejemplo 2, el periodo de validez máximo para todas las opciones de configuración de Servicios web aplicadas al ámbito de sitio se cambia a 16 horas. Para llevar a cabo esta tarea, se llama a Get-CsWebServiceConfiguration junto con el parámetro Filter; el valor de filtro "site:*" limita los datos devueltos a las configuraciones en donde Identity comienza con los caracteres "site:". Luego, esta recopilación se canaliza a Set-CsWebServiceConfiguration, que toma cada elemento de la recopilación y cambia la propiedad MaxValidityPeriodHours a 16.
-------------------------- Ejemplo 3 --------------------------
Get-CsWebServiceConfiguration | Where-Object {$_.EnableGroupExpansion -eq $True} | Set-CsWebServiceConfiguration -MaxGroupSizeToExpand 400
En el comando anterior, el tamaño de la expansión de grupos se establece en 400 para cada recopilación de opciones de configuración de Servicios web que permiten la expansión de grupos. Para ello, se llama a Get-CsWebServiceConfiguration sin ningún parámetro; esto devuelve una recopilación de todas las opciones de configuración de Servicios web que se usan en la organización. Luego, esta recopilación se canaliza hacia Where-Object, el cual selecciona únicamente aquellas configuraciones donde la propiedad EnableGroupExpansion es igual a True. A su vez, esta recopilación se canaliza hacia Set-CsWebServiceConfiguration, que establece el valor de la propiedad MaxGroupSizeToExpand en 400 para cada uno de los elementos de la recopilación.
-------------------------- Ejemplo 4 ------------------------
Set-CsWebServiceConfiguration -Identity global -ShowDownloadCommunicatorAttendeeLink $True
El comando que se muestra en el Ejemplo 4 muestra cómo se pueden configurar las opciones de configuración de Servicios web de manera que toda persona que se una a una reunión con una aplicación cliente que no sea Lync 2010 primero verá un vínculo hacia un sitio en el que se puede descargar Lync 2010 Attendee. Esto se realiza al incluir el parámetro ShowDownloadCommunicatorAttendeeLink y establecer el valor de parámetro en $True.
Vea también
Otros recursos
Get-CsWebServiceConfiguration
New-CsWebServiceConfiguration
Remove-CsWebServiceConfiguration