Set-UMDialplan

 

S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

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

La cmdlet Set-UMDialplan permet de définir diverses propriétés sur un plan de commutation des appels de messagerie unifiée (MU).

Syntaxe

Set-UMDialPlan -Identity <UMDialPlanIdParameter> [-AccessTelephoneNumbers <MultiValuedProperty>] [-AllowDialPlanSubscribers <$true | $false>] [-AllowedInCountryOrRegionGroups <MultiValuedProperty>] [-AllowedInternationalGroups <MultiValuedProperty>] [-AllowExtensions <$true | $false>] [-AudioCodec <G711 | Wma | Gsm>] [-AutomaticSpeechRecognitionEnabled <$true | $false>] [-CallSomeoneEnabled <$true | $false>] [-ConfiguredInCountryOrRegionGroups <MultiValuedProperty>] [-ConfiguredInternationalGroups <MultiValuedProperty>] [-Confirm [<SwitchParameter>]] [-ContactAddressList <AddressListIdParameter>] [-ContactRecipientContainer <OrganizationalUnitIdParameter>] [-ContactScope <DialPlan | GlobalAddressList | Extension | AutoAttendantLink | AddressList>] [-CountryOrRegionCode <String>] [-DefaultLanguage <UMLanguage>] [-DialByNamePrimary <LastFirst | FirstLast | SMTPAddress>] [-DialByNameSecondary <LastFirst | FirstLast | SMTPAddress | None>] [-DomainController <Fqdn>] [-EquivalenceDialPlan <Guid>] [-Extension <String>] [-FaxEnabled <$true | $false>] [-FDSPollingInterval <Int32>] [-InCountryOrRegionNumberFormat <NumberFormat>] [-InfoAnnouncementEnabled <True | False | Uninteruptible>] [-InfoAnnouncementFilename <String>] [-InputFailuresBeforeDisconnect <Int32>] [-InputRetries <Int32>] [-InputTimeout <Int32>] [-InternationalAccessCode <String>] [-InternationalNumberFormat <NumberFormat>] [-LogonFailuresBeforeDisconnect <Int32>] [-MatchedNameSelectionMethod <Title | Department | Location | None | PromptForAlias>] [-MaxCallDuration <Int32>] [-MaxRecordingDuration <Int32>] [-Name <String>] [-NationalNumberPrefix <String>] [-NDREnabled <$true | $false>] [-OperatorExtension <String>] [-OutsideLineAccessCode <String>] [-PromptPublishingPoint <String>] [-RecordingIdleTimeout <Int32>] [-SendVoiceMsgEnabled <$true | $false>] [-TUIPromptEditingEnabled <$true | $false>] [-UMAutoAttendant <UMAutoAttendantIdParameter>] [-VoIPSecurity <SIPSecured | Unsecured | Secured>] [-WelcomeGreetingEnabled <$true | $false>] [-WelcomeGreetingFilename <String>] [-WhatIf [<SwitchParameter>]]

Set-UMDialPlan [-AccessTelephoneNumbers <MultiValuedProperty>] [-AllowDialPlanSubscribers <$true | $false>] [-AllowedInCountryOrRegionGroups <MultiValuedProperty>] [-AllowedInternationalGroups <MultiValuedProperty>] [-AllowExtensions <$true | $false>] [-AudioCodec <G711 | Wma | Gsm>] [-AutomaticSpeechRecognitionEnabled <$true | $false>] [-CallSomeoneEnabled <$true | $false>] [-ConfiguredInCountryOrRegionGroups <MultiValuedProperty>] [-ConfiguredInternationalGroups <MultiValuedProperty>] [-Confirm [<SwitchParameter>]] [-ContactAddressList <AddressListIdParameter>] [-ContactRecipientContainer <OrganizationalUnitIdParameter>] [-ContactScope <DialPlan | GlobalAddressList | Extension | AutoAttendantLink | AddressList>] [-CountryOrRegionCode <String>] [-DefaultLanguage <UMLanguage>] [-DialByNamePrimary <LastFirst | FirstLast | SMTPAddress>] [-DialByNameSecondary <LastFirst | FirstLast | SMTPAddress | None>] [-DomainController <Fqdn>] [-EquivalenceDialPlan <Guid>] [-Extension <String>] [-FaxEnabled <$true | $false>] [-FDSPollingInterval <Int32>] [-InCountryOrRegionNumberFormat <NumberFormat>] [-InfoAnnouncementEnabled <True | False | Uninteruptible>] [-InfoAnnouncementFilename <String>] [-InputFailuresBeforeDisconnect <Int32>] [-InputRetries <Int32>] [-InputTimeout <Int32>] [-Instance <UMDialPlan>] [-InternationalAccessCode <String>] [-InternationalNumberFormat <NumberFormat>] [-LogonFailuresBeforeDisconnect <Int32>] [-MatchedNameSelectionMethod <Title | Department | Location | None | PromptForAlias>] [-MaxCallDuration <Int32>] [-MaxRecordingDuration <Int32>] [-Name <String>] [-NationalNumberPrefix <String>] [-NDREnabled <$true | $false>] [-OperatorExtension <String>] [-OutsideLineAccessCode <String>] [-PromptPublishingPoint <String>] [-RecordingIdleTimeout <Int32>] [-SendVoiceMsgEnabled <$true | $false>] [-TUIPromptEditingEnabled <$true | $false>] [-UMAutoAttendant <UMAutoAttendantIdParameter>] [-VoIPSecurity <SIPSecured | Unsecured | Secured>] [-WelcomeGreetingEnabled <$true | $false>] [-WelcomeGreetingFilename <String>] [-WhatIf [<SwitchParameter>]]

Description détaillée

La cmdlet Set-UMDialplan permet de modifier les propriétés d'un plan de commutation des appels de MU existant. Certaines propriétés du plan de commutation des appels de MU sont obligatoires et sont créées par défaut. Toutefois, dans certains cas, une fois le plan de commutation des appels de MU créé, les propriétés du plan de commutation des appels de MU ne peuvent pas toutes être écrites. C'est pourquoi il est impossible de modifier certaines propriétés, à moins de supprimer le plan de commutation des appels de MU existant et d'en créer un autre.

importantImportant :
Les plans de commutation des appels de messagerie unifiée jouent un rôle crucial dans le fonctionnement de la messagerie unifiée. Les modifications d'un plan de commutation des appels de MU existant doivent être effectuées par un administrateur qui en comprend les implications.

Pour exécuter la cmdlet Set-UMDialplan, vous devez utiliser un compte auquel le rôle Administrateur des destinataires Exchange a été délégué.

Pour plus d'informations sur les autorisations, la délégation de rôles et les droits requis pour administrer Microsoft Exchange Server 2007, consultez la rubrique Considérations relatives aux autorisations.

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter

Ce paramètre spécifie l'ID de plan de commutation des appels de MU. Ce paramètre constitue l'identificateur d'objet d'annuaire pour le plan de commutation des appels de MU. Ce paramètre permet de lier des boîtes aux lettres et des serveurs de messagerie unifiée à des plans de commutation des appels.

AccessTelephoneNumbers

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Ce paramètre spécifie un numéro valide unique de pilote de messagerie vocale ou une liste de numéros valides de pilote de messagerie vocale. Cette liste est présentée à l'administrateur quand un utilisateur est en cours d'activation pour la messagerie unifiée.

AllowDialPlanSubscribers

Facultatif

System.Boolean

Ce paramètre spécifie d'autoriser ou non les abonnés à appeler des numéros correspondant à un abonné au même plan de commutation des appels. La valeur par défaut est $true.

AllowedInCountryOrRegionGroups

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Ce paramètre spécifie la liste de noms nationaux/régionaux du même groupe de numérotation qui peuvent être appelés. Le nom du groupe national/régional autorisé doit correspondre au nom de groupe spécifié dans le plan de commutation des appels de MU.

AllowedInternationalGroups

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Ce paramètre spécifie la liste de noms de groupes de numérotation internationaux autorisés. Le nom de groupe de numérotation international doit correspondre au nom de groupe spécifié dans le plan de commutation des appels.

AllowExtensions

Facultatif

System.Boolean

Ce paramètre spécifie d'autoriser ou non les appels vers des postes de plan de commutation des appels. La valeur par défaut est $false.

AudioCodec

Facultatif

Microsoft.Exchange.Data.Directory.SystemConfiguration.AudioCodecEnum

Ce paramètre spécifie le codec audio utilisé pour l'enregistrement. Le paramètre par défaut est WMA.

AutomaticSpeechRecognitionEnabled

Facultatif

System.Boolean

Ce paramètre spécifie si la reconnaissance vocale est activée pour les utilisateurs membres du plan de commutation des appels.

CallSomeoneEnabled

Facultatif

System.Boolean

Ce paramètre spécifie si la fonction Appel de personne est activée.

ConfiguredInCountryOrRegionGroups

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Ce paramètre spécifie les groupes nationaux qui peuvent être utilisés. Chaque chaîne comprend quatre parties :

  • un nom de groupe (jusqu'à 32 caractères) ;

  • AllowedNumberString

  • DialNumberString

  • TextComment

ConfiguredInternationalGroups

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Ce paramètre spécifie les groupes internationaux qui peuvent être utilisés. Chaque chaîne comprend quatre parties :

  • Un nom de groupe (jusqu'à 32 caractères)

  • AllowedNumberString

  • DialNumberString

  • TextComment

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Ce paramètre suspend le traitement par la commande et demande à l'administrateur de confirmer les actions que la commande va effectuer avant de continuer le traitement. La valeur par défaut est $true.

ContactAddressList

Facultatif

Microsoft.Exchange.Configuration.Tasks.AddressListIdParameter

Ce paramètre spécifie l'identité de la liste d'adresses. Si le paramètre ContactScope est défini sur AddressList, il définit la portée des recherches dans l'annuaire.

ContactRecipientContainer

Facultatif

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Il s'agit du nom ou de l'identité du conteneur à utiliser pour les recherches dans l'annuaire.

ContactScope

Facultatif

Microsoft.Exchange.Data.Directory.SystemConfiguration.CallSomeoneScopeEnum

Ce paramètre spécifie la portée de la recherche dans l'annuaire qui est autorisée pour les appelants lorsqu'ils accèdent au plan de commutation des appels de MU en spécifiant un nom d'utilisateur.

CountryOrRegionCode

Facultatif

System.String

Ce paramètre spécifie le code d'un pays ou d'une région donné. Il s'agit du numéro composé pour un pays ou une région spécifique. Par exemple, 1 pour les États-Unis.

DefaultLanguage

Facultatif

Microsoft.Exchange.Data.UMLanguage

Ce paramètre spécifie la langue par défaut du système. La langue par défaut est sélectionnée dans la liste des langues disponibles. La langue par défaut est l'anglais É.U.

DialByNamePrimary

Facultatif

Microsoft.Exchange.Data.Directory.SystemConfiguration.DialByNamePrimaryEnum

Ce paramètre spécifie que la clé de recherche Numérotation par nom doit être créée à partir de la source spécifiée. La valeur par défaut est Nom, Prénom.

DialByNameSecondary

Facultatif

Microsoft.Exchange.Data.Directory.SystemConfiguration.DialByNameSecondaryEnum

Ce paramètre spécifie que la clé de recherche secondaire Numérotation par nom doit être créée à partir de la source spécifiée. Le paramétrage par défaut est SMTP (Simple Mail Transfer Protocol).

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Ce paramètre spécifie le nom de domaine complet du contrôleur de domaine qui écrit ce changement de configuration dans le service d'annuaire Active Directory.

EquivalenceDialPlan

Facultatif

System.Guid

Ce paramètre spécifie le nom du plan de commutation des appels de MU équivalent dans une autre forêt. Si un plan de commutation des appels par téléphone couvre deux forêts et qu'un deuxième objet plan de commutation des appels est créé, le GUID du plan de commutation des appels original est copié vers l'adresse proxy de l'utilisateur dans l'autre forêt.

Extension

Facultatif

System.String

Ce paramètre spécifie le numéro de poste utilisé par la fonction Appel de personne en cas de transfert d'appel.

FaxEnabled

Facultatif

System.Boolean

Ce paramètre spécifie si le système prend en charge les télécopies. Le serveur de messagerie unifiée ne charge pas les composants de télécopie si le plan de commutation des appels ne prend pas en charge les télécopies. La valeur par défaut est $true.

FDSPollingInterval

Facultatif

System.Int32

Il s'agit de l'intervalle, exprimé en minutes, entre les contrôles de nouveau contenu effectués par le service de distribution de fichiers au point de publication. La plage s'étend de 1 à 1 440 minutes. La valeur par défaut est 5 minutes.

InCountryOrRegionNumberFormat

Facultatif

Microsoft.Exchange.Data.NumberFormat

Ce paramètre spécifie la chaîne de préfixe à utiliser et le nombre de chiffres à prélever dans l'annuaire. Ce nombre est utilisé en cas d'appel, dans ce plan de commutation des appels, du même code de pays ou de région.

InfoAnnouncementEnabled

Facultatif

Microsoft.Exchange.Data.Directory.SystemConfiguration.InfoAnnouncementEnabledEnum

Ce paramètre spécifie si un message d'information automatique est activé. Ce paramètre peut être défini sur Activé, Désactivé ou Ininterruptible. La valeur par défaut est $true.

InfoAnnouncementFilename

Facultatif

System.String

Ce paramètre spécifie le nom de fichier audio pour un message d'information automatique.

InputFailuresBeforeDisconnect

Facultatif

System.Int32

Ce paramètre spécifie le nombre d'erreurs d'entrée de l'utilisateur successives autorisées avant la déconnexion de l'appel. La valeur par défaut est 3.

InputRetries

Facultatif

System.Int32

Ce paramètre spécifie le nombre de fois qu'un appelant peut répéter une entrée une fois le délai d'attente du système expiré. Il s'applique aux utilisateurs authentifiés ainsi qu'aux utilisateurs de répondeur automatique et de standard automatique. La valeur par défaut est 3.

InputTimeout

Facultatif

System.Int32

Ce paramètre spécifie le délai pendant lequel le système attend une entrée de l'utilisateur. Cette limite de temps s'applique aux utilisateurs authentifiés ainsi qu'aux utilisateurs de répondeur automatique et de standard automatique. La valeur par défaut est 5 secondes.

Instance

Facultatif

Microsoft.Exchange.Data.Directory.SystemConfiguration.UMDialPlan

Ce paramètre spécifie le paramètre d'entrée qui représente un nouvel objet plan de commutation des appels.

InternationalAccessCode

Facultatif

System.String

Ce paramètre spécifie le code ajouté devant un numéro de téléphone pour les appels internationaux. Par exemple, 011 pour les États-Unis.

InternationalNumberFormat

Facultatif

Microsoft.Exchange.Data.NumberFormat

Ce paramètre spécifie la chaîne de préfixe à utiliser et le nombre de chiffres à prélever dans l'annuaire en cas d'appel du plan de commutation des appels depuis un autre code de pays.

LogonFailuresBeforeDisconnect

Facultatif

System.Int32

Ce paramètre spécifie le nombre de tentatives d'ouverture de session infructueuses successives autorisées avant la déconnexion de l'appel. La valeur par défaut est 3.

MatchedNameSelectionMethod

Facultatif

Microsoft.Exchange.Data.Directory.SystemConfiguration.DisambiguationFieldEnum

Ce paramètre spécifie la sélection à utiliser pour différencier les utilisateurs dont les noms correspondent aux entrées par tonalité ou signaux vocaux. Ce paramètre peut avoir l'une des valeurs suivantes :

  • Department

  • Title

  • Emplacement

  • Aucun

  • Demander l'alias

  • Hérité du plan de commutation des appels de messagerie unifiée

MaxCallDuration

Facultatif

System.Int32

Ce paramètre spécifie la durée maximale d'un appel avant son interruption et son abandon. La valeur par défaut est 30 minutes.

MaxRecordingDuration

Facultatif

System.Int32

Ce paramètre spécifie le temps maximal pendant lequel des messages peuvent être enregistrés. Il affecte tous les types d'appel. Cette valeur est comprise entre 5 et 100. Choisir une valeur trop basse peut entraîner la déconnexion des messages vocaux longs avant que ceux-ci ne soient terminés. Choisir une valeur trop élevée permet aux utilisateurs d'enregistrer des messages vocaux relativement longs dans leur boîte de réception.

Dans Exchange 2007 Service Pack 2 (SP2), la valeur de ce paramètre est comprise entre 1 et 100.

Name

Facultatif

System.String

Ce paramètre spécifie le nom complet à utiliser pour le plan de commutation des appels de MU. Ce nom est limité à 64 caractères.

NationalNumberPrefix

Facultatif

System.String

Ce paramètre spécifie le code ajouté devant un numéro de téléphone pour les appels nationaux hors zone. Par exemple, 1 en Amérique du Nord.

NDREnabled

Facultatif

System.Boolean

Ce paramètre spécifie si les messages de répondeur automatique de MU qui sont soumis requièrent des notifications d'échec de remise. Si ce paramètre est défini sur $false, les messages sont soumis sans demandes de notification d'échec de remise. La valeur par défaut est $false.

OperatorExtension

Facultatif

System.String

Ce paramètre spécifie le numéro de poste pour l'opérateur. Si ce paramètre n'est pas spécifié, la fonction Ne pas autoriser le transfert à l'opérateur n'est pas disponible.

OutsideLineAccessCode

Facultatif

System.String

Ce paramètre spécifie le code ajouté devant un numéro de téléphone pour appeler un numéro de téléphone national externe. Ce code est également appelé code d'accès spécialisé. La valeur par défaut est 9.

PromptPublishingPoint

Facultatif

System.String

Ce paramètre spécifie le chemin d'accès des partages de fichiers Microsoft Windows du serveur et du partage où les messages d'assistance vocale personnalisés résideront. Le chemin par défaut est celui du premier serveur de messagerie unifiée lorsqu'il est ajouté à un plan de commutation des appels de messagerie unifiée.

RecordingIdleTimeout

Facultatif

System.Int32

Ce paramètre spécifie le délai pendant lequel un appelant peut se taire lors de l'enregistrement d'un message vocal avant que l'enregistrement ne soit interrompu. La valeur par défaut est 5 secondes.

SendVoiceMsgEnabled

Facultatif

System.Boolean

Ce paramètre spécifie si la fonction Envoi de messages est activée.

TUIPromptEditingEnabled

Facultatif

System.Boolean

Ce paramètre spécifie si des utilisateurs autorisés peuvent enregistrer un plan de commutation des appels de MU ou des messages d'assistance vocale de standard automatique via l'interface utilisateur de téléphonie (TUI). Le paramètre par défaut est $false.

UMAutoAttendant

Facultatif

Microsoft.Exchange.Configuration.Tasks.UMAutoAttendantIdParameter

Ce paramètre spécifie le standard automatique exécuté lorsque l'appelant appuie sur la touche étoile (*). Si ce paramètre est spécifié, il remplace la fonction Appel de personne.

VoIPSecurity

Facultatif

Microsoft.Exchange.Data.Directory.SystemConfiguration.UMVoIPSecurityType

Ce paramètre spécifie si le trafic VoIP (Voice over IP) n'est pas chiffré ou que le canal de signalisation ou les canaux de signalisation et de médias sont chiffrés à l'aide du service MTLS (Mutual Transport Layer Security). Le paramètre par défaut est UnSecured.

WelcomeGreetingEnabled

Facultatif

System.Boolean

Ce paramètre spécifie si un message d'accueil personnalisé est activé. La valeur par défaut est $false.

WelcomeGreetingFilename

Facultatif

System.String

Ce paramètre spécifie le nom de fichier audio pour le message d'accueil.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

Ce paramètre donne pour instruction à la commande de simuler les actions qu'elle va appliquer à l'objet. Grâce au paramètre WhatIf, l'administrateur peut afficher les changements potentiels sans devoir les appliquer. La valeur par défaut est $true.

Types d'entrées

Types de retours

Erreurs

Erreur Description

 

 

Exceptions

Exceptions Description

 

 

Exemple

Le premier exemple configure un plan de commutation des appels de messagerie unifiée nommé MyUMDialPlan afin qu’il utilise 9 comme code d'accès à une ligne extérieure.

Le deuxième exemple configure un plan de commutation des appels de messagerie unifiée nommé MyUMDialPlan afin qu’il utilise un message de bienvenue.

Le troisième exemple configure un plan de commutation des appels de messagerie unifiée nommé MyUMDialPlan avec des règles de numérotation.

Set-UMDialPlan -Identity MyDialPlan -OutsideLineAccessCode 9

Set-UMDialPlan -Identity MyDialPlan -WelcomeGreetingEnabled $true -WelcomeGreetingFilename welcome.wav

$csv=import-csv "C:\MyInCountryGroups.csv"
Set-UMDialPlan -Identity MyDialPlan -ConfiguredInCountryGroups $csv
Set-UMDialPlan -Identity MyDialPlan -AllowedInCountryGroups "local, long distance"