Set-CsRoutingConfiguration
Dernière rubrique modifiée : 2012-03-26
Modifie une liste des itinéraires de communications vocales.
Syntaxe
Set-CsRoutingConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Route <PSListModifier>] [-WhatIf [<SwitchParameter>]]
Set-CsRoutingConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Route <PSListModifier>] [-WhatIf [<SwitchParameter>]]
Description détaillée
Les itinéraires de communications vocales contiennent des instructions qui indiquent à Microsoft Lync Server 2010 comment router les appels des utilisateurs Enterprise Voice vers des numéros de téléphone sur le réseau téléphonique commuté (PSTN) ou un autocommutateur privé (PBX). Avec cette cmdlet, vous pouvez modifier les paramètres de tout itinéraire de communications vocales défini dans un déploiement de Lync Server 2010.
L’utilisation de cette cmdlet n’est pas recommandée. Pour modifier les configurations du routage, modifiez les itinéraires de communications vocales individuels en appelant la cmdlet Set-CsVoiceRoute.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Set-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 "Set-CsRoutingConfiguration"}
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Identity |
Facultatif |
XdsIdentity |
Étendue de la configuration du routage. Cette valeur doit être Global. |
Instance |
Facultatif |
PstnRoutingSettings |
Objet de configuration du routage (Microsoft.Rtc.Management.WritablConfig.Policy.Voice.PstnRoutingSettings). Il est possible d’extraire un objet de ce type en appelant la cmdlet Get-CsRoutingConfiguration. |
Route |
Facultatif |
Itinéraire |
Liste de tous les itinéraires de communications vocales (objets Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route) définis pour le déploiement Lync Server. Pour modifier des objets d’itinéraire de communications vocales, utilisez la cmdlet Set-CsVoiceRoute. C’est le moyen que nous recommandons pour modifier des itinéraires dans cette liste. |
Force |
Facultatif |
Paramètre de commutateur |
Supprime les invites de confirmation qui s’affichent avant d’effectuer des modifications. |
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
Objet Microsoft.Rtc.WritableConfig.Management.Policy.Voice.PSTNRoutingSettings. Accepte la saisie de données transmises via le pipeline pour un objet de configuration de routage.
Types de retours
Set-CsRoutingConfiguration ne renvoie ni valeur ni objet. Au lieu de cela, la cmdlet configure les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Policy.Voice.PstnRoutingSettings.
Exemple
-------------------------- Exemple 1 --------------------------
$a = Get-CsRoutingConfiguration
$b = $a.Route | Where-Object {$_.Name -match "LocalRoute"}
$b.SuppressCallerId = $False
Set-CsRoutingConfiguration -Instance $a
Plusieurs étapes sont nécessaires à la modification d’un itinéraire de communications vocales dans une configuration du routage. Dans cet exemple, nous récupérons d’abord l’objet de configuration du routage en appelant Get-CsRoutingConfiguration. Nous affectons ensuite l’objet récupéré (il y en a un seul) à la variable $a.
Sur la ligne 2 de ce même exemple, nous récupérons le contenu de la propriété Route à partir de la variable $a, soit un ensemble d’objets d’itinéraire de communications vocales. Nous redirigeons alors cet ensemble vers la cmdlet Where-Object où nous y effectuons une recherche pour localiser tous les objets d’itinéraire de communications vocales dont le nom correspond à la chaîne LocalRoute. Nous affectons cet objet à la variable $b.
Ensuite, nous modifions l’objet d’itinéraire de communications vocales LocalRoute en attribuant la valeur $False à la propriété SuppressCallerId. En mettant à jour cet objet, nous avons également mis à jour l’objet contenu dans la variable $a. Néanmoins, l’objet en question est toujours conservé en mémoire. La dernière étape consiste à enregistrer nos modifications en transmettant la variable $a au paramètre Instance de la cmdlet Set-CsRoutingConfiguration.
Il ne s’agit pas de la méthode recommandée pour modifier la configuration du routage. Pour modifier la configuration du routage, modifiez simplement les itinéraires de communications vocales à l’aide de la propriété Set-CsVoiceRoute, comme indiqué ici :
Set-CsVoiceRoute -Identity LocalRoute -SuppressCallerId $False
Cette ligne accomplira la même tâche que celle décrite dans l’exemple 1.
Voir aussi
Autres ressources
New-CsRoutingConfiguration
Remove-CsRoutingConfiguration
Get-CsRoutingConfiguration
Set-CsVoiceRoute
Get-CsVoiceRoute