New-CsConferencingConfiguration
Última modificación del tema: 2012-04-23
Crea una nueva colección 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 conferencia; 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
New-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>] [-InMemory <SwitchParameter>] [-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.
Los administradores también deben controlar 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 reales. 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. Tenga en cuenta que las configuraciones nuevas solo se pueden aplicar al ámbito de sitio o servicio; no es posible crear una recopilación global de opciones de configuración de conferencia. Además, ningún sitio ni servicio puede hospedar más de una recopilación de opciones de configuración. Si intenta crear una configuración para el sitio de Redmond y éste ya tiene hospedada una colección de opciones de configuración de conferencia, el comando no se completará.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet New-CsConferencingConfiguration 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 "New-CsConferencingConfiguration"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
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 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". Tenga en cuenta que Servicio de conferencia web es el único servicio que puede hospedar estas opciones de configuración. |
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 3 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 tres 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 conferencia en el servidor tras la finalización de una reunión. 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 conferencias. MaxContentStorageMb puede definirse en cualquier valor entero entre 50 y 1024 (1 gigabyte), ambos incluidos. El valor predeterminado es 500. |
Organization |
Opcional |
Cadena de caracteres |
Nombre de la organización que hospeda la conferencia. |
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. |
Force |
Opcional |
Parámetro modificador |
Suprime la visualización de los mensajes de error que no sean graves y que puedan ocurrir 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. New-CsConferencingConfiguration no acepta la entrada transferida.
Tipos de valores devueltos
New-CsConferencingConfiguration crea nuevas instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.WebConf.ConfSettings.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
New-CsConferencingConfiguration -Identity site:Redmond -Organization Litwareinc
El comando anterior crea una recopilación de opciones de configuración de conferencia para el sitio de Redmond (site:Redmond). En este ejemplo, se incluye un parámetro adicional (Organization) que se usa para definir el valor de la propiedad Organization en Litwareinc. Tenga en cuenta que este comando no se completará correctamente, si el sitio de Redmond ya cuenta con una recopilación de opciones de configuración de conferencia. Esto se debe a que solo es posible tener una recopilación de este tipo por sitio.
-------------------------- Ejemplo 2 --------------------------
$x = New-CsConferencingConfiguration -Identity site:Redmond -InMemory
$x.Organization = "Litwareinc"
Set-CsConferencingConfiguration -Instance $x
En el Ejemplo 2, inicialmente solo se crea una recopilación de opciones de configuración de conferencia en la memoria; ésta configuración virtual no se aplicará hasta más tarde al sitio de Redmond. Para ello, el primer comando del ejemplo usa el cmdlet New-CsConferencingConfiguration para crear una colección de opciones de configuración en la memoria, almacenada en la variable $x; el parámetro InMemory especifica que la colección se debe crear en la memoria, en lugar de aplicarse de forma inmediata al sitio de Redmond.
Una vez creada la recopilación, el segundo comando define el valor de la propiedad Organization en Litwareinc. Por último, el tercer comando usa Set-CsConferencingConfiguration para realmente aplicar la nueva configuración al sitio de Redmond. (Este comando no se completará correctamente si las opciones de configuración de conferencia ya se han aplicado a site:Redmond.) Si no llama a Set-CsConferencingConfiguration, la nueva configuración no surtirá efecto. En su lugar, desaparecerá en cuanto finalice la sesión de Windows PowerShell o elimine la variable $x.
Vea también
Otros recursos
Get-CsConferencingConfiguration
Remove-CsConferencingConfiguration
Set-CsConferencingConfiguration