New-CsDialPlan
Letztes Änderungsdatum des Themas: 2012-03-27
Erstellt einen neuen Satz mit Wähleinstellungen.
Syntax
New-CsDialPlan -Identity <XdsIdentity> [-City <String>] [-Confirm [<SwitchParameter>]] [-CountryCode <String>] [-Description <String>] [-DialinConferencingRegion <String>] [-ExternalAccessPrefix <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-NormalizationRules <PSListModifier>] [-OptimizeDeviceDialing <$true | $false>] [-SimpleName <String>] [-State <String>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Mit diesem Cmdlet wird ein neuer Satz mit Wähleinstellungen (auch als Standortprofil bezeichnet) erstellt. Wähleinstellungen bieten die erforderlichen Informationen für Enterprise-VoIP-Benutzer, damit diese Anrufe tätigen können. Wähleinstellungen werden von der Konferenzzentrale zudem für Einwahlkonferenzen verwendet. Über einen Satz mit Wähleinstellungen wird u. a. bestimmt, welche Normalisierungsregeln angewendet werden und ob für externe Anrufe ein Präfix gewählt werden muss.
Beim Erstellen eines Satzes mit Wähleinstellungen wird automatisch eine Standard-VoIP-Normalisierungsregel erstellt. Normalisierungsregeln können durch Aufrufen des Cmdlets Set-CsVoiceNormalizationRule geändert werden. Neue Normalisierungsregeln können einem Satz mit Wähleinstellung durch Aufrufen des Cmdlets New-CsVoiceNormalizationRule hinzugefügt werden.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet New-CsDialPlan lokal ausführen: RTCUniversalServerAdmins. Geben Sie den folgenden Befehl an der Windows PowerShell-Eingabeaufforderung ein, um eine Liste aller rollenbasierten Zugriffssteuerungsrollen zurückzugeben, die diesem Cmdlet zugewiesen wurden (einschließlich der benutzerdefinierten rollenbasierten Zugriffssteuerungsrollen, die Sie selbst erstellt haben):
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsDialPlan"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
XdsIdentity |
Eine eindeutige ID zur Angabe von Gültigkeitsbereich und Name (Standort), Dienstrolle und FQDN, oder Name (benutzerbasiert), um den Satz mit Wähleinstellungen zu identifizieren. Eine Standortidentität wird beispielsweise mit dem Format "site:<Standortname>" angegeben. Dabei steht "Standortname" für den Namen des Standorts. Bei einem Satz mit Wähleinstellungen auf Dienstebene muss es sich um eine Registrierung oder um einen PSTN-Gatewaydienst handeln, wobei der Identitätswert das folgende Format aufweist: Registrar:Redmond.litwareinc.com. Ein benutzerbasierter Identitätswert wird einfach als ein eindeutiger Zeichenfolgenwert eingegeben. |
Description |
Optional |
Zeichenfolge |
Eine Beschreibung dieser Wähleinstellungen. Diese Beschreibung umfasst den Zweck, den Typ der Benutzer, für welche die Wähleinstellungen gelten, oder andere Informationen, die zur Angabe des Zwecks nützlich sind. Maximale Anzahl von Zeichen: 512 |
DialinConferencingRegion |
Optional |
Zeichenfolge |
Der Name der Region, die diesem Satz mit Wähleinstellungen zugeordnet ist. Geben Sie einen Wert für diesen Parameter an, wenn der Satz mit Wähleinstellungen für Einwahlkonferenzen verwendet wird. Auf diese Weise wird die richtige Zugriffsnummer zugewiesen, wenn der Konferenzorganisator die Konferenz einrichtet. Die verfügbaren Regionen können über das Cmdlet Get-CsNetworkRegion abgerufen werden. Maximale Anzahl von Zeichen: 512 |
ExternalAccessPrefix |
Optional |
Zeichenfolge |
Eine Nummer oder Gruppe von Nummern, die den Anruf als extern kennzeichnen. (Zum Wählen einer externen Nummer kann es beispielsweise erforderlich sein, zunächst die 9 zu drücken.) Dieses Präfix wird von den Normalisierungsregeln ignoriert, die lediglich auf die übrigen Ziffern der Nummer angewendet werden. Der Parameter "OptimizeDeviceDialing" muss auf "True" gesetzt werden, damit dieser Wert wirksam wird. Dieser Parameter muss mit dem regulären Ausdruck [0-9]{1,4} übereinstimmen. Dies bedeutet, dass er einen Wert aus den Ziffern 0 bis 9 aufweisen und ein bis vier Stellen umfassen muss. Standard: 9 |
NormalizationRules |
Optional |
PSListModifier |
Eine Liste mit Normalisierungsregeln, die auf diese Wähleinstellungen angewendet werden. Wenngleich diese Liste und die Regeln direkt mit diesem Cmdlet erstellt werden können, sollten die Normalisierungsregeln mit dem Cmdlet New-CsVoiceNormalizationRule erstellt werden. Dieses Cmdlet erstellt die Regel und weist sie dem angegebenen Satz mit Wähleinstellungen zu. Immer, wenn ein neuer Satz mit Wähleinstellungen erstellt wird, wird für diesen Satz mit Wähleinstellungen auf Standort-, Dienst- oder Benutzerebene auch eine neue VoIP-Normalisierungsregel mit Standardeinstellungen erstellt. Der Identitätswert der neuen VoIP-Normalisierungsregel entspricht standardmäßig dem Identitätswert des Satzes mit Wähleinstellungen, gefolgt von dem Namen "Prefix All". Beispiel: site:Redmond/Prefix All. Standard: {Description=;Pattern=^(\d11)$;Translation=+$1;Name=Prefix All;IsInternalExtension=False } Beachten Sie: Dieser Standardwert ist lediglich ein Platzhalter. Damit der Satz mit Wähleinstellungen zweckmäßig ist, sollten Sie entweder die von ihm erstellte Normalisierungsregel ändern oder eine neue Regel für den Standort, Dienst oder Benutzer erstellen. Sie können eine neue Normalisierungsregel erstellen, indem Sie das Cmdlet New-CsVoiceNormalizationRule aufrufen, und eine Normalisierungsregel ändern, indem Sie Set-CsVoiceNormalizationRule aufrufen. |
OptimizeDeviceDialing |
Optional |
Boolescher Wert |
Bei Festlegung dieses Parameters auf "True" wird das Präfix im Parameter "ExternalAccessPrefix" auf Anrufe angewendet, die außerhalb der Organisation getätigt werden. Dieser Wert kann nur auf "True" gesetzt werden, wenn für den Parameter "ExternalAccessPrefix" ein Wert angegeben wurde. Standard: False |
SimpleName |
Optional |
Zeichenfolge |
Ein Anzeigename für den Satz mit Wähleinstellungen. Dieser Name muss unter den Sätzen mit Wähleinstellungen innerhalb der Lync Server-Bereitstellung eindeutig sein. Die Zeichenfolge darf bis zu 256 Zeichen enthalten. Gültige Zeichen sind alphabetische oder numerische Zeichen, Bindestriche (-), Punkte (.), Pluszeichen (+), Unterstriche (_) und Klammern (()). Dieser Parameter muss einen Wert enthalten. Wenn Sie jedoch beim Aufruf von New-CsDialPlan keinen Wert angeben, wird ein Standardwert bereitgestellt. Der Standardwert für einen globalen Satz mit Wähleinstellungen ist "Prefix All". Der Standardwert für einen Satz mit Wähleinstellungen auf Standortebene ist der Name des Standorts. Der Standardwert für einen Dienst ist der Name des Diensts ("Registrar" oder "PSTN Gateway"), gefolgt von einem Unterstrich und dem vollqualifizierten Domänennamen (FQDN) des Diensts. Beispiel: Registrar_pool0.litwareinc.com. Der Standardwert für einen benutzerbasierten Satz mit Wähleinstellungen ist der Identitätswert des Satzes mit Wähleinstellungen. |
State |
Optional |
Zeichenfolge |
Dieser Parameter wird mit diesem Cmdlet nicht verwendet. |
City |
Optional |
Zeichenfolge |
Dieser Parameter wird mit diesem Cmdlet nicht verwendet. |
CountryCode |
Optional |
Zeichenfolge |
Dieser Parameter wird mit diesem Cmdlet nicht verwendet. |
Force |
Optional |
Switch-Parameter |
Unterdrückt alle Bestätigungsaufforderungen vor der Durchführung von Änderungen. |
InMemory |
Optional |
Switch-Parameter |
Erstellt einen Objektverweis ohne einen Commit für das Objekt auszuführen und die Änderungen dadurch dauerhaft zu speichern. Wenn Sie die Ausgabe des mit diesem Parameter aufgerufenen Cmdlet einer Variablen zuweisen, können Sie die Eigenschaften des Objektverweises ändern und anschließend einen Commit für diese Änderungen ausführen, indem Sie das entsprechende Cmdlet vom Typ "Set-" aufrufen. |
WhatIf |
Optional |
Switch-Parameter |
Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen. |
Confirm |
Optional |
Switch-Parameter |
Fordert Sie vor der Ausführung des Befehls zum Bestätigen auf. |
Eingabetypen
Keine.
Rückgabetypen
Mit diesem Cmdlet wird ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Policy.Voice.LocationProfile" erstellt.
Beispiel
-------------------------- Beispiel 1 --------------------------
New-CsDialPlan -Identity RedmondDialPlan
Der Befehl in Beispiel 1 erstellt einen neuen Satz mit Wähleinstellungen mit dem Identitätswert "RedmondDialPlan". (Da der Wert "Identity" keinen Gültigkeitsbereich enthält, handelt es sich um eine benutzerbasierte Richtlinie. Wähleinstellungen, die auf Benutzerebene erstellt werden, können Benutzern oder Gruppen direkt zugewiesen werden.) Für alle anderen Eigenschaften der Wähleinstellungen werden Standardwerte zugewiesen.
-------------------------- Beispiel 2 --------------------------
New-CsDialPlan -Identity site:Redmond -SimpleName RedmondSiteDialPlan
New-CsVoiceNormalizationRule -Identity "site:Redmond/SeattlePrefix" -Pattern "^9(\d*){1,5}$" -Translation "+1206$1"
Die Befehle in Beispiel 2 erstellen einen neuen Satz mit Wähleinstellungen mit dem Identitätswert "site:Redmond" (dies bedeutet, dass der Satz mit Wähleinstellungen für alle Benutzer am Standort "Redmond" gilt, denen keine Wähleinstellungen auf Benutzer- oder Dienstebene zugewiesen sind) und dem Wert "RedmondSiteDialPlan" für den Parameter "SimpleName". Die nächste Zeile im Beispiel erstellt dann eine neue Normalisierungsregel, die diesem Satz mit Wähleinstellungen zugeordnet wird. Für einen Satz mit Wähleinstellung wird eine Standardnormalisierungsregel erstellt, diese dient jedoch in erster Linie als Platzhalter – die Werte sind von eingeschränktem Nutzen. Nach dem Aufruf des Cmdlets New-CsDialPlan zum Erstellen eines neuen Satzes mit Wähleinstellungen sollten Sie daher New-CsVoiceNormalizationRule aufrufen, um eine benannte Regel zu erstellen, die den Anforderungen Ihrer Organisation entspricht. Dieser Schritt wird in Zeile 2 dieses Beispiels ausgeführt: Durch Aufrufen von New-CsVoiceNormalizationRule wird eine neue Regel mit Namen "SeattlePrefix" für den Standort "Redmond" erstellt, wobei die Eigenschaften "Pattern" und "Translation" für die Regel angegeben werden. Zum Bearbeiten der Wähleinstellungen sind keine weiteren Schritte erforderlich. Die Änderungen an der Normalisierungsregel werden automatisch auf den Satz mit Wähleinstellungen angewendet, dessen Identität mit der Identität der Normalisierungsregel übereinstimmt. (Der Abschnitt "site:Redmond" der Identität stimmt mit der Identität des Satzes mit Wähleinstellungen überein; bei "SeattlePrefix" handelt es sich um den Namen der Normalisierungsregel. Es ist möglich, mehrere Normalisierungsregeln auf einen Satz mit Wähleinstellungen anzuwenden. Daher benötigt jede Normalisierungsregel innerhalb eines Gültigkeitsbereichs einen eindeutigen Namen.)
-------------------------- Beispiel 3 --------------------------
New-CsDialPlan -Identity RedmondDialPlan -Description "Dial plan for Redmond users"
Der Befehl in Beispiel 3 erstellt einen neuen Satz mit Wähleinstellungen mit dem Identitätswert "RedmondDialPlan" und gibt in "Description" eine Beschreibung an, die den Zweck des Satzes mit Wähleinstellungen erläutert. (Wähleinstellungen, die auf Benutzerebene erstellt werden, können Benutzern oder Gruppen direkt zugewiesen werden.) Für alle anderen Parameter werden die Standardwerte zugewiesen.