Partager via


New-CsRoutingConfiguration

 

Dernière rubrique modifiée : 2012-03-26

Cette cmdlet peut retourner un objet qui contient les paramètres par défaut d’un objet de configuration du routage.

Syntaxe

New-CsRoutingConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Route <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Une configuration de routage est un conteneur qui abrite tous les itinéraires de communications vocales définis dans un déploiement Microsoft Lync Server 2010. Pour créer un nouvel itinéraire de communications vocales, utilisez la cmdlet New-CsVoiceRoute.

Une configuration de routage peut seulement être définie au niveau de l’étendue globale. De plus, vous ne pouvez pas disposer de configurations de routage désignées individuellement ; il n’existe qu’une seule liste d’itinéraires de communications vocales pour le déploiement Lync Server 2010 tout entier. Lors de l’implémentation Lync Server 2010 de Windows PowerShell, si vous tentez de créer un objet qui existe déjà en appelant une cmdlet qui commence par le verbe New, vous obtiendrez un message d’erreur. Chaque implémentation de Lync Server 2010 inclut un objet de configuration de routage par défaut avec une identité Global. Ceci signifie que la seule liste d’itinéraires de communications vocales qu’il était possible de créer existe déjà. Ainsi donc, un appel de la cmdlet New-CsRoutingConfiguration retournera toujours un message d’erreur et ne créera aucune nouvelle configuration de routage.

La seule exception à cette règle est si vous spécifiez le paramètre InMemory dans l’appel de cette cmdlet. Cette commande créera un objet uniquement en mémoire contenant une liste par défaut des itinéraires de communications vocales.

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-CsRoutingConfiguration : 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-CsRoutingConfiguration"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

XdsIdentity

Étendue de la configuration du routage. Cette valeur doit être Global.

Route

Facultatif

Modificateur de liste PS

Liste de tous les itinéraires de communications vocales (objets Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route) définis pour le déploiement de Lync Server 2010.

Vous pouvez créer des objets d’itinéraire de communications vocales à l’aide de la cmdlet New-CsVoiceRoute. Il s’agit de la méthode recommandée pour l’ajout d’itinéraires de communications vocales à cette liste.

Force

Facultatif

Paramètre de commutateur

Supprime les invites de confirmation qui s’affichent avant d’effectuer des modifications.

InMemory

Facultatif

Paramètre de commutateur

Crée une référence d’objet sans valider l’objet comme une modification définitive. Si vous affectez à une variable la sortie de cette cmdlet appelée avec ce paramètre, vous pouvez apporter des modifications aux propriétés de la référence d’objet, puis les valider en appelant la cmdlet Set- correspondante.

WhatIf

Facultatif

Paramètre de commutateur

Décrit ce qui se passe si vous exécutez la commande sans l’exécuter réellement.

Confirm

Facultatif

Paramètre de commutateur

Vous demande confirmation avant d’exécuter la commande.

Types d’entrées

Aucun.

Types de retours

Peut créer un objet en mémoire de type Microsoft.Rtc.Management.WritableConfig.Policy.Voice.PstnRoutingSettings.

Exemple

-------------------------- Exemple 1 --------------------------

$x = New-CsRoutingConfiguration -Identity global -InMemory

Cette commande crée un objet dans lequel figurent les valeurs de configuration de routage par défaut, puis affecte cet objet à la variable $x. Toute autre utilisation de cette cmdlet a pour conséquence le retour d’une erreur.