Condividi tramite


Set-UMDialplan

 

Si applica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Ultima modifica dell'argomento: 2012-03-26

Il cmdlet Set-UMDialplan può essere utilizzato per impostare varie proprietà per un dial plan di messaggistica unificata.

Sintassi

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

Descrizione dettagliata

Il cmdlet Set-UMDialplan consente di cambiare o modificare le proprietà di un dial plan di messaggistica unificata esistente. Alcune proprietà del dial plan di messaggistica unificata sono necessarie e vengono create per impostazione predefinita. Tuttavia, in alcuni casi, dopo la creazione del dial plan di messaggistica unificata, non è possibile scrivere tutte le proprietà del dial plan stesso. Pertanto, non è possibile cambiare alcune delle proprietà, a meno che il dial plan di messaggistica unificata esistente non venga eliminato e non ne venga creato uno nuovo.

Importante

I dial plan di messaggistica unificata sono rilevanti per le operazioni di messaggistica unificata. Le modifiche al dial plan di messaggistica unificata esistente devono essere eseguite da un amministratore che ne comprende le implicazioni.

Per eseguire il cmdlet Set-UMDialplan, è necessario utilizzare un account che disponga della delega del ruolo Exchange Organization Administrator.

Per ulteriori informazioni sulle autorizzazioni, sulla delega dei ruoli e sui diritti necessari per l'amministrazione di Microsoft Exchange Server 2007, vedere Considerazioni sulle autorizzazioni.

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter

Questo parametro consente di specificare l'ID del dial plan di messaggistica unificata. Questo parametro è l'identificatore dell'oggetto directory per il piano di messaggistica unificata. Il parametro viene utilizzato per collegare le cassette postali e i server Messaggistica unificata ai dial plan.

AccessTelephoneNumbers

Facoltativo

Microsoft.Exchange.Data.MultiValuedProperty

Questo parametro consente di specificare un singolo numero pilota di sistema di caselle vocali valido o un elenco di numeri pilota di sistema di caselle vocali validi. Questo elenco viene presentato all'amministratore quando è in corso l'abilitazione di un utente alla messaggistica unificata.

AllowDialPlanSubscribers

Facoltativo

System.Boolean

Questo parametro consente di specificare se consentire ai sottoscrittori di chiamare numeri che corrispondono a un altro sottoscrittore nell'ambito dello stesso dial plan. L'impostazione predefinita è $true.

AllowedInCountryOrRegionGroups

Facoltativo

Microsoft.Exchange.Data.MultiValuedProperty

Questo parametro consente di specificare l'elenco dei nomi nazionali dello stesso dial group che possono essere chiamati. Il nome del gruppo nazionale consentito deve corrispondere al nome di gruppo specificato nel dial plan di messaggistica unificata.

AllowedInternationalGroups

Facoltativo

Microsoft.Exchange.Data.MultiValuedProperty

Questo parametro consente di specificare l'elenco dei nomi di dial group internazionali consentiti. Il nome del dial group internazionale deve corrispondere al nome del gruppo specificato nel dial plan.

AllowExtensions

Facoltativo

System.Boolean

Questo parametro consente di specificare se sia possibile consentire le chiamate a interni del dial plan. L'impostazione predefinita è $false.

AudioCodec

Facoltativo

Microsoft.Exchange.Data.Directory.SystemConfiguration.AudioCodecEnum

Questo parametro consente di specificare il codec audio utilizzato per la registrazione. L'impostazione predefinita è WMA.

AutomaticSpeechRecognitionEnabled

Facoltativo

System.Boolean

Questo parametro consente di specificare se per i membri del dial plan deve essere abilitato il riconoscimento vocale.

CallSomeoneEnabled

Facoltativo

System.Boolean

Questo parametro consente di specificare se è abilitata la funzione Chiamata.

ConfiguredInCountryOrRegionGroups

Facoltativo

Microsoft.Exchange.Data.MultiValuedProperty

Questo parametro consente di specificare i gruppi nazionali utilizzabili. Ogni stringa è formata da quattro parti.

  • Nome del gruppo (massimo 32 caratteri)

  • AllowedNumberString

  • DialNumberString

  • TextComment

