Set-UMDialplan

Artikel
09/29/2014

Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Letztes Änderungsdatum des Themas: 2012-03-26

Mit dem Cmdlet Set-UMDialplan können Sie verschiedene Eigenschaften eines UM-Wählplans (Unified Messaging) festlegen.

Syntax

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

Detaillierte Beschreibung

Mit dem Cmdlet Set-UMDialplan können Sie die Eigenschaften eines vorhandenen UM-Wählplans ändern. Manche UM-Wählplaneigenschaften sind erforderlich und werden standardmäßig erstellt. In einigen Fällen sind jedoch manche Eigenschaften des UM-Wählplans nach dessen Erstellung schreibgeschützt. Deshalb können manche der Einstellungen nur geändert werden, indem der vorhandene UM-Wählplan gelöscht und ein neuer erstellt wird.

Wichtig

UM-Wählpläne sind wichtig für die Ausführung von Unified Messaging. Änderungen an einem vorhandenen UM-Wählplan sollten nur von Administratoren ausgeführt werden, die die Auswirkungen von Änderungen an UM-Wählplänen überblicken.

Damit Sie das Cmdlet Set-UMDialplan ausführen können, muss dem Konto die Rolle Exchange-Organisationsadministrator zugewiesen worden sein.

Weitere Informationen zu Berechtigungen, zum Delegieren von Rollen und zu den Rechten, die für die Verwaltung von Microsoft Exchange Server 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.

Parameter

