Partager via

  • Article

Set-CsVoicePolicy

 

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

Modifie une stratégie de voix existante.

Syntaxe

Set-CsVoicePolicy [-Identity <XdsIdentity>] [-AllowCallForwarding <$true | $false>] [-AllowPSTNReRouting <$true | $false>] [-AllowSimulRing <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EnableBWPolicyOverride <$true | $false>] [-EnableCallPark <$true | $false>] [-EnableCallTransfer <$true | $false>] [-EnableDelegation <$true | $false>] [-EnableMaliciousCallTracing <$true | $false>] [-EnableTeamCall <$true | $false>] [-Force <SwitchParameter>] [-Name <String>] [-PreventPSTNTollBypass <$true | $false>] [-PstnUsages <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Set-CsVoicePolicy [-AllowCallForwarding <$true | $false>] [-AllowPSTNReRouting <$true | $false>] [-AllowSimulRing <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EnableBWPolicyOverride <$true | $false>] [-EnableCallPark <$true | $false>] [-EnableCallTransfer <$true | $false>] [-EnableDelegation <$true | $false>] [-EnableMaliciousCallTracing <$true | $false>] [-EnableTeamCall <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Name <String>] [-PreventPSTNTollBypass <$true | $false>] [-PstnUsages <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Cette cmdlet modifie une stratégie de voix existante. Les stratégies de voix permettent de gérer les fonctions Enterprise Voice comme la sonnerie simultanée (possibilité d’avoir une deuxième sonnerie de téléphone chaque fois que quelqu’un appelle sur votre téléphone professionnel) et le transfert d’appel. Utilisez cette cmdlet pour modifier les paramètres qui activent et désactivent un grand nombre de ces fonctions.

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

Chaîne

Identificateur unique spécifiant l’étendue et, dans certains cas, le nom de la stratégie.

Instance

Facultatif

VoicePolicy

Permet de transmettre une référence à un objet à la cmdlet plutôt que de définir des valeurs de paramètre individuelles. Cet objet doit être de type VoicePolicy et peut être récupéré en appelant la cmdlet Get-CsVoicePolicy.

AllowCallForwarding

Facultatif

Booléen

Si ce paramètre est défini sur True, les utilisateurs affectés à cette stratégie peuvent transférer des appels. Si ce paramètre a la valeur False, les appels ne peuvent pas être transférés.

AllowPSTNReRouting

Facultatif

Booléen

Lorsque ce paramètre est défini sur True, les appels effectués vers des numéros internes hébergés dans un autre pool seront acheminés via le réseau téléphonique commuté (PSTN) lorsque le pool ou le réseau étendu (WAN) ne sont pas disponibles.

AllowSimulRing

Facultatif

Booléen

La sonnerie simultanée est une fonction qui permet de faire sonner plusieurs téléphones en composant un seul numéro. Définissez ce paramètre sur True pour activer la sonnerie simultanée. Si ce paramètre est défini sur False, la sonnerie simultanée ne peut être configurée pour aucun utilisateur affecté à cette stratégie.

Description

Facultatif

Chaîne

Description de la stratégie de voix.

Longueur maximale : 1040 caractères.

EnableBWPolicyOverride

Facultatif

Booléen

Des stratégies peuvent être définies pour restreindre la bande passante et définir des propriétés diverses liées à la configuration du réseau. Définissez ce paramètre sur True pour autoriser le remplacement de ces stratégies. En d’autres termes, si ce paramètre est défini sur True, aucune vérification de bande passante ne se fera et les appels passeront quels que soient les paramètres de contrôle d’admission des appels (CAC) définis.

EnableCallPark

Facultatif

Booléen

L’application de parcage d’appel permet de mettre un appel en attente (ou encore de le mettre en garde) sur un numéro particulier dans une plage de numéros en vue d’une récupération ultérieure. Définissez ce paramètre sur True pour activer cette application pour les utilisateurs affectés à cette stratégie. Si ce paramètre est défini sur False, les utilisateurs affectés à cette stratégie ne pourront pas mettre en garde les appels destinés à leur numéro de téléphone.

EnableCallTransfer

Facultatif

Booléen

Détermine si les appels peuvent être transférés vers un autre numéro. Si ce paramètre est défini sur True, les appels peuvent être transférés ; si ce paramètre est défini sur False, les appels ne peuvent pas être transférés.

EnableDelegation

Facultatif

Booléen

La délégation d’appels permet à un utilisateur de répondre ou de passer des appels pour un autre utilisateur. Par exemple, un responsable peut configurer la délégation d’appels pour que tous les appels entrants sonnent à la fois sur son téléphone et sur le téléphone d’un administrateur. Définissez ce paramètre sur True pour permettre aux utilisateurs disposant de cette stratégie de configurer la délégation d’appels. Définissez ce paramètre sur False pour désactiver la délégation d’appels.

EnableMaliciousCallTracing

Facultatif

Booléen

Le suivi des appels malveillants est une norme permettant d’effectuer un suivi des appels qu’un utilisateur désigne comme malveillants. Ces appels peuvent être suivis même si l’ID d’appelant est bloqué. Le suivi est uniquement accessible aux responsables adéquats mais pas à l’utilisateur. Définissez cette propriété sur True pour autoriser la mise en place du suivi des appels malveillants.

EnableTeamCall

Facultatif

Booléen

L’appel d’équipe permet à un utilisateur de désigner un groupe d’autres utilisateurs dont les téléphones sonneront lorsqu’un appel sera adressé au numéro de cet utilisateur. Cette fonction est utile dans les équipes où, par exemple, tous les membres peuvent répondre aux appels entrants des clients. Définissez ce paramètre sur True pour activer cette fonction.

Name

Facultatif

Chaîne

Nom convivial décrivant cette stratégie.

PreventPSTNTollBypass

Facultatif

Booléen

Les frais de réseau téléphonique commuté (PSTN) sont plus communément appelés « frais d’appel longue distance ». Les organisations peuvent parfois éviter ces frais en implémentant une solution VoIP (Voice over Internet Protocol) qui permet aux succursales de se connecter via des appels réseau. Si vous définissez ce paramètre sur True, vos appels passeront par le réseau téléphonique commuté (PSTN) et entraîneront des frais, ce qui n’est pas le cas via le réseau.

PstnUsages

Facultatif

Modificateur de liste PS

Liste des utilisations PSTN disponibles pour cette stratégie. Une utilisation PSTN lie une stratégie de voix à un itinéraire téléphonique.

Toute valeur de chaîne peut être placée dans cette liste, tant que la valeur existe dans la liste globale des utilisations PSTN. (Les chaînes dupliquées ne sont pas autorisées ; chaque chaîne doit être unique.) La liste des utilisations PSTN peut être récupérée en appelant la cmdlet Get-CsPstnUsage.

Gardez à l’esprit que si vous utilisez ce paramètre pour supprimer toutes les utilisations PSTN de la stratégie, les utilisateurs auxquels cette stratégie a été accordée ne pourront pas effectuer des appels PSTN sortants.

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.VoicePolicy. Accepte la saisie de données transmises via le pipeline pour les objets de stratégie de voix.

Types de retours

Cette cmdlet ne retourne ni valeur, ni objet. Au lieu de cela, elle configure les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Voice.VoicePolicy.

Exemple

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

Set-CsVoicePolicy UserVoicePolicy2 -AllowSimulRing $false -PstnUsages @{remove="Local"}

Cet exemple définit la propriété AllowSimulRing sur False pour la stratégie utilisateur UserVoicePolicy2, ce qui signifie que tous les utilisateurs auxquels cette stratégie est affectée ne sont pas activés pour la sonnerie simultanée, fonction qui détermine si un deuxième téléphone (comme un téléphone mobile) peut être défini pour sonner chaque fois que le téléphone du bureau de l’utilisateur sonne. Cette commande supprime aussi « Local » de la liste des utilisations PSTN pour cette stratégie. (Notez que le paramètre Identity n’est pas explicitement spécifié. Le paramètre Identity est un paramètre positionnel. Par conséquent, si vous spécifiez d’abord la valeur d’identité dans la liste des paramètres, vous ne devez pas indiquer explicitement qu’il s’agit de Identity.)

-------------------------- Exemple 2 --------------------------

$a = Get-CsPstnUsage
Set-CsVoicePolicy -Identity site:Redmond -PstnUsages @{replace=$a.Usage}

Cet exemple modifie la stratégie de voix du site de Redmond de sorte que toutes les utilisations PSTN définies pour l’organisation soient appliquées à cette stratégie. La première ligne de cet exemple appelle la cmdlet Get-CsPstnUsage pour récupérer l’ensemble global des utilisations PSTN de l’organisation, puis l’enregistrer dans la variable $a. La deuxième ligne appelle Set-CsVoicePolicy pour modifier la stratégie de voix pour le site de Redmond. Une valeur est transmise au paramètre PstnUsages pour remplacer la liste actuelle des utilisations de la stratégie par la liste contenue dans cet ensemble global d’utilisations PSTN. Veuillez noter la syntaxe de la valeur remplacée : $a.Usage. Cela fait référence à la propriété Usage des paramètres d’utilisation PSTN qui renferme la liste des utilisations PSTN.