ConfiguredInternationalGroups

Facoltativo

Microsoft.Exchange.Data.MultiValuedProperty

Questo parametro consente di specificare i gruppi internazionali utilizzabili. Ogni stringa è formata da quattro parti.

  • Nome del gruppo (massimo 32 caratteri)

  • AllowedNumberString

  • DialNumberString

  • TextComment

Confirm

Facoltativo

System.Management.Automation.SwitchParameter

Questo parametro determina l'interruzione dell'elaborazione e richiede, prima che l'elaborazione continui, che l'amministratore confermi l'operazione che verrà eseguita dal comando. Il valore predefinito è $true.

ContactAddressList

Facoltativo

Microsoft.Exchange.Configuration.Tasks.AddressListIdParameter

Questo valore consente di specificare l'identità dell'elenco di indirizzi. Se si imposta il parametro ContactScope su AddressList, esso definirà l'obiettivo delle ricerche nella directory..

ContactRecipientContainer

Facoltativo

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

È il nome o l'identità del contenitore che verrà utilizzato per le ricerche sulla directory.

ContactScope

Facoltativo

Microsoft.Exchange.Data.Directory.SystemConfiguration.CallSomeoneScopeEnum

Questo parametro consente di specificare l'obiettivo della ricerca nella directory che viene fornita a chi chiama quando accede al dial plan di messaggistica unificata e specifica un nome utente.

CountryOrRegionCode

Facoltativo

System.String

Questo parametro consente di specificare il codice paese per un paese specifico. È il prefisso che verrà composto per un determinato paese. Ad esempio, per gli Stati Uniti si tratta del prefisso 1.

DefaultLanguage

Facoltativo

Microsoft.Exchange.Data.UMLanguage

Questo parametro consente di specificare la lingua predefinita del sistema. La lingua predefinita viene selezionata dall'elenco di quelle disponibili. L'impostazione predefinita è Inglese.

DialByNamePrimary

Facoltativo

Microsoft.Exchange.Data.Directory.SystemConfiguration.DialByNamePrimaryEnum

Questo parametro consente di specificare che la chiave di ricerca Metodo di composizione per nome deve essere creata a partire da un'origine specificata. L'impostazione predefinita è Cognome, Nome.

DialByNameSecondary

Facoltativo

Microsoft.Exchange.Data.Directory.SystemConfiguration.DialByNameSecondaryEnum

Questo parametro consente di specificare che la chiave di ricerca Metodo di composizione per nome deve essere creata a partire dall'origine specificata. L'impostazione predefinita è Simple Mail Transfer Protocol (SMTP).

DomainController

Facoltativo

Microsoft.Exchange.Data.Fqdn

Questo parametro consente di specificare il nome di dominio completo del controller di dominio che scrive questa modifica alla configurazione nel servizio directory di Active Directory.

EquivalenceDialPlan

Facoltativo

System.Guid

Questo parametro consente di specificare il nome del dial plan equivalente in un'altra foresta. Quando un dial plan telefonico si estende in due foreste e viene creato un secondo dial plan, il valore GUID del dial plan originale viene copiato nell'indirizzo proxy dell'utente nell'altra foresta.

Extension

Facoltativo

System.String

Questo parametro consente di specificare il numero interno utilizzato dalla funzione Chiamata quando si applica un trasferimento di chiamata.

FaxEnabled

Facoltativo

System.Boolean

Questo parametro consente di specificare se il sistema supporta i messaggi via fax. Se il dial plan non supporta i messaggi via fax, il server Messaggistica unificata non carica i componenti del fax. L'impostazione predefinita è $true.

FDSPollingInterval

Facoltativo

System.Int32

Intervallo, in minuti, tra i controlli per nuovi contenuti eseguiti dal servizio distribuzione file nel punto di pubblicazione. L'intervallo va da 1 a 1.440 minuti. L'impostazione predefinita è 5 minuti.

InCountryOrRegionNumberFormat

Facoltativo

Microsoft.Exchange.Data.NumberFormat