Parameter	Erforderlich	Typ	Beschreibung
Identity	Erforderlich	Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter	Dieser Parameter gibt die UM-Wählplan-ID an. Bei dem Parameter handelt es sich um den Verzeichnisobjektkennzeichner für den UM-Wählplan. Mit diesem Parameter werden Postfächer und Unified Messaging-Server mit Wählplänen verknüpft.
AccessTelephoneNumbers	Optional	Microsoft.Exchange.Data.MultiValuedProperty	Dieser Parameter gibt eine einzelne gültige Voicemail-Pilotnummer oder eine Liste gültiger Voicemail-Pilotnummern an. Diese Liste wird dem Administrator angezeigt, wenn ein Benutzer für Unified Messaging aktiviert wird.
AllowDialPlanSubscribers	Optional	System.Boolean	Dieser Parameter gibt an, ob Teilnehmer Nummern wählen dürfen, die für einen Teilnehmer innerhalb desselben Wählplans stehen. Der Standardwert lautet `$true`.
AllowedInCountryOrRegionGroups	Optional	Microsoft.Exchange.Data.MultiValuedProperty	Dieser Parameter gibt die Liste mit nationalen bzw. regionalen Namen derselben Wählgruppe an, die gewählt werden können. Der Name der zugelassenen nationalen bzw. regionalen Gruppe muss dem im UM-Wählplan angegebenen Gruppennamen entsprechen.
AllowedInternationalGroups	Optional	Microsoft.Exchange.Data.MultiValuedProperty	Dieser Parameter gibt die Liste der zugelassenen internationalen Wählgruppennamen an. Der Name der internationalen Wählgruppe muss dem im Wählplan angegebenen Gruppennamen entsprechen.
AllowExtensions	Optional	System.Boolean	Dieser Parameter gibt an, ob Anrufe an Wählplandurchwahlen zugelassen werden sollen. Der Standardwert lautet `$false`.
AudioCodec	Optional	Microsoft.Exchange.Data.Directory.SystemConfiguration.AudioCodecEnum	Dieser Parameter gibt den Audiocodec an, der für Aufzeichnungen verwendet wird. Die Standardeinstellung ist WMA.
AutomaticSpeechRecognitionEnabled	Optional	System.Boolean	Dieser Parameter gibt an, ob Spracherkennung für die Benutzer aktiviert ist, die Mitglieder des Wählplans sind.
CallSomeoneEnabled	Optional	System.Boolean	Dieser Parameter gibt an, ob die Funktion "Anruf für unbestimmte Person" aktiviert ist.
ConfiguredInCountryOrRegionGroups	Optional	Microsoft.Exchange.Data.MultiValuedProperty	Dieser Parameter gibt die nationalen Gruppen an, die verwendet werden können. Jede Zeichenfolge besteht aus vier Teilen: Einem Gruppennamen (bis zu 32 Zeichen) AllowedNumberString DialNumberString TextComment
ConfiguredInternationalGroups	Optional	Microsoft.Exchange.Data.MultiValuedProperty	Dieser Parameter gibt die internationalen Gruppen an, die verwendet werden können. Jede Zeichenfolge besteht aus vier Teilen: Einem Gruppennamen (bis zu 32 Zeichen) AllowedNumberString DialNumberString TextComment
Confirm	Optional	System.Management.Automation.SwitchParameter	Dieser Parameter bewirkt eine Unterbrechung der Befehlsausführung und zwingt den Administrator, die Aktion des Befehls zu bestätigen, bevor die Verarbeitung fortgesetzt wird. Der Standardwert lautet "$true".
ContactAddressList	Optional	Microsoft.Exchange.Configuration.Tasks.AddressListIdParameter	Dieser Wert gibt die Identität der Adressliste an. Wenn der Parameter ContactScope auf AddressList festgelegt ist, wird durch ihn der Bereich für Verzeichnissuchen definiert.
ContactRecipientContainer	Optional	Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter	Dies ist der Name oder die Identität des Containers, der für Verzeichnissuchen verwendet wird.
ContactScope	Optional	Microsoft.Exchange.Data.Directory.SystemConfiguration.CallSomeoneScopeEnum	Dieser Parameter gibt den Bereich der Verzeichnissuche an, der Anrufern vorgegeben wird, wenn diese auf den UM-Wählplan zugreifen und einen Benutzernamen angeben.
CountryOrRegionCode	Optional	System.String	Dieser Parameter gibt den Länder-/Regionscode für ein vorgegebenes Land an. Dies ist die Nummer, die für ein bestimmtes Land oder eine bestimmte Region vorgewählt wird. In den Vereinigten Staaten ist dies beispielsweise die "1".
DefaultLanguage	Optional	Microsoft.Exchange.Data.UMLanguage	Dieser Parameter gibt die Standardsprache des Systems an. Die Standardsprache wird aus der Liste der verfügbaren Sprachen ausgewählt. Die Standardeinstellung ist "Englisch (USA)".
DialByNamePrimary	Optional	Microsoft.Exchange.Data.Directory.SystemConfiguration.DialByNamePrimaryEnum	Dieser Parameter gibt an, dass der Suchschlüssel für "Wahl nach Namen" aus der angegebenen Quelle erstellt werden soll. Der Standard ist "Nach-, Vorname".
DialByNameSecondary	Optional	Microsoft.Exchange.Data.Directory.SystemConfiguration.DialByNameSecondaryEnum	Dieser Parameter gibt an, dass der sekundäre Suchschlüssel für "Wahl nach Namen" aus der angegebenen Quelle erstellt werden soll. Der Standardwert ist SMTP (Simple Mail Transfer Protocol).
DomainController	Optional	Microsoft.Exchange.Data.Fqdn	Dieser Parameter gibt den vollqualifizierten Domänennamen des Domänencontrollers an, der diese Konfigurationsänderung in den Active Directory-Verzeichnisdienst schreibt.
EquivalenceDialPlan	Optional	System.Guid	Dieser Parameter gibt den Namen des entsprechenden Äquivalenzwählplans in einer anderen Gesamtstruktur an. Wenn ein Telefoniewählplan zwei Gesamtstrukturen umfasst und ein zweites Wählplanobjekt erstellt wird, wird die GUID des ursprünglichen Wählplans zur Proxyadresse des Benutzers in der anderen Gesamtstruktur kopiert.
Extension	Optional	System.String	Dieser Parameter gibt die Durchwahlnummer an, die von der Funktion "Anruf für unbestimmte Person" verwendet wird, wenn ein Anruf vermittelt wird.
FaxEnabled	Optional	System.Boolean	Dieser Parameter gibt an, ob das System das Senden und Empfangen von Faxen unterstützt. Der Unified Messaging-Server lädt die Faxkomponenten nur, wenn der Wählplan die Faxfunktion unterstützt. Der Standardwert lautet `$true`.
FDSPollingInterval	Optional	System.Int32	Das Intervall zwischen zwei Überprüfungen auf neue Inhalte (in Minuten) durch den Dateiverteilungsdienst auf der Dateifreigabe. Der Wertebereich umfasst 1 bis 1440 Minuten. Der Standardwert ist 5 Minuten.
InCountryOrRegionNumberFormat	Optional	Microsoft.Exchange.Data.NumberFormat	Dieser Parameter gibt die zu verwendende Präfixzeichenfolge sowie die aus dem Verzeichnis zu nehmende Anzahl von Stellen an. Diese Nummer wird beim Einwählen in diesen Wählplan von einem Standort aus verwendet, der sich im selben Länder-/Regionscode befindet.
InfoAnnouncementEnabled	Optional	Microsoft.Exchange.Data.Directory.SystemConfiguration.InfoAnnouncementEnabledEnum	Dieser Parameter gibt an, ob eine Informationsansage aktiviert ist. Dieser Parameter kann auf Enabled, Disabled oder Uninterruptible festgelegt werden. Der Standardwert lautet `$true`.
InfoAnnouncementFilename	Optional	System.String	Dieser Parameter gibt den Namen der Audiodatei für eine Informationsansage an.
InputFailuresBeforeDisconnect	Optional	System.Int32	Dieser Parameter gibt die Anzahl aufeinander folgender Benutzereingabefehler an, die zugelassen werden, bevor der Anruf unterbrochen wird. Die Standardeinstellung ist 3.
InputRetries	Optional	System.Int32	Dieser Parameter gibt an, wie oft ein Anrufer eine Eingabe wiederholen darf, bevor es zu einem Systemtimeout kommt. Dieser Parameter gilt für authentifizierte Benutzer sowie für Anrufannahme- und automatische Telefonzentralenbenutzer. Die Standardeinstellung ist 3.
InputTimeout	Optional	System.Int32	Dieser Parameter gibt den Zeitraum an, den das System auf eine Benutzereingabe wartet. Dieses Zeitlimit gilt für authentifizierte Benutzer sowie für Anrufannahme- und automatische Telefonzentralenbenutzer. Der Standardwert ist 5 Sekunden.
Instance	Optional	Microsoft.Exchange.Data.Directory.SystemConfiguration.UMDialPlan	Dieser Parameter gibt den Eingabeparameter an, der ein neues Wählplanobjekt darstellt.
InternationalAccessCode	Optional	System.String	Dieser Parameter gibt den Code an, der bei internationalen Anrufen einer Rufnummer vorangestellt wird. Beispielsweise "011", um in die Vereinigten Staaten zu telefonieren.
InternationalNumberFormat	Optional	Microsoft.Exchange.Data.NumberFormat	Dieser Parameter gibt die zu verwendende Präfixzeichenfolge sowie die aus dem Verzeichnis zu nehmende Anzahl von Stellen an, wenn in diesen Wählplan von einem Standort aus eingewählt wird, der sich in einem anderen Ländercode befindet .
LogonFailuresBeforeDisconnect	Optional	System.Int32	Dieser Parameter gibt die Anzahl aufeinander folgender, nicht erfolgreicher Anmeldeversuche an, die zugelassen werden, bevor der Anruf unterbrochen wird. Die Standardeinstellung ist 3.
MatchedNameSelectionMethod	Optional	Microsoft.Exchange.Data.Directory.SystemConfiguration.DisambiguationFieldEnum	Dieser Parameter gibt die Auswahl an, die zur Unterscheidung von Benutzern mit Namen, die der Tonwahl- oder Spracheingabe entsprechen, verwendet werden soll. Diese Einstellung kann auf folgende Werte festgelegt werden: Department Title Location None Prompt for alias Inherited from UM dial plan
MaxCallDuration	Optional	System.Int32	Dieser Parameter gibt den Höchstzeitraum an, den ein Anruf dauern darf, bevor er unterbrochen und dann beendet wird. Der Standardwert ist 30 Minuten.
MaxRecordingDuration	Optional	System.Int32	Dieser Parameter gibt die maximale Dauer an, für die Nachrichten aufgezeichnet werden können. Hierzu gehören alle Arten von Anrufen. Dieser Wert kann zwischen 5 und 100 liegen. Wenn Sie diesen Wert zu niedrig ansetzen, werden lange Sprachnachrichten möglicherweise vor ihrem Abschluss unterbrochen. Ist dieser Wert zu hoch eingestellt, können Benutzer übermäßig lange Sprachnachrichten im Posteingang speichern. Für Exchange 2007 Service Pack 2 (SP2) kann der Wert dieser Einstellung zwischen 1 und 100 liegen.
Name	Optional	System.String	Dieser Parameter gibt den für den UM-Wählplan zu verwendenden Anzeigenamen an. Die Länge dieses Namens ist auf 64 Zeichen begrenzt.
NationalNumberPrefix	Optional	System.String	Dieser Parameter gibt den Code an, der bei nationalen Ferngesprächen einer Rufnummer vorangestellt wird. Beispielsweise "1" in Nordamerika.
NDREnabled	Optional	System.Boolean	Dieser Parameter gibt an, ob übermittelte UM-Anrufannahmenachrichten Unzustellbarkeitsberichte (Non-Delivery Report, NDR) anfordern. Wenn dieser Parameter auf `$false` festgelegt ist, werden Nachrichten übermittelt, ohne Unzustellbarkeitsberichte anzufordern. Der Standardwert lautet `$false`.
OperatorExtension	Optional	System.String	Dieser Parameter gibt die Durchwahlnummer der Vermittlungsstelle an. Wenn dieser Parameter nicht angegeben wird, steht die Funktion "Übergabe an Vermittlungsstelle nicht zulassen" nicht zur Verfügung.
OutsideLineAccessCode	Optional	System.String	Dieser Parameter gibt den Code an, der bei nationalen Telefonaten über eine (externe) Amtsleitung der Rufnummer vorangestellt wird. Dieser Code wird auch als Amtsvorwahl bezeichnet. Die Standardeinstellung ist 9.
PromptPublishingPoint	Optional	System.String	Dieser Parameter gibt den Pfad der Microsoft Windows-Dateifreigaben des Servers und die Freigabe an, in der benutzerdefinierte Ansagen gespeichert sind. Der Standardpfad wird auf den ersten Unified Messaging-Server festgelegt, wenn er einem UM-Wählplan hinzugefügt wird.
RecordingIdleTimeout	Optional	System.Int32	Dieser Parameter gibt den Zeitraum an, über den ein Anrufer während der Aufzeichnung einer Sprachnachricht schweigen darf (Stille), bevor die Aufzeichnung beendet wird. Der Standardwert ist 5 Sekunden.
SendVoiceMsgEnabled	Optional	System.Boolean	Dieser Parameter gibt an, ob das Feature "Sprachnachricht senden" aktiviert ist.
TUIPromptEditingEnabled	Optional	System.Boolean	Dieser Parameter gibt an, ob autorisierte Benutzer Ansagen für UM-Wählpläne oder automatische Telefonzentralen unter Verwendung der Telefonbenutzerschnittstelle (Telephone User Interface, TUI) aufzeichnen dürfen. Die Standardeinstellung ist `$false`.
UMAutoAttendant	Optional	Microsoft.Exchange.Configuration.Tasks.UMAutoAttendantIdParameter	Dieser Parameter gibt die automatische Telefonzentrale an, die ausgeführt wird, wenn der Anrufer die Sterntaste (*) drückt. Wenn dieser Parameter angegeben wird, setzt er das Feature "Anruf für unbestimmte Person" außer Kraft.
VoIPSecurity	Optional	Microsoft.Exchange.Data.Directory.SystemConfiguration.UMVoIPSecurityType	Dieser Parameter gibt an, ob der VoIP-Datenverkehr (Voice over IP) nicht verschlüsselt ist bzw. dass der Signalkanal oder die Signal- und Medienkanäle unter Verwendung von MTLS (Mutual Transport Layer Security) verschlüsselt werden. Die Standardeinstellung ist `UnSecured`.
WelcomeGreetingEnabled	Optional	System.Boolean	Dieser Parameter gibt an, ob eine benutzerdefinierte "Begrüßung" aktiviert ist. Der Standardwert lautet `$false`.
WelcomeGreetingFilename	Optional	System.String	Dieser Parameter gibt den Namen der Audiodatei für die Begrüßung an.
WhatIf	Optional	System.Management.Automation.SwitchParameter	Dieser Parameter weist den Befehl an, die Aktionen zu simulieren, die für das Objekt ausgeführt würden. Durch Verwendung des Parameters WhatIf kann der Administrator die sich ergebenden Änderungen anzeigen, ohne diese Änderungen tatsächlich auszuführen. Der Standardwert lautet "$true".

Eingabetypen

Rückgabetypen

Fehler

Fehler	Beschreibung

Ausnahmen

Ausnahmen	Beschreibung

Beispiel

Das erste Beispiel konfiguriert den UM-Wählplan MyUMDialPlan für die Verwendung der Amtskennziffer 9.

Das zweite Beispiel konfiguriert den UM-Wählplan MyUMDialPlan für die Verwendung einer Begrüßung.

Das dritte Beispiel konfiguriert den UM-Wählplan MyUMDialPlan mit Wählregeln.

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"