Set-UMDialplan

Articolo
08/07/2014

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"