Set-UMDialplan (RTM)
Si applica a: Exchange Server 2007
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>] [-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>] [-WelcomeGreetingEnabled <$true | $false>] [-WelcomeGreetingFilename <String>]
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>] [-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>] [-WelcomeGreetingEnabled <$true | $false>] [-WelcomeGreetingFilename <String>]
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 seguente delega:
- Ruolo Exchange Organization Administrator
Per ulteriori informazioni sulle autorizzazioni, sulla delega dei ruoli e sui diritti necessari per l'amministrazione di 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 è |
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 dei gruppi di composizione 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 è |
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 la funzionalità Chiamata è abilitata. |
ConfiguredInCountryOrRegionGroups |
Facoltativo |
Microsoft.Exchange.Data.MultiValuedProperty |
Questo parametro consente di specificare i gruppi nazionali utilizzabili. Ogni stringa è formata da quattro parti.
|
ConfiguredInternationalGroups |
Facoltativo |
Microsoft.Exchange.Data.MultiValuedProperty |
Questo parametro consente di specificare i gruppi internazionali utilizzabili. Ogni stringa è formata da quattro parti.
|
ContactAddressList |
Facoltativo |
Microsoft.Exchange.Configuration.Tasks.AddressListIdParameter |
Questo parametro consente di specificare l'identità dell'elenco 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 è SMTP. |
DomainController |
Facoltativo |
Microsoft.Exchange.Data.Fqdn |
Per specificare il nome di dominio completo (FQDN) del controller di dominio che consente di scrivere le modifiche alla configurazione nel servizio directory di Active Directory, includere nel cmdlet il parametro DomainController. |
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 è |
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 1440 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 è |
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. La configurazione può essere impostata su uno dei seguenti valori:
|
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. L'impostazione di questo valore può essere compresa tra 5 e 100. Se viene impostato un valore troppo basso, potrebbe verificarsi la disconnessione dei messaggi vocali lunghi prima che vengano completati. L'impostazione di un valore troppo alto consente agli utenti di salvare messaggi vocali lunghi nelle proprie cartelle Posta in arrivo. Per Exchange Server 2007 Service Pack 2 (SP2), il valore di questa impostazione può essere compreso tra 1 e 100. |
Nome |
Facoltativo |
System.String |
Questo parametro consente di specificare il nome da visualizzare nell'utilizzo del dial plan di messaggistica unificata. La lunghezza massima del nome è di 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 |
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 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 è |
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 canale di segnalazione verrà crittografato utilizzando MTLS (Mutual Transport Layer Security). L'impostazione predefinita è |
WelcomeGreetingEnabled |
Facoltativo |
System.Boolean |
Questo parametro consente di specificare se è abilitato un messaggio di benvenuto personalizzato. L'impostazione predefinita è |
WelcomeGreetingFilename |
Facoltativo |
System.String |
Questo parametro consente di specificare il nome del file audio del messaggio di benvenuto. |
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"