Partager via

  • Article

Set-CsUnassignedNumber

 

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

Modifie une plage existante de numéros affectés et les règles de routage qui s’appliquent à ces numéros.

Syntaxe

Set-CsUnassignedNumber [-Identity <XdsGlobalRelativeIdentity>] [-NumberRangeStart <String>] [-NumberRangeEnd <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Priority <Int32>] [-WhatIf [<SwitchParameter>]]

Set-CsUnassignedNumber [-Identity <XdsGlobalRelativeIdentity>] [-NumberRangeStart <String>] [-NumberRangeEnd <String>] -ExUmAutoAttendantPhoneNumber <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Priority <Int32>] [-WhatIf [<SwitchParameter>]]

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

Set-CsUnassignedNumber [-Identity <XdsGlobalRelativeIdentity>] [-NumberRangeStart <String>] [-NumberRangeEnd <String>] -AnnouncementService <String> -AnnouncementName <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Priority <Int32>] [-WhatIf [<SwitchParameter>]]

Set-CsUnassignedNumber [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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 modifie les paramètres qui définissent ce routage.

Pour modifier certains paramètres de cette cmdlet, votre système doit déjà avoir des annonces définies ou un standard automatique de messagerie unifiée Exchange configuré. 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 Set-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 "Set-CsUnassignedNumber"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

Chaîne

Nom unique de la plage de numéros non affectés que vous modifiez.

Instance

Facultatif

DisplayAnnouncementVacantNumberRange

Une référence à un objet contenant des paramètres de numéros non affectés. Cet objet doit être de type Microsoft.Rtc.Management.Voice.Helpers.DisplayAnnouncementVacantNumberRange et peut être récupéré en appelant la cmdlet Get-CsUnassignedNumber.

AnnouncementName

Obligatoire

Chaîne

Nom de l’annonce qui sera utilisée pour gérer les appels à cette plage de numéros.

AnnouncementService

Obligatoire

Chaîne

Nom de domaine complet (FQDN) ou ID de service du serveur d’annonce.

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

Facultatif

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

Facultatif

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 définissez pas cette chaîne, elle est ajoutée automatiquement), un signe plus (+) et un chiffre compris entre 1 et 9. Le numéro de téléphone peut comporter jusqu’à 17 chiffres et il peut être suivi d’un poste au format ;ext=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.

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.Voice.Helpers.DisplayAnnouncementVacantNumberRange. Accepte la saisie de données transmises via le pipeline pour les objets de numéro non affecté.

Types de retours

Cette cmdlet ne retourne aucune valeur. Elle modifie un objet de type Microsoft.Rtc.Management.Voice.Helpers.DisplayAnnouncementVacantNumberRange.

Exemple

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

Set-CsUnassignedNumber -Identity UNSet1 -NumberRangeStart "+14255551000" -NumberRangeEnd "+14255551900"

Cet exemple modifie la plage de numéros non affectés portant le nom UNSet1. Nous devons d'abord affecter au paramètre Identity la valeur UNSet1, soit le nom du numéro non affecté à modifier. Nous utilisons ensuite les paramètres NumberRangeStart (+14255551000) et NumberRangeEnd (+14255551900) pour modifier la plage des numéros non affectés auxquels s’appliquent l’annonce ou le standard automatique spécifié.

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

Get-CsUnassignedNumber | Where-Object {$_.AnnouncementName -match "Welcome"} | Set-CsUnassignedNumber -AnnouncementService ApplicationServer:redmond.litwareinc.com -AnnouncementName "Help Desk Announcement"

Cet exemple modifie l’annonce de tous les paramètres de la plage de numéros non affectés ayant actuellement une annonce dont le nom comporte la chaîne « Welcome ». Nous appelons d’abord Get-CsUnassignedNumber pour récupérer tous les paramètres de numéros non affectés. Nous redirigeons cette collection de paramètres vers Where-Object qui restreint la collection aux paramètres dont la propriété AnnouncementName contient (-match) la chaîne Welcome. Une fois ces paramètres définis, nous les redirigeons vers Set-CsUnassignedNumber où nous modifions l’ID de serveur d’application du service d’annonce (ApplicationServer:redmond.litwareinc.com) avec le paramètre AnnouncementService et le nom de la nouvelle annonce (Help Desk Announcement) avec le paramètre AnnouncementName. Notez que même si la nouvelle annonce porte un nom différent, mais le même ID de service, vous devez toujours spécifier l’ID de service avec le nom.