Partager via


New-CsUnassignedNumber

 

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

Crée une plage de numéros non affectés et les règles de routage qui s’appliquent à ces numéros. L’exécution de cette cmdlet ajoute une entrée à la table de routage des numéros non affectés.

Syntaxe

New-CsUnassignedNumber -Identity <XdsGlobalRelativeIdentity> -NumberRangeStart <String> -NumberRangeEnd <String> -AnnouncementService <String> -AnnouncementName <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Priority <Int32>] [-WhatIf [<SwitchParameter>]]

New-CsUnassignedNumber -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Priority <Int32>] [-WhatIf [<SwitchParameter>]]

New-CsUnassignedNumber -Identity <XdsGlobalRelativeIdentity> -NumberRangeStart <String> -NumberRangeEnd <String> -ExUmAutoAttendantPhoneNumber <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Priority <Int32>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Les numéros non affectés sont des numéros de téléphone qui ont été affectés à une organisation, mais pas à des utilisateurs ou des téléphones spécifiques. Vous pouvez configurer Microsoft Lync Server 2010 pour acheminer des appels vers les destinations désirées lors de l’appel d’un numéro non affecté. Cette cmdlet crée les paramètres qui définissent ce routage.

Avant d’exécuter cette cmdlet, vous devez avoir défini des annonces ou configuré un standard automatique de messagerie unifiée Exchange dans le système. Pour savoir si vous avez des annonces, appelez la cmdlet Get-CsAnnouncement. Pour créer une annonce, appelez New-CsAnnouncement. Pour vérifier les paramètres du standard automatique de messagerie unifiée Exchange, exécutez la cmdlet Get-CsExUmContact

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

XdsGlobalRelativeIdentity

Nom unique de la plage de numéros non affectés à créer. Toutes les plages de numéros non affectés ont une étendue globale. Par conséquent, le nom défini ici doit être unique dans le déploiement Lync Server 2010.

AnnouncementName

Obligatoire

Chaîne

Nom de l’annonce à utiliser pour traiter les appels vers les numéros de la plage.

AnnouncementService

Obligatoire

Chaîne

Nom de domaine complet (FQDN) ou ID de service du serveur d’annonce. Vous devez définir ce paramètre uniquement si vous n’avez pas défini la valeur du paramètre ExUmAutoAttendantPhoneNumber.

ExUmAutoAttendantPhoneNumber

Obligatoire

Chaîne

Numéro de téléphone du standard automatique de la messagerie unifiée Exchange vers lequel acheminer les appels dans cette plage. Vous devez définir ce champ uniquement si vous n’utilisez pas un service d’annonce (dans ce cas, vous ne définissez pas de valeur pour le paramètre AnnouncementService ou AnnouncementName). Le contact du standard automatique de la messagerie unifiée Exchange doit déjà être configuré afin d’attribuer une valeur à ce paramètre.

NumberRangeStart

Obligatoire

Chaîne

Premier numéro de la plage de numéros non affectés. Il doit être inférieur ou égal à la valeur de NumberRangeEnd.

Le numéro doit correspondre à l’expression régulière (tel:)?(\+)?[1-9]\d{0,17}(;ext=[1-9]\d{0,9})?. Cela implique que le numéro peut commencer par la chaîne tel: (si vous ne spécifiez pas cette chaîne, elle sera automatiquement ajoutée pour vous), un signe plus (+) et un chiffre de 1 à 9. Le numéro de téléphone peut comporter jusqu’à 17 chiffres et peut être suivi d’un poste au format ;ext= suivi du numéro de poste.

NumberRangeEnd

Obligatoire

Chaîne

Dernier numéro de la plage de numéros non affectés. Il doit être supérieur ou égal à la valeur de NumberRangeStart. Pour définir une plage d’un seul numéro, utilisez le même numéro pour NumberRangeStart et NumberRangeEnd.

Le numéro doit correspondre à l’expression régulière (tel:)?(\+)?[1-9]\d{0,17}(;ext=[1-9]\d{0,9})?. Cela implique que le numéro peut commencer par la chaîne tel: (si vous ne spécifiez pas cette chaîne, elle sera automatiquement ajoutée pour vous), un signe plus (+) et un chiffre de 1 à 9. Le numéro de téléphone peut comporter jusqu’à 17 chiffres et peut être suivi d’un poste au format ;ext= suivi du numéro de poste.

Priority

Facultatif

Int32

Il est possible que les plages de numéros non affectés se chevauchent Si un numéro se trouve dans plusieurs plages, la plage ayant la priorité la plus haute est utilisée.

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

Crée un objet de type Microsoft.Rtc.Management.Voice.Helpers.DisplayAnnouncementVacantNumberRange.

Exemple

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

New-CsUnassignedNumber -Identity UNSet1 -NumberRangeStart "+14255551000" -NumberRangeEnd "+14255551100" -AnnouncementService ApplicationServer:redmond.litwareinc.com -AnnouncementName "Welcome Announcement"

Cet exemple crée la plage de numéros non affectés UNSet1. Les paramètres NumberRangeStart (+14255551000) et NumberRangeEnd (+14255551100) sont utilisés pour définir la plage des numéros non affectés auxquels s’appliquent l’annonce spécifiée. Enfin, l’annonce est définie en fournissant le paramètre AnnouncementService avec l’ID de service du service d’annonces, puis en transmettant la valeur « Welcome Announcement » au paramètre AnnouncementName. Notez qu’une annonce portant ce nom doit déjà exister dans le système.

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

New-CsUnassignedNumber -Identity UNSet2 -NumberRangeStart "+14255552100" -NumberRangeEnd "+14255552200" -ExUmAutoAttendantPhoneNumber "+12065551234"

Cet exemple crée la plage de numéros non affectés UNSet2. Dans l’exemple 1, les paramètres NumberRangeStart (+14255552100) et NumberRangeEnd (+14255552200) sont utilisés pour définir la plage des numéros non affectés auxquels s’appliquent l’annonce spécifiée. Toutefois, dans cet exemple, au lieu d’utiliser le service d’annonce, cette plage de numéros utilise le standard automatique de messagerie unifiée Exchange. (Le standard automatique est un numéro défini comme numéro principal de l’organisation qui guide les utilisateurs dans les invites vocales pour les aider à joindre la personne appropriée.) Un numéro de téléphone est envoyé au paramètre ExUmAutoAttendantPhoneNumber pour compléter la commande. Notez que la messagerie unifiée Exchange doit être configurée et que ce numéro doit être un numéro de téléphone d’objet Contact existant dans services de domaine Active Directory (AD DS). Le contact doit être un contact de standard automatique (la propriété AutoAttendant du contact doit être définie sur True).

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

New-CsUnassignedNumber -Identity UNSet2 -NumberRangeStart "+14255552100" -NumberRangeEnd "+14255552200" -ExUmAutoAttendantPhoneNumber "+12065551234" -Priority 2

L’exemple 3 est pratiquement identique à l’exemple 2 : Il crée la plage de numéros non affectés UNSet2. La différence dans cet exemple réside dans le fait que le paramètre Priority est ajouté avec la valeur 2. Cela implique que si une plage de numéros non affectés définie chevauche cette plage et que l’autre plage de numéros à une priorité supérieure (numéro de priorité inférieur, tel que 1), les appels sont transférés en fonction des paramètres de cette plage et non pas de l’autre plage.