Freigeben über


Set-UMDialplan

 

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"