Remove-CsVoiceRoute
Dernière rubrique modifiée : 2012-03-25
Supprime un itinéraire de communication vocale. 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).
Syntaxe
Remove-CsVoiceRoute -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Description détaillée
Cette cmdlet vous permet de supprimer un itinéraire de communications vocales existant. Les itinéraires de communications vocales sont associés aux stratégies de voix par l’intermédiaire des utilisations téléphoniques (PSTN). Ainsi, la suppression d’un itinéraire de communications vocales ne change aucune valeur liée à une stratégie de voix ; elle change simplement le routage des numéros qui correspondaient au modèle pour l’itinéraire de communications vocales supprimé.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Remove-CsVoiceRoute : 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 "Remove-CsVoiceRoute"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
XdsGlobalRelativeIdentity |
Chaîne qui identifie de façon unique l’itinéraire de communications vocales que vous souhaitez supprimer. (Si l’itinéraire de communications vocales contient un espace (par exemple, Itinéraire de test), vous devez mettre toute la chaîne entre guillemets.) |
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.Route. Accepte la saisie de données transmises via le pipeline pour les objets d’itinéraire de communications vocales.
Types de retours
Supprime un objet de type Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route.
Exemple
-------------------------- Exemple 1 --------------------------
Remove-CsVoiceRoute -Identity Route1
Supprime les paramètres de l’itinéraire de communications vocales dont l’identité est Route1.
-------------------------- Exemple 2 --------------------------
Get-CsVoiceRoute | Remove-CsVoiceRoute
Cette commande supprime tous les itinéraires de communications vocales de l’organisation. Tous les itinéraires de communications vocales sont d’abord récupérés à l’aide de la cmdlet Get-CsVoiceRoute. Ces itinéraires de communications vocales sont ensuite redirigés vers Remove-CsVoiceRoute, qui les supprime tous.
-------------------------- Exemple 3 --------------------------
Get-CsVoiceRoute -Filter *Redmond* | Remove-CsVoiceRoute
Cette commande supprime tous les itinéraires de communications vocales dont l’identité inclut la chaîne « Redmond ». La cmdlet Get-CsVoiceRoute est d’abord appelée avec le paramètre Filter. La valeur du paramètre Filter est la chaîne Redmond placée entre des caractères génériques (*), ce qui indique que la chaîne peut se trouver n’importe où dans l’identité. Lorsque tous les itinéraires de communications vocales dont les identités incluent le chaîne Redmond sont récupérés, ces itinéraires de communications vocales sont redirigés vers Remove-CsVoiceRoute qui les supprime tous.