Set-CsVoiceConfiguration
Dernière rubrique modifiée : 2012-03-26
Modifie une liste de configurations de test vocales.
Syntaxe
Set-CsVoiceConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-VoiceTestConfigurations <PSListModifier>] [-WhatIf [<SwitchParameter>]]
Set-CsVoiceConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-VoiceTestConfigurations <PSListModifier>] [-WhatIf [<SwitchParameter>]]
Description détaillée
Les configurations de test vocales servent à tester un numéro de téléphone par rapport à une stratégie de voix, un itinéraire et un plan de numérotation précis. Cette cmdlet permet de modifier des configurations de test vocales à partir d’une liste contenant toutes les configurations de test vocales employées dans le cadre d’un déploiement Microsoft Lync Server 2010.
Cette cmdlet modifie un objet de type VoiceConfiguration. Cet objet est simplement un objet conteneur pour les configurations de test vocales. Par conséquent, l’utilisation de cette cmdlet n’est pas recommandée. Pour modifier des configurations vocales, modifiez les configurations de test vocales individuelles en appelant la cmdlet Set-CsVoiceTestConfiguration.
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-CsVoiceConfiguration : 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-CsVoiceConfiguration"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Facultatif |
Chaîne |
Étendue de cet objet. La seule valeur possible pour ce paramètre est Global. |
Instance |
Facultatif |
VoiceConfiguration |
Référence à un objet de configuration vocale (Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoiceConfiguration). Ce type d’objet peut être récupéré par la cmdlet Get-CsVoiceConfiguration. |
VoiceTestConfigurations |
Facultatif |
Modificateur de liste PS |
Liste de toutes les configurations de test vocales (objets Microsoft.Rtc.Management.WritableConfig.Policy.Voice.TestConfiguration) définies pour le déploiement Lync Server 2010. Pour modifier des objets individuels de configuration de test vocale, utilisez de préférence la cmdlet Set-CsVoiceTestConfiguration. C’est le moyen que nous recommandons pour modifier des configurations 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.Management.WritableConfig.Policy.Voice.VoiceConfiguration. Accepte la saisie de données transmises via le pipeline pour un objet de configuration vocale.
Types de retours
Set-CsVoiceConfiguration ne retourne ni valeur ni objet. Au lieu de cela, la cmdlet configure les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoiceConfiguration.
Exemple
-------------------------- Exemple 1 --------------------------
$a = Get-CsVoiceConfiguration
$b = $a.VoiceTestConfigurations | Where-Object {$_.Name -eq "TestConfig2"}
$b.DialedNumber = 5551212
$b.ExpectedTranslatedNumber = +5551212
Set-CsVoiceConfiguration -Instance $a
Plusieurs étapes sont nécessaires pour modifier une configuration de test vocale dans une configuration vocale. Dans cet exemple, nous récupérons d’abord l’objet de configuration vocale en appelant la cmdlet Get-CsVoiceConfiguration. Nous affectons ensuite l’objet récupéré (il y en a un seul) à la variable $a.
À la ligne 2 de cet exemple, nous récupérons le contenu de la propriété VoiceTestConfigurations, qui représente une collection d’objets de configuration de test vocale, à partir de la variable $a. Nous redirigeons ensuite cette collection vers la cmdlet Where-Object, puis recherchons dans la collection l’objet de configuration de test vocale dont le nom est égal à la chaîne TestConfig2. Nous affectons cet objet à la variable $b.
Ensuite, nous modifions l’objet de configuration de test vocale TestConfig2 en affectant de nouvelles valeurs aux propriétés DialedNumber et ExpectedTranslatedNumber. 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 ces modifications en transmettant la variable $a au paramètre Instance de la cmdlet Set-CsVoiceConfiguration.
Il ne s’agit pas de la méthode recommandée pour modifier une configuration vocale. Pour modifier une configuration vocale, modifiez simplement les configurations de test vocales individuelles à l’aide de la propriété Set-CsVoiceTestConfiguration comme démontré ci-après :
Set-CsVoiceTestConfiguration -Identity TestConfig2 -DialedNumber 5551212 -ExpectedTranslatedNumber +5551212
Cette ligne accomplira la même tâche que celle décrite dans l’exemple 1.