Partager via

  • Article

New-CsVoicePolicy

 

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

Crée une nouvelle stratégie de voix.

Syntaxe

New-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>] [-InMemory <SwitchParameter>] [-Name <String>] [-PreventPSTNTollBypass <$true | $false>] [-PstnUsages <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Cette cmdlet crée une nouvelle stratégie de voix. 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. La stratégie créée par cette cmdlet détermine si un grand nombre de ces fonctions sont activées ou désactivées.

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

Paramètres

Parameter Obligatoire Type Description

Identity

Obligatoire

XdsIdentity

Identificateur unique spécifiant l’étendue ou le nom de la stratégie. Les valeurs valides pour la cmdlet sont site :<site name> (où <le nom du site> est le nom du site Microsoft Lync Server 2010 auquel s’applique la stratégie, par exemple, site:Redmond), et une chaîne qui désigne une stratégie utilisateur, par exemple, RedmondVoicePolicy. Une stratégie globale existe par défaut.

AllowCallForwarding

Facultatif

Booléen

Si ce paramètre a la valeur True, les appels peuvent être transférés. Si ce paramètre a la valeur False, les appels ne peuvent pas être transférés.

Valeur par défaut : True

AllowPSTNReRouting

Facultatif

Booléen

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

Valeur par défaut : True

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 cette fonction. 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.

Valeur par défaut : True

Description

Facultatif

Chaîne

Description de la stratégie de voix.

Longueur maximale : 1040 caractères.

EnableBWPolicyOverride

Facultatif

Booléen

Il est possible de définir des stratégies pour gérer la configuration réseau, notamment pour limiter la largeur de bande. 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 indépendamment des paramètres de contrôle d’admission des appels (CAC).

Valeur par défaut : False

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 l’application. 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.

Valeur par défaut : False

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.

Valeur par défaut : True

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 le téléphone du responsable 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.

Valeur par défaut : True

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, pas à l’utilisateur. Définissez cette propriété sur True pour autoriser la mise en place du suivi des appels malveillants.

Valeur par défaut : False

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.

Valeur par défaut : True

Name

Facultatif

Chaîne

Nom affichable décrivant cette stratégie.

Valeur par défaut : DefaultPolicy

PreventPSTNTollBypass

Facultatif

Booléen

Les frais de réseau téléphonique commuté (PSTN) sont plus communément appelés des 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 impliqueront des frais, ce qui n’est pas le cas via le réseau.

Valeur par défaut : False

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.

Par défaut, cette liste est vide. Si vous ne fournissez pas de valeur pour ce paramètre, vous recevrez un message de mise en garde stipulant que les utilisateurs qui ont ratifié cette stratégie ne sont pas en mesure de passer des appels sortants via le réseau PSTN.

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

Cette cmdlet crée une instance de l’objet Microsoft.Rtc.Management.WritableConfig.Voice.VoicePolicy.

Exemple

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

New-CsVoicePolicy -Identity UserVoicePolicy1

Cet exemple crée une nouvelle stratégie vocale par utilisateur avec des paramètres par défaut, dont l’identité est UserVoicePolicy1.

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

New-CsVoicePolicy UserVoicePolicy2 -AllowSimulRing $false -PstnUsages @{add = "Local"}

Cet exemple crée une nouvelle stratégie de voix utilisateur avec une valeur Identity « UserVoicePolicy2 » et définit la propriété AllowSimulRing sur False. Cela 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 de bureau de l’utilisateur sonne. Cette commande ajoute également la valeur « Local » à la liste des utilisations du réseau PSTN en associant cette stratégie à un itinéraire vocal qui utilise également le réseau PSTN local. (Notez que le paramètre Identity n’est pas spécifié explicitement. 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 la valeur Identity.)

-------------------------- Exemple 3 --------------------------

$a = Get-CsPstnUsage
New-CsVoicePolicy site:Redmond -PstnUsages @{add = $a.Usage}

Cet exemple crée une nouvelle stratégie de voix pour le site Redmond et applique à cette stratégie toutes les utilisations PSTN définies pour l’organisation. La première ligne de cet exemple appelle la cmdlet Get-CsPstnUsage pour récupérer l’ensemble global des utilisations du réseau PSTN de l’organisation, puis l’enregistrer dans la variable $a. La deuxième ligne appelle New-CsVoicePolicy afin de créer la nouvelle stratégie de voix pour le site Redmond. Une valeur est affectée au paramètre PstnUsages pour ajouter la liste contenue dans l’ensemble global des utilisations PSTN à cette stratégie. Veuillez noter la syntaxe de la valeur ajoutée : $a.Usage. Cela fait référence à la propriété Usage des paramètres d’utilisation du réseau PSTN qui contient la liste des utilisations du réseau.