Compartir a través de

  • Artículo

New-CsAVEdgeConfiguration

 

Última modificación del tema: 2012-03-23

Crea una colección nueva de opciones de configuración de los equipos que ejecutan Servicio perimetral A/V (estos equipos se conocen también como servidores perimetrales A/V). Un servidor perimetral A/V permite a los usuarios internos compartir datos de audio y vídeo con usuarios externos (es decir, usuarios que no estén conectados a la misma red interna).

Sintaxis

New-CsAVEdgeConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-MaxBandwidthPerPortKb <UInt32>] [-MaxBandwidthPerUserKb <UInt32>] [-MaxTokenLifetime <TimeSpan>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Un servidor perimetral A/V permite intercambiar tráfico de audio y vídeo a través del firewall de la organización. Entre otras cosas, esto permite a los usuarios utilizar Microsoft Lync Server 2010 en toda la Internet y, entonces, intercambiar datos de audio y vídeo con los usuarios que hayan iniciado sesión en el sistema desde dentro del . Las opciones de configuración de Servidor perimetral se pueden asignar en el ámbito global, del sitio y del servicio. Las opciones de configuración perimetral A/V permiten a los administradores controlar durante cuánto tiempo es válida la autenticación de usuarios antes de que deba renovarse, así como limitar la cantidad de ancho de banda que un único usuario o puerto puede usar.

El cmdlet New-CsAVEdgeConfiguration permite crear colecciones de opciones de configuración perimetral A/V en el ámbito del sitio o en el ámbito de servicio. Tal y como se ha observado anteriormente, la configuración perimetral A/V también se puede definir en el ámbito global. Sin embargo, no puede crear una nueva colección en el ámbito global.

Tenga en cuenta que cualquier sitio o servicio puede hospedar, como mucho, una única colección de opciones de configuración perimetral A/V. Si el sitio Redmond ya hospeda una colección de opciones de configuración perimetral A/V, no se puede crear una colección nueva con la Identidad site:Redmond.

A menos que el equipo de soporte de Microsoft indique lo contrario, se recomienda que no cambie las opciones de configuración perimetral A/V predeterminadas. Por este motivo, probablemente no será necesario que cree una recopilación de opciones de configuración para un sitio o servicio determinado.

Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet New-CsAVEdgeConfiguration 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-CsAVEdgeConfiguration"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Identidad Xds

Identificador único para la recopilación de opciones de configuración perimetral A/V que se va a crear. Para crear una recopilación de opciones de configuración que se aplicarán en el ámbito del sitio, use una sintaxis similar a ésta: -Identity site:Redmond. (Tenga en cuenta que este comando producirá un error si ya se ha aplicado una colección de opciones de configuración perimetral A/V al sitio de Redmond.) Las configuraciones en el ámbito del servicio deben usar una sintaxis similar a esta: -Identity service:EdgeServer:atl-cs-001.litwareinc.com.

MaxBandwidthPerPortKB

Opcional

Entero

Indica la cantidad máxima de ancho de banda (en kilobytes por segundo) que puede asignarse a un único puerto. El ancho de banda máximo puede definirse en cualquier valor entero entre 1 y 4294967296 (4096 gigabits) por segundo; el valor predeterminado es 3000.

MaxBandwidthPerUserKB

Opcional

Entero

Indica la cantidad máxima de ancho de banda (en kilobits por segundo) que puede asignarse a un usuario. El ancho de banda máximo puede definirse en cualquier valor entero entre 1 y 4294967296 (4096 gigabits) por segundo; el valor predeterminado es 10000.

MaxTokenLifetime

Opcional

Entero

La cantidad de tiempo máxima durante la cual se puede usar un token de autenticación antes de que expire y deba renovarse. La vigencia de los tokens se expresa mediante el formato siguiente: Días.Horas:Minutos:Segundos. Por ejemplo, 13 días se expresarán así, con un punto (.) después del número de días, y dos puntos (:) para separar las horas, los minutos y los segundos:

13.00:00:00

El valor predeterminado de 8 horas debe expresarse así:

08:00:00

La vigencia mínima permitida de un token es 1 minuto (00:01:00); la vigencia máxima permitida es 180 días (180.00:00:00).

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.

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-CsAVEdgeConfiguration no acepta la entrada transferida.

Tipos de valores devueltos

Crea instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.MediaRelaySettings.

Ejemplo

-------------------------- Ejemplo 1 ------------------------

New-CsAVEdgeConfiguration -Identity site:Redmond -MaxTokenLifetime "04:00:00"

El comando mostrado en el Ejemplo 1 crea una recopilación de opciones de configuración perimetral A/V para el sitio de Redmond. En este ejemplo, la propiedad MaxTokenLifetime se establece en 4 horas (04 horas: 00 minutos : 00 segundos).

-------------------------- Ejemplo 2 ------------------------

$x = New-CsAVEdgeConfiguration -Identity site:Redmond -InMemory
$x.MaxTokenLifetime = "04:00:00"
Set-CsAVEdgeConfiguration -Instance $x

En el Ejemplo 2 se muestra cómo puede crear una colección de opciones de configuración perimetral A/V en la memoria y, a continuación, transformar esta configuración virtual en una colección real de opciones de configuración perimetral A/V. Para ello, el primer comando del ejemplo crea una colección de opciones de configuración para el sitio de Redmond; se agrega el parámetro InMemory para garantizar que las opciones de configuración se creen únicamente en la memoria y no se apliquen inmediatamente al sitio de Redmond. (Puesto que solo existen en la memoria, deben almacenarse en una variable, en este caso, se trata de la variable $x.)

En el segundo comando, el valor de la propiedad MaxTokenLifetime está definido en 4 horas (04 horas: 00 minutos : 00 segundos). El tercer comando utiliza entonces Set-CsAVEdgeConfiguration para aplicar la configuración almacenada en $x al sitio Redmond.