Questo parametro consente di specificare la stringa di prefisso da utilizzare e il numero delle cifre da estrarre dalla directory. Questo numero viene utilizzato durante l'esecuzione delle chiamate di questo dial plan nell'ambito dello stesso codice paese.

InfoAnnouncementEnabled

Facoltativo

Microsoft.Exchange.Data.Directory.SystemConfiguration.InfoAnnouncementEnabledEnum

Questo parametro consente di specificare se è abilitato un annuncio informativo. È possibile impostare questo parametro su Abilitato, Disabilitato o Non interrompibile. L'impostazione predefinita è $true.

InfoAnnouncementFilename

Facoltativo

System.String

Questo parametro consente di specificare il nome del file audio relativo a un annuncio informativo.

InputFailuresBeforeDisconnect

Facoltativo

System.Int32

Questo parametro consente di specificare il numero di errori di immissioni sequenziali dell'utente consentito prima della disconnessione della chiamata. L'impostazione predefinita è 3.

InputRetries

Facoltativo

System.Int32

Questo parametro consente di specificare il numero di volte in cui l'utente può rieseguire l'immissione dopo il timeout del sistema. Il parametro si applica a utenti autenticati e anche a utenti che rispondono con risponditore o con operatore automatico. L'impostazione predefinita è 3.

InputTimeout

Facoltativo

System.Int32

Questo parametro consente di specificare il periodo di tempo in cui il sistema attende l'immissione da parte dell'utente. Questo limite di tempo si applica a utenti autenticati e anche a utenti che rispondono con risponditore o con operatore automatico. L'impostazione predefinita è 5 secondi.

Instance

Facoltativo

Microsoft.Exchange.Data.Directory.SystemConfiguration.UMDialPlan

Questo parametro consente di specificare il parametro di immissione che rappresenta un nuovo oggetto dial plan.

InternationalAccessCode

Facoltativo

System.String

Questo parametro consente di specificare il codice che viene premesso a un numero di telefono per le chiamate internazionali. Ad esempio, per gli Stati Uniti si tratta del prefisso 011.

InternationalNumberFormat

Facoltativo

Microsoft.Exchange.Data.NumberFormat

Questo parametro consente di specificare la stringa prefisso da utilizzare e il numero di cifre da estrarre dalla directory, quando si esegue una chiamata, in questo dial plan, da un codice di paese diverso.

LogonFailuresBeforeDisconnect

Facoltativo

System.Int32

Questo parametro consente di specificare il numero di tentativi sequenziali falliti dall'utente consentiti prima della disconnessione della chiamata. L'impostazione predefinita è 3.

MatchedNameSelectionMethod

Facoltativo

Microsoft.Exchange.Data.Directory.SystemConfiguration.DisambiguationFieldEnum

Questo parametro consente di specificare la selezione da utilizzare per diversificare utenti con nomi che corrispondono all'immissione da tastiera o vocale. Le impostazioni possibili sono le seguenti:

  • Department

  • Title

  • Posizione

  • Nessuno

  • Richiedi alias

  • Ereditato dal dial plan di messaggistica unificata

MaxCallDuration

Facoltativo

System.Int32

Questo parametro consente di specificare il periodo di tempo massimo di durata di una chiamata prima che venga interrotta e la chiamata termini. L'impostazione predefinita è 30 minuti.

MaxRecordingDuration

Facoltativo

System.Int32

Questo parametro consente di specificare il periodo di tempo massimo di registrazione di un messaggio. Questo parametro include tutti i tipi di chiamate. Per questo valore è possibile impostare un numero compreso tra 5 e 100. L'impostazione di un valore troppo basso può causare la disconnessione dei messaggi vocali lunghi prima che il chiamante abbia finito di registrarli. L'impostazione di un valore troppo alto consente agli utenti di salvare messaggi vocali lunghi nelle proprie cartelle Posta in arrivo.

Per Exchange 2007 Service Pack 2 (SP2), il valore di questa impostazione può essere compreso tra 1 e 100. 

Name

Facoltativo

System.String

Questo parametro consente di specificare il nome da visualizzare nell'utilizzo del dial plan di messaggistica unificata. Il nome non deve superare i 64 caratteri.

NationalNumberPrefix

Facoltativo

System.String

Questo parametro consente di specificare il codice che viene premesso a un numero di telefono per le chiamate interurbane nazionali. Ad esempio, per il Nord America è 1.

NDREnabled

Facoltativo

System.Boolean

Questo parametro consente di specificare se i messaggi del risponditore automatico di messaggistica unificata richiedono rapporti di mancato recapito (Non-Delivery Reports, NDR). Se il parametro viene impostato su $false, i messaggi verranno inviati senza richieste di rapporti di mancato recapito. L'impostazione predefinita è $false.

OperatorExtension

Facoltativo

System.String

Questo parametro consente di specificare il numero di interno dell'operatore. Se non si specifica questo parametro, la funzione per impedire il trasferimento all'operatore non sarà disponibile.

OutsideLineAccessCode

Facoltativo

System.String

Questo parametro consente di specificare il codice da premettere a un numero di telefono per le chiamate a un numero di telefono esterno nazionale. Questo codice viene anche denominato codice di accesso a linea interurbana. L'impostazione predefinita è 9.

PromptPublishingPoint

Facoltativo

System.String

Questo parametro consente di specificare il percorso delle condivisioni di file Microsoft Windows del server e comunica la posizione dei prompt personalizzati. Il percorso predefinito viene impostato sul primo server Messaggistica unificata aggiunto al dial plan.

RecordingIdleTimeout

Facoltativo

System.Int32

Questo parametro consente di specificare il periodo di tempo in cui chi esegue la chiamata può rimanere in silenzio mentre sta registrando un messaggio vocale, prima che la registrazione venga terminata. L'impostazione predefinita è 5 secondi.

SendVoiceMsgEnabled

Facoltativo

System.Boolean

Questo parametro consente di specificare se è abilitata la funzione di invio dei messaggi.

TUIPromptEditingEnabled

Facoltativo

System.Boolean

Questo parametro consente di specificare se agli utenti autorizzati è consentito registrare istruzioni vocali di dial plan o di operatore automatico utilizzando l'interfaccia utente telefonica (Telephone User Interface, TUI). L'impostazione predefinita è $false.

UMAutoAttendant

Facoltativo

Microsoft.Exchange.Configuration.Tasks.UMAutoAttendantIdParameter

Questo parametro consente di specificare l'operatore automatico eseguito quando chi esegue la chiamata preme il tasto asterisco (*). Se si specifica questo parametro, esso ha la precedenza sulla funzione Chiamata.

VoIPSecurity

Facoltativo

Microsoft.Exchange.Data.Directory.SystemConfiguration.UMVoIPSecurityType

Questo parametro consente di specificare se il traffico VoIP non è crittografato oppure che il canale di segnalazione o la segnalazione e i canali dei supporti sono crittografati con Mutual Transport Layer Security (MTLS). L'impostazione predefinita è UnSecured.

WelcomeGreetingEnabled

Facoltativo

System.Boolean

Questo parametro consente di specificare se è abilitato un messaggio di benvenuto personalizzato. L'impostazione predefinita è $false.

WelcomeGreetingFilename

Facoltativo

System.String

Questo parametro consente di specificare il nome del file audio del messaggio di benvenuto.

WhatIf

Facoltativo

System.Management.Automation.SwitchParameter

Questo parametro consente al comando di simulare le azioni da intraprendere sull'oggetto. Utilizzando il parametro WhatIf, l'amministratore può visualizzare quali sono le modifiche che verrebbero apportate senza applicarle. Il valore predefinito è $true.

Tipi di input

Tipi restituiti

Errori

Errore Descrizione

 

 

Eccezioni

Eccezioni Descrizione

 

 

Esempio

Nel primo esempio viene configurato un dial plan di messaggistica unificata denominato MyUMDialPlan che utilizza il valore 9 per il codice di accesso alla linea esterna.

Nel secondo esempio viene configurato un dial plan denominato MyUMDialPlan per utilizzare un messaggio di benvenuto.

Nel terzo esempio viene configurato un dial plan di messaggistica unificata denominato MyUMDialPlan con regole di composizione.

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"