New-CsNetworkBWAlternatePath
Última modificación del tema: 2012-03-26
Crea nuevas configuraciones que definen si los medios se pueden enrutar a rutas de acceso de Internet alternativas para las conexiones con ancho de banda limitado.
Sintaxis
New-CsNetworkBWAlternatePath -AlternatePath <$true | $false> -BWPolicyModality <Audio | Video>
Descripción detallada
Dentro de una configuración de control de admisión de llamadas (CAC) en Microsoft Lync Server 2010, hay dos modalidades posibles: audio y vídeo. Se pueden establecer limitaciones de ancho de banda en ambas modalidades. Si las limitaciones de ancho de banda impiden que se realice una llamada, dicha llamada puede tomar una ruta de acceso de Internet alternativa para que la llamada sea posible. Este cmdlet permite crear las configuraciones que definen si una llamada se puede enrutar a una ruta de acceso de Internet alternativa según su modalidad. Las configuraciones se aplican por región dentro de la configuración de CAC.
Este cmdlet no guarda inmediatamente las configuraciones recién creadas. Por el contrario, crea las configuraciones en la memoria. Para aplicar las configuraciones a una región de la red, debe asignar el resultado del cmdlet a una variable y, a continuación, usar la variable como un valor del parámetro BWAlternatePaths del cmdlet New-CsNetworkRegion o Set-CsNetworkRegion. Tenga en cuenta que puede aplicar las configuraciones directamente mediante los parámetros AudioAlternatePath y VideoAlternatePath de los cmdlets New-CsNetworkRegion y Set-CsNetworkRegion, sin necesidad de llamar a New-CsNetworkBWAlternatePath para crear un nuevo objeto.
Quién puede ejecutar este cmdlet: De manera predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar localmente el cmdlet New-CsNetworkBWAlternatePath: 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-CsNetworkBWAlternatePath"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
AlternatePath |
Requerido |
Booleano |
Asigne el valor True al parámetro para permitir que las llamadas realizadas en el medio de la modalidad especificada en el parámetro BWPolicyModality (audio o vídeo) se enruten a una ruta de acceso alternativa si el ancho de banda necesario no existe en la ruta de acceso principal. |
BWPolicyModality |
Requerido |
BWPolicyModality |
La modalidad a la que se aplica la configuración de ruta de acceso alternativa. Valores válidos: audio, video Tipo de datos completo: Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.BWPolicyModality |
Tipos de entrada
Ninguno.
Tipos de valores devueltos
Crea un objeto de tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.BWAlternatePathType.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
$a = New-CsNetworkBWAlternatePath -BWPolicyModality "audio" -AlternatePath $true
New-CsNetworkRegion -Identity NorthAmerica -CentralSite Redmond-NA-MLS -BWAlternatePaths $a
En este ejemplo se crea una nueva ruta de acceso alternativa de ancho de banda de red y se asigna la configuración a una región recién creada. En la primera línea del ejemplo se llama al cmdlet New-CsNetworkBWAlternatePath para crear una nueva ruta de acceso alternativa. Las rutas de acceso alternativas tienen solo dos propiedades: BWPolicyModality, que debe configurarse como audio o vídeo (en este ejemplo se utiliza audio); y AlternatePath, que debe tener el valor True o False (True, en este ejemplo). Asignamos el resultado de este cmdlet, que es una referencia al objeto de ruta de acceso alternativa que se acaba de crear, a la variable $a.
En la línea 2 de este ejemplo, se usa la ruta de acceso alternativa recién creada para crear una nueva región de red. Para hacerlo, llamamos a New-CsNetworkRegion y pasamos la identidad NorthAmerica. Asignamos un valor al parámetro obligatorio CentralSite (en este ejemplo, el nombre del sitio central de esta región es Redmond-NA-MLS) y, a continuación, especificamos el parámetro BWAlternatePaths y le pasamos la variable ($a) que contiene el objeto de ruta de acceso alternativa que acabamos de crear.