New-CsNetworkBWAlternatePath
Dernière rubrique modifiée : 2012-03-26
Crée de nouveaux paramètres permettant de définir si un média peut emprunter d’autres chemins via Internet pour les connexions à bande passante restreinte.
Syntaxe
New-CsNetworkBWAlternatePath -AlternatePath <$true | $false> -BWPolicyModality <Audio | Video>
Description détaillée
Il existe deux modalités possibles au sein d’une configuration de contrôle d’admission des appels (Call Admission Control ou CAC) dans Microsoft Lync Server 2010 : audio et vidéo. Des restrictions de bande passante peuvent être définies pour chacune de ces modalités. Quand les restrictions de bande passante empêchent d’effectuer un appel, il est possible de choisir un autre chemin via Internet pour établir l’appel. Cette cmdlet permet de créer les paramètres définissant si un appel peut emprunter un autre chemin via Internet en fonction de la modalité. Les paramètres s’appliquent par région au sein de la configuration de contrôle d’admission des appels.
Cette cmdlet n’enregistre pas immédiatement les paramètres nouvellement créés, mais les créé dans la mémoire. Pour appliquer ces paramètres à une région au sein du réseau, vous devez affecter le résultat de la cmdlet à une variable, puis utiliser cette variable comme valeur du paramètre BWAlternatePaths de la cmdlet New-CsNetworkRegion ou Set-CsNetworkRegion. Notez que vous pouvez appliquer ces paramètres directement en utilisant les paramètres AudioAlternatePath et VideoAlternatePath des cmdlets New-CsNetworkRegion etSet-CsNetworkRegion sans devoir appeler New-CsNetworkBWAlternatePath pour créer un nouvel objet.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet New-CsNetworkBWAlternatePath : RTCUniversalServerAdmins. Pour retourner une liste de tous les rôles RBAC (Contrôle d’accès basé sur un rôle) auxquels cette cmdlet a été affectée (y compris les rôles RBAC personnalisés créés par vos soins), exécutez la commande suivante à l’invite Windows PowerShell :
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsNetworkBWAlternatePath"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
AlternatePath |
Obligatoire |
Booléen |
Définissez le paramètres sur True afin de permettre aux appels passés avec le média de la modalité spécifiée dans le paramètre BWPolicyModality (audio ou vidéo) d’emprunter un autre chemin si le chemin primaire ne dispose pas de la bande passante adéquate. |
BWPolicyModality |
Obligatoire |
BWPolicyModality |
Modalité à laquelle s’applique le paramètre de l’autre chemin. Valeurs valides : audio, vidéo Type de données complet : Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.BWPolicyModality |
Types d’entrées
Aucun.
Types de retours
Crée un objet de type Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.BWAlternatePathType.
Exemple
-------------------------- Exemple 1 --------------------------
$a = New-CsNetworkBWAlternatePath -BWPolicyModality "audio" -AlternatePath $true
New-CsNetworkRegion -Identity NorthAmerica -CentralSite Redmond-NA-MLS -BWAlternatePaths $a
Cet exemple crée un autre chemin de bande passante réseau et affecte les paramètres à une région nouvellement créée. La première ligne de cet exemple appelle la cmdlet New-CsNetworkBWAlternatePath afin de créer un autre chemin. Les autres chemins n’ont que deux propriétés : BWPolicyModality, qui doit être définie sur audio ou vidéo (audio dans cet exemple) et AlternatePath, qui doit être définie sur True ou False (True dans cet exemple). Nous affectons le résultat de cette cmdlet, faisant référence à l’objet de l’autre chemin qui vient d’être créé, à la variable $a.
À la ligne 2 de cet exemple, nous utilisons cet autre chemin nouvellement créé pour la création d’une nouvelle région de réseau. Pour ce faire, nous appelons New-CsNetworkRegion, qui transmet une identité NorthAmerica. Nous affectons une valeur au paramètre CentralSite obligatoire (dans cet exemple, le nom du site central de cette région est Redmond-NA-MLS), puis nous spécifions le paramètre BWAlternatePaths, pour lui transmettre la variable ($a) contenant l’objet de l’autre chemin que nous venons de créer.