New-CsWebServiceConfiguration
Última modificación del tema: 2012-04-23
Crea una nueva colección de opciones de configuración de Servicios web.
Sintaxis
New-CsWebServiceConfiguration -Identity <XdsIdentity> [-AllowAnonymousAccessToLWAConference <$true | $false>] [-CASigningKeyLength <UInt64>] [-Confirm [<SwitchParameter>]] [-DefaultValidityPeriodHours <UInt64>] [-EnableCertChainDownload <$true | $false>] [-EnableGroupExpansion <$true | $false>] [-Force <SwitchParameter>] [-InferCertChainFromSSL <$true | $false>] [-InMemory <SwitchParameter>] [-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: usan Servicios web o páginas web para llevar a cabo sus 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, diversos 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 cmdlet CsWebServiceConfiguration permiten a los administradores administrar 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.
Los nuevos valores de configuración de Servicios web se crean usando el cmdlet New-CsWebServiceConfiguration. Tenga en cuenta que estos valores solo se pueden crear en el ámbito del sitio o del servicio (y únicamente para el servicio WebServer). El comando dará error si intenta crear una nueva colección de ámbito global. De igual manera, el comando dará error si intenta crear una nueva colección, por ejemplo, en la ubicación Redmond, si dicha ubicación ya hospeda una colección de valores de servicio web.
Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet New-CsWebServiceConfiguration localmente: 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 "New-CsWebServiceConfiguration"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
Identidad Xds |
Identificador único de las opciones de configuración de Servicios web que se van a crear. Para crear la configuración definida en el ámbito de sitio, use la sintaxis del siguiente ejemplo: -Identity "site:Redmond". Para crear la configuración definida en el ámbito de servicio, use la sintaxis del siguiente ejemplo: -Identity "service:WebServer:atl-cs-001.litwareinc.com". Tenga en cuenta que los valores creados en el ámbito de servicio deben asignarse al servicio Web Server. |
AllowAnonymousAccessToLWAConference |
Opcional |
Booleano |
Cuando se establezca en True (valor predeterminado), los usuarios anónimos podrán asistir a conferencias de Lync Web App (LWA). |
CASigningKeyLength |
Opcional |
Entero |
Fija el tamaño de la clave de firmas de la entidad de certificación (CA), que es la clave privada que una CA usa para firmar certificados digitales. La longitud máxima de la clave puede tener cualquier valor entero entre 2.048 y 16.384 bytes; el valor predeterminado es 2.048. |
DefaultValidityPeriodHours |
Opcional |
Entero |
Al usar la autenticación de certificados, los clientes pueden solicitar el período de tiempo (en horas) que seguirá siendo válido el certificado. DefaultValidityPeriodHours representa la cantidad de tiempo que un certificado permanece válido si el cliente no solicita un periodo de validez personalizado. DefaultValidityPeriodHours puede ser cualquier valor entero entre 8 horas y 8.760 horas (365 días). El valor predeterminado es 4.320 (180 días). |
EnableCertChainDownload |
Opcional |
Booleano |
Si se configura como True, los servidores en los que se presente un certificado de autenticación descargarán la cadena de certificado para dicho certificado. La cadena del certificado rastrea un certificado individual hasta llegar a la entidad de certificación que lo ha emitido. Solo se aceptarán certificados para su autenticación si la CA del certificado es de confianza. |
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, para después "expandir" dicho grupo. Cuando se ha expandido un grupo, los usuarios pueden ver todos los miembros de un grupo y su información de presencia. |
|
InferCertChainFromSSL |
Opcional |
Booleano |
Si se configura como True, los servidores usarán la información de certificados incluida en el protocolo de capa de sockets seguros (SSL) para determinar la CA emitente. Solo se aceptarán certificados para su autenticación si la CA del certificado es de confianza. |
MACResolverUrl |
Opcional |
Cadena de caracteres |
URL de un servicio web capaz de realizar resoluciones de Media Access Control (MAC). Las resoluciones MAC implican tomar una dirección IP y determinar la dirección MAC de la tarjeta de red asociada con la dirección IP. |
MaxCSRKeySize |
Opcional |
Entero |
Establece el tamaño máximo de la clave de solicitud de firma del certificado (CSR). (Un CSR es un mensaje enviado de un solicitante a un CA para pedir un certificado digital). El tamaño máximo puede definirse en cualquier valor entero entre 1.024 y 16.384, ambos incluidos. El valor predeterminado es 16384. |
MaxGroupSizeToExpand |
Opcional |
Entero |
Representa el número máximo de personas que se mostrarán cuando se expande un grupo. Por ejemplo, si MaxGroupSizeToExpand se establece en 75, solo se mostrarán los 75 primeros miembros del grupo cuando éste se expanda. MaxGroupSizeToExpand puede establecerse en cualquier valor entero entre 1 y 1000, ambos incluidos. El valor predeterminado es 100. |
MaxValidityPeriodHours |
Opcional |
Entero |
Al usar la autenticación de certificados, los clientes pueden solicitar el período de tiempo (en horas) que seguirá siendo válido el certificado. MaxValidityPeriodHours representa la cantidad máxima de tiempo que un cliente puede solicitar. MaxValidityPeriodHours puede ser cualquier valor entero entre 8 horas y 8.760 horas (365 días). El valor predeterminado es 8760. |
MinCSRKeySize |
Opcional |
Entero |
Establece el tamaño mínimo de la clave de solicitud de firma del certificado (CSR). 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 |
Entero |
Al usar la autenticación de certificados, los clientes pueden solicitar el período de tiempo (en horas) que seguirá siendo válido el certificado. MinValidityPeriodHours representa la cantidad mínima de tiempo que un cliente puede solicitar. 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 se suele usar cuando las solicitudes de ubicación no pueden resolverse de manera local. |
ShowDownloadCommunicatorAttendeeLink |
Opcional |
Cadena de caracteres |
Si se establece en True (valor predeterminado), los usuarios que se unan a una reunión a través de una aplicación que no sea Lync 2010 verán un vínculo que los llevará a la descarga de Lync 2010 Attendee. |
ShowJoinUsingLegacyClientLink |
Opcional |
Cadena de caracteres |
Si se establece en True, los usuarios que se unan a una reunión con una aplicación cliente distinta 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 colección deben crearse usando el cmdlet New-CsWebTrustedCACertificate. Esta colección no se usa si la propiedad InferCertChainFromSSL está establecida en True. |
UseCertificateAuth |
Opcional |
Booleano |
Cuando se configura como True (el valor predeterminado), los clientes pueden autenticarse usando certificados. Configure este valor como False ($False) para deshabilitar la autenticación de certificados. |
UsePinAuth |
Opcional |
Booleano |
Cuando se establece en True (valor predeterminado), los clientes pueden autenticarse usando números de identificación personal (PIN). Establezca este valor en False ($False) para deshabilitar la autenticación de PIN. |
UseWindowsAuth |
Opcional |
Modificador de lista PS |
Determina de qué modo, si se da el caso, los usuarios se autentican usando la autenticación Windows, es decir, con las mismas credenciales que usaron al iniciar sesión en Windows. Los valores válidos son: Negociar: el cliente y el servidor trabajarán juntos para determinar el protocolo de autenticación adecuado (Kerberos o NTLM). NTLM: se permite la autenticación Windows, pero sólo con el uso del protocolo NTML. Ninguno: la autenticación Windows no se permitirá. |
Force |
Opcional |
Parámetro modificador |
Suprime la visualización de los mensajes de error que no son graves y que pueden surgir al ejecutar el comando. |
InMemory |
Opcional |
Parámetro modificador |
Crea una referencia de objeto sin confirmar realmente el objeto como cambio permanente. Si se asigna la salida de este cmdlet llamado con este parámetro en una variable, puede realizar cambios en las propiedades de la referencia del objeto y después confirmar estos cambios, llamando a este conjunto coincidente de cmdlet, - 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
Ninguno. New-CsWebServiceConfiguration no acepta entradas transferidas.
Tipos de valores devueltos
New-CsWebServiceConfiguration crea nuevas instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.Web.WebServiceSettings.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
New-CsWebServiceConfiguration -Identity site:Redmond -EnableGroupExpansion $False -UseCertificateAuth $True
El comando mostrado en el ejemplo 1 crea una recopilación de las opciones de configuración de Servicios web relativas al sitio de Redmond (-Identity site:Redmond). En este ejemplo se incluyen dos parámetros opcionales: EnableGroupExpansion, que se establece en False ($False), y UseCertificateAuth, que se establece en True ($True). Estos dos parámetros se usan para deshabilitar la expansión de grupos y habilitar el uso de certificados de autenticación, respectivamente.
Tenga en cuenta que este comando dará error si la colección de opciones de configuración de Servicios web ya se ha creado para el sitio de Redmond. Esto se debe a que los sitios se limitan a una sola colección de opciones de configuración de Servicios web.
-------------------------- Ejemplo 2 ------------------------
$x = New-CsWebServiceConfiguration -Identity site:Redmond -InMemory
$x.EnableGroupExpansion = $False
$x.UseCertificateAuth = $True
Set-CsWebServiceConfiguration -Instance $x
El ejemplo 2 es una variante del comando mostrado en el ejemplo 1. Sin embargo, en este caso, la nueva colección de opciones de configuración de Servicios web se crea en principio solo en la memoria y se aplica después al sitio de Redmond. Para ello, el primer comando del ejemplo usa New-CsWebServiceConfiguration para crear una colección de opciones para el sitio de Redmond. El parámetro InMemory se incluye para hacer que esta colección se cree solo en la memoria y no se aplique inmediatamente al sitio de Redmond. (Dado que dichos valores de configuración sólo existen en la memoria, deben almacenarse en una variable. En este caso, se trata de una variable llamada $x).
Los comandos 2 y 3 del ejemplo toman estas opciones de configuración virtuales y modifican los valores de las propiedades EnableGroupExpansion y UseCertificateAuth. Después de que se hayan hecho estos cambios, el último comando usa Set-CsWebServiceConfiguration para tomar los valores virtuales y aplicarlos a la ubicación Redmond. Si no ejecuta Set-CsWebServiceConfiguration, no se asignarán nuevos valores de configuración a la ubicación. En cambio, las opciones de configuración virtuales de Servicios web desaparecerán en cuanto termine la sesión en Windows PowerShell o se borre la variable $x.
Vea también
Otros recursos
Get-CsWebServiceConfiguration
Remove-CsWebServiceConfiguration
Set-CsWebServiceConfiguration