Set-CsConferencingConfiguration
Última modificación del tema: 2012-04-23
Modifica una colección existente de configuraciones de conferencia. La configuración de conferencia determina aspectos como el tamaño máximo permitido para el contenido y los documentos de reuniones; el período de gracia del contenido (es decir, la cantidad de tiempo durante la cual se almacenará el contenido antes de eliminarlo) y las direcciones URL para las descargas internas y externas del cliente admitido.
Sintaxis
Set-CsConferencingConfiguration [-Identity <XdsIdentity>] [-ClientAppSharingPort <UInt16>] [-ClientAppSharingPortRange <UInt32>] [-ClientAudioPort <UInt16>] [-ClientAudioPortRange <UInt32>] [-ClientFileTransferPort <UInt16>] [-ClientFileTransferPortRange <UInt32>] [-ClientMediaPort <UInt16>] [-ClientMediaPortRange <UInt32>] [-ClientMediaPortRangeEnabled <$true | $false>] [-ClientSipDynamicPort <UInt16>] [-ClientSipDynamicPortRange <UInt32>] [-ClientVideoPort <UInt16>] [-ClientVideoPortRange <UInt32>] [-Confirm [<SwitchParameter>]] [-ConsoleDownloadExternalUrl <String>] [-ConsoleDownloadInternalUrl <String>] [-ContentGracePeriod <TimeSpan>] [-Force <SwitchParameter>] [-HelpdeskExternalUrl <String>] [-HelpdeskInternalUrl <String>] [-MaxBandwidthPerAppSharingServiceMb <UInt64>] [-MaxContentStorageMb <UInt16>] [-Organization <String>] [-WhatIf [<SwitchParameter>]]
Set-CsConferencingConfiguration [-ClientAppSharingPort <UInt16>] [-ClientAppSharingPortRange <UInt32>] [-ClientAudioPort <UInt16>] [-ClientAudioPortRange <UInt32>] [-ClientFileTransferPort <UInt16>] [-ClientFileTransferPortRange <UInt32>] [-ClientMediaPort <UInt16>] [-ClientMediaPortRange <UInt32>] [-ClientMediaPortRangeEnabled <$true | $false>] [-ClientSipDynamicPort <UInt16>] [-ClientSipDynamicPortRange <UInt32>] [-ClientVideoPort <UInt16>] [-ClientVideoPortRange <UInt32>] [-Confirm [<SwitchParameter>]] [-ConsoleDownloadExternalUrl <String>] [-ConsoleDownloadInternalUrl <String>] [-ContentGracePeriod <TimeSpan>] [-Force <SwitchParameter>] [-HelpdeskExternalUrl <String>] [-HelpdeskInternalUrl <String>] [-Instance <PSObject>] [-MaxBandwidthPerAppSharingServiceMb <UInt64>] [-MaxContentStorageMb <UInt16>] [-Organization <String>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Para las conferencias, la gestión y la administración se dividen en dos conjuntos de cmdlets. Para gestionar qué tipo de actividades pueden realizar los usuarios (por ejemplo, si los usuarios pueden invitar a participantes anónimos a unirse a una conferencia, si pueden ofrecer en una conferencia compartir aplicaciones o si pueden transferir archivos en una conferencia, etc.), se utilizan los cmdlets CsConferencingPolicy.
Además de administrar las actividades de usuario, los administradores deben gestionar el Servicio de conferencia web. Por ejemplo, los administradores deben poder especificar la cantidad máxima de almacenamiento de contenido asignada a una sola conferencia, así como especificar el período de gracia previo a la eliminación automática del contenido de la conferencia. Asimismo, deben poder especificar los puertos usados para actividades como el uso compartido de aplicaciones y la transferencia de archivos.
Estas últimas actividades se pueden gestionar utilizando los cmdlets CsConferencingConfiguration. Estos cmdlets permiten gestionar los servidores propiamente dichos. Los cmdlets CsConferencingConfiguration (que se pueden aplicar al ámbito global, de sitio o de servicio) no se usan para especificar si un usuario puede compartir aplicaciones o no durante una conferencia; no obstante, si se permite compartir aplicaciones, estos cmdlets permiten indicar qué puertos se deberían usar para hacerlo. Asimismo, los cmdlets permiten especificar aspectos como los límites de almacenamiento y los períodos de expiración, así como punteros a direcciones URL internas y externas, donde los usuarios pueden obtener recursos y ayuda sobre conferencias.
Al instalar Microsoft Lync Server 2010, el sistema proporciona una sola colección de opciones de configuración de conferencia (la colección global). Si necesita crear una configuración personalizada para un sitio o servicio, puede hacerlo mediante el cmdlet New-CsConferencingConfiguration. Una vez creada la configuración personalizada, es posible modificarla (o modificar la colección global) mediante el cmdlet Set-CsConferencingConfiguration.
Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Set-CsConferencingConfiguration en forma local: 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-CsConferencingConfiguration"}
Parámetros
| Parámetro | Requerido | Tipo | Description |
|---|---|---|---|
Identity |
Opcional |
Identidad Xds |
Identificador único de la recopilación de opciones de configuración de conferencia que se va a modificar. Para hacer referencia a la recopilación global, use esta sintaxis: -Identity global. Para hacer referencia a una recopilación configurada en el ámbito de sitio, use una sintaxis similar a ésta: -Identity "site:Redmond". Para hacer referencia a una recopilación configurada en el ámbito de servicio, use una sintaxis como ésta: -Identity "service:ConferencingServer:atl-cs-001.litwareinc.com". Servicio de conferencia web es el único servicio que puede hospedar estas opciones de configuración. Si no se especifica este parámetro, Set-CsConferencingConfiguration modificará automáticamente la configuración global. |
Instance |
Opcional |
Objeto ConfSettings |
Permite enviar una referencia a un objeto al cmdlet, en lugar de definir valores de parámetros individuales. |
ClientAppSharingPort |
Opcional |
Entero |
Representa el número inicial de puerto usado para el uso compartido de aplicaciones. El valor de ClientAppSharingPort debe ser un número de puerto entre 1024 y 65535, ambos incluidos. El valor predeterminado es 5350. |
ClientAppSharingPortRange |
Opcional |
Entero |
Indica el número total de puertos disponibles para el uso compartido de aplicaciones. (El valor predeterminado es 40.) Para determinar los puertos reales usados para el uso compartido de aplicaciones, use este valor y el valor de ClientAppSharingPort. Por ejemplo, si el parámetro ClientAppSharingPort está definido en 5350 y ClientAppSharingPortRange está definido en 3, los 3 puertos siguientes estarán disponibles para el uso compartido de aplicaciones: 5350; 5351; 5352. |
ClientAudioPort |
Opcional |
Entero |
Representa el número inicial de puerto usado para el audio de cliente. El valor de ClientAudioPort debe ser un número de puerto entre 1024 y 65535, ambos incluidos. El valor predeterminado es 5350. |
ClientAudioPortRange |
Opcional |
Entero |
Indica el número total de puertos disponibles para el audio de cliente. (El valor predeterminado es 40.) Para determinar los puertos reales usados para el audio de cliente, use este valor y el valor de ClientAudioPort. Por ejemplo, si el parámetro ClientAudioPort está definido en 5350 y ClientAudioPortRange está definido en 3, los tres puertos siguientes estarán disponibles para el audio de cliente: 5350; 5351; 5352. |
ClientFileTransferPort |
Opcional |
Entero |
Representa el número inicial de puerto usado para las transferencias de archivos. El valor de ClientFileTransferPort debe ser un número de puerto entre 1024 y 65535, ambos incluidos. El valor predeterminado es 5350. |
ClientFileTransferPortRange |
Opcional |
Entero |
Indica el número total de puertos disponibles para las transferencias de archivos. (El valor predeterminado es 40.) Para determinar los puertos reales usados para las transferencias de archivos, use este valor y el valor de ClientFileTransferPort. Por ejemplo, si el parámetro ClientFileTransferPort está definido en 5350 y ClientFileTransferPortRange está definido en 3, los tres puertos siguientes estarán disponibles para las transferencias de archivos: 5350; 5351; 5352. |
ClientMediaPort |
Opcional |
Entero |
Representa el número inicial de puerto usado para los medios de cliente. Use este parámetro para los clientes de Microsoft Office Communicator 2007 R2. El valor de ClientMediaPort debe ser un número de puerto entre 1024 y 65535, inclusive. El valor predeterminado es 5350. |
ClientMediaPortRange |
Opcional |
Entero |
Indica el número total de puertos disponibles para los medios de cliente. (El valor predeterminado es 40). Use este parámetro para los clientes de Office Communicator 2007 R2. Para determinar los puertos reales usados para los medios de cliente, use este valor y el valor de ClientMediaPort. Por ejemplo, si el parámetro ClientMediaPort está definido en 5350 y ClientMediaPortRange está definido en 3, los tres puertos siguientes estarán disponibles para los medios de cliente: 5350; 5351; 5352. |
ClientMediaPortRangeEnabled |
Opcional |
Booleano |
Cuando esté definido en True, los clientes usarán el intervalo de puertos especificado para el tráfico de medios. Cuando esté definido en False (el valor predeterminado), se usará cualquier puerto disponible (desde el puerto 1024 hasta el puerto 65535) para optimizar el tráfico de medios. |
ClientSipDynamicPort |
Opcional |
Entero |
Representa el número inicial de puerto usado para el tráfico SIP. El valor de ClientSipDynamicPort debe ser un número de puerto entre 1024 y 65535, ambos incluidos. El valor predeterminado es 7100. |
ClientSipDynamicPortRange |
Opcional |
Entero |
Indica el número total de puertos disponibles para el tráfico SIP. (El valor predeterminado es 3.) Para determinar los puertos reales usados para el tráfico SIP, use este valor y el valor de ClientSipDynamicPort. Por ejemplo, si el parámetro ClientSipDynamicPort está definido en 7100 y ClientMediaPortRange está definido en 3, los 3 puertos siguientes estarán disponibles para los medios de cliente: 7100; 7101; 7102. |
ClientVideoPort |
Opcional |
Entero |
Representa el número inicial de puerto usado para el vídeo de cliente. El valor de ClientVideoPort debe ser un número de puerto entre 1024 y 65535, ambos incluidos. El valor predeterminado es 5350. |
ClientVideoPortRange |
Opcional |
Entero |
Indica el número total de puertos disponibles para el vídeo de cliente. (El valor predeterminado es 40.) Para determinar los puertos reales usados para el vídeo de cliente, use este valor y el valor de ClientVideoPort. Por ejemplo, si el parámetro ClientVideoPort está definido en 5350 y ClientVideoPortRange está definido en 3, los tres puertos siguientes estarán disponibles para el vídeo de cliente: 5350; 5351; 5352. |
ConsoleDownloadExternalUrl |
Opcional |
Cadena de caracteres |
Dirección URL en la que los usuarios externos pueden descargar un cliente compatible, por ejemplo, Microsoft Lync 2010. Tenga en cuenta que esta configuración solo se aplica a los clientes heredados (por ejemplo, Microsoft Office Communicator 2007 R2) que estén iniciando la sesión en un grupo Lync Server. |
ConsoleDownloadInternalUrl |
Opcional |
Cadena de caracteres |
Dirección URL en la que los usuarios internos pueden descargar un cliente compatible, por ejemplo, Microsoft Lync 2010. Tenga en cuenta que esta configuración solo se aplica a los clientes heredados (por ejemplo, Microsoft Office Communicator 2007 R2) que estén iniciando la sesión en un grupo Lync Server. |
ContentGracePeriod |
Opcional |
TimeSpan |
Indica durante cuánto tiempo permanecerá el contenido de conferencias en el servidor tras la finalización de la conferencia. El parámetro ContentGracePeriod debe especificarse con el formato Días.Horas:Minutos:Segundos. Por ejemplo, para definir el período de gracia de contenido en 30 días, use esta sintaxis: -ContentGracePeriod 30.00:00:00. El período de gracia de contenido se puede definir en cualquier valor entre 30 minutos (00:30:00) y 180 días (180.00:00:00). El valor predeterminado es 15 días (15.00:00:00). |
HelpdeskExternalUrl |
Opcional |
Cadena de caracteres |
Dirección URL a la que se dirigirá a los usuarios externos que hagan clic en la Ayuda durante una conferencia. |
HelpdeskInternalUrl |
Opcional |
Cadena de caracteres |
Dirección URL a la que se dirigirá a los usuarios internos que hagan clic en la Ayuda durante una conferencia. |
MaxBandwidthPerAppSharingServiceMb |
Opcional |
Entero |
Indica la cantidad máxima de ancho de banda (en megabytes) reservada para Servicio de conferencia de uso compartido de aplicaciones. MaxBandwidthPerAppSharingServiceMb puede definirse en cualquier valor entero entre 50 y 100000, ambos incluidos. El valor predeterminado es 375 megabytes. |
MaxContentStorageMb |
Opcional |
Entero |
Cantidad máxima de espacio de archivo (en megabytes) permitida para el almacenamiento de contenido de reuniones. MaxContentStorageMb puede definirse en cualquier valor entero entre 50 y 1024 (1 gigabyte), ambos incluidos. El valor predeterminado es 500 megabytes. |
Organization |
Opcional |
Cadena de caracteres |
Nombre de la organización que hospeda la conferencia. |
Force |
Opcional |
Parámetro modificador |
Suprime la visualización de los mensajes de error que no sean graves y que puedan producirse 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
Objeto Microsoft.Rtc.Management.WritableConfig.Settings.WebConf.ConfSettings. Set-CsConferencingConfiguration acepta las instancias transferidas del objeto de configuración de conferencia.
Tipos de valores devueltos
Set-CsConferencingConfiguration no devuelve ni valores ni objetos. En su lugar, el cmdlet configura instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.WebConf.ConfSettings.
Ejemplo
Ejemplo 1
Set-CsConferencingConfiguration -Identity global -Organization Litwareinc
En el Ejemplo 1, Set-CsConferencingConfiguration modifica la instancia global de la configuración de conferencia; en este caso, el comando define el valor de la propiedad Organization en Litwareinc. Para ello, se incluye el parámetro Organization seguido del nombre de la organización: Litwareinc.
Ejemplo 2
Get-CsConferencingConfiguration | Set-CsConferencingConfiguration -Organization Litwareinc
El Ejemplo 2 es una ampliación del primer ejemplo; en este caso, el comando modifica el valor de la propiedad Organization para todas las colecciones de opciones de configuración de conferencia que estén actualmente en uso. Para ello, el comando primero usa Get-CsConferencingConfiguration para recuperar una colección de todas las opciones de configuración de conferencia. A continuación, la colección se transfiere a Set-CsConferencingConfiguration, que cambia el valor de la propiedad Organization de todos los elementos de la colección a Litwareinc.
Ejemplo 3
Get-CsConferencingConfiguration -Filter site:* | Set-CsConferencingConfiguration -MaxContentStorageMb 50
El comando mostrado en el Ejemplo 3 cambia el valor de la propiedad MaxContentStorageMb para todas las opciones de configuración de conferencia aplicadas al ámbito del sitio. Para ello, el comando primero llama a Get-CsConferencingConfiguration con el parámetro Filter; el valor de filtro "site:*" garantiza que solo se devuelvan las opciones de configuración en las que la identidad comience por los caracteres "site:". A continuación, la colección filtrada se transfiere a Set-CsConferencingConfiguration, que cambia el valor de la propiedad MaxContentStorageMb para todos los elementos de la colección a 50.
Ejemplo 4
Get-CsConferencingConfiguration | Where-Object {$_.MaxContentStorageMb -gt 100} | Set-CsConferencingConfiguration -MaxContentStorageMB 100
En el Ejemplo 4, se modifican todas las opciones de configuración de conferencia que permiten el almacenamiento de contenido de más de 100 megabytes para definir el almacenamiento de contenido máximo permitido en 100 megabytes. Para llevar a cabo esta tarea, el comando primero llama a Get-CsConferencingConfiguration sin ningún parámetro para devolver una colección de todas las opciones de configuración de conferencia que estén en uso. A continuación, la colección se transfiere al cmdlet Where-Object que selecciona las opciones de configuración cuya propiedad MaxContentStorageMb es mayor que 100. La colección filtrada se transfiere a Set-CsConferencingConfiguration, que selecciona todos los elementos de la colección y define el valor de la propiedad MaxContentStorageMb en 100.
Ejemplo 5
Set-CsConferencingConfiguration -Identity site:Redmond -ContentGracePeriod "22:00:00"
El comando anterior recupera las opciones de configuración de conferencia del sitio de Redmond (-Identity site:Redmond) y modifica el valor de la propiedad ContentGracePeriod definiendo el período de gracia en 22 horas (22 horas: 00 minutos: 00 segundos).
Ejemplo 6
Get-CsConferencingConfiguration | Where-Object {$_.Organization -ne "Fabrikam"} | Set-CsConferencingConfiguration -Organization Litwareinc
En el Ejemplo 6, se modifican todas las opciones de configuración de conferencia que no incluyen Fabrikam como organización; en concreto, todas estas opciones de configuración se asignan a Litwareinc como la nueva organización. Para completar esta tarea, el comando primero llama a Get-CsConferencingConfiguration sin parámetros, lo que devuelve una colección de todas las opciones de configuración de conferencia que actualmente están en uso en la organización. Dicha colección se transfiere al cmdlet Where-Object, que selecciona todas las opciones de configuración cuya propiedad Organization no sea igual a (-ne) Fabrikam. A continuación, la colección filtrada se transfiere a Set-CsConferencingConfiguration; Set-CsConferencingConfiguration cambia el valor de la propiedad Organization de todos los elementos de la colección a Litwareinc.
Vea también
Otros recursos
Get-CsConferencingConfiguration
New-CsConferencingConfiguration
Remove-CsConferencingConfiguration