New-CsVoicePolicy
Letztes Änderungsdatum des Themas: 2012-03-25
Erstellt eine neue VoIP-Richtlinie.
Syntax
New-CsVoicePolicy -Identity <XdsIdentity> [-AllowCallForwarding <$true | $false>] [-AllowPSTNReRouting <$true | $false>] [-AllowSimulRing <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EnableBWPolicyOverride <$true | $false>] [-EnableCallPark <$true | $false>] [-EnableCallTransfer <$true | $false>] [-EnableDelegation <$true | $false>] [-EnableMaliciousCallTracing <$true | $false>] [-EnableTeamCall <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Name <String>] [-PreventPSTNTollBypass <$true | $false>] [-PstnUsages <PSListModifier>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Mit diesem Cmdlet wird eine neue VoIP-Richtlinie erstellt. VoIP-Richtlinien werden zum Verwalten von Enterprise-VoIP-bezogenen Funktionen verwendet, z. B. für das gleichzeitige Klingeln (die Möglichkeit, ein zweites Telefon läuten zu lassen, wenn jemand die Nummer Ihres Bürotelefons wählt) und die Anrufweiterleitung. Die mit diesem Cmdlet erstellte Richtlinie bestimmt, ob eine Vielzahl dieser Funktionen aktiviert oder deaktiviert ist.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet New-CsVoicePolicy 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-CsVoicePolicy"}
Parameter
Parameter | Erforderlich | Typ | Beschreibung |
---|---|---|---|
Identity |
Erforderlich |
XdsIdentity |
Eine eindeutige ID zur Angabe des Bereichs oder des Namens der Richtlinie. Gültige Werte für dieses Cmdlet sind "site:<Standortname>" (wobei <Standortname> der Name des Microsoft Lync Server 2010-Standorts ist, für den die Richtlinie gilt, wie z. B. "site:Redmond") und eine Zeichenfolge zur Angabe einer benutzerbasierten Richtlinie, wie z. B. "RedmondVoicePolicy". Es ist standardmäßig eine globale Richtlinie vorhanden. |
AllowCallForwarding |
Optional |
Boolescher Wert |
Wird dieser Parameter auf "True" festgelegt, ist keine Anrufweiterleitung möglich. Wird "False" festgelegt, ist keine Anrufweiterleitung möglich. Standard: True |
AllowPSTNReRouting |
Optional |
Boolescher Wert |
Wenn dieser Parameter auf "True" festgelegt ist, werden Anrufe bei internen Nummern, die sich in einem anderen Pool befinden, über das Telefonfestnetz (Public Switched Telephone Network, PSTN) geleitet, wenn der Pool oder das WAN nicht verfügbar ist. Standard: True |
AllowSimulRing |
Optional |
Boolescher Wert |
Gleichzeitiges Klingeln ist eine Funktion, mit der mehrere Telefone läuten können, wenn eine einzige Nummer gewählt wird. Bei Festlegung von "True" wird diese Funktion aktiviert. Wenn dieser Parameter auf "False" festgelegt wird, kann das gleichzeitige Klingeln für die dieser Richtlinie zugewiesenen Benutzer nicht konfiguriert werden. Standard: True |
Description |
Optional |
Zeichenfolge |
Eine Beschreibung der VoIP-Richtlinie. Maximale Länge: 1040 Zeichen. |
EnableBWPolicyOverride |
Optional |
Boolescher Wert |
Sie können Richtlinien zur Verwaltung der Netzwerkkonfiguration, wie beispielsweise zur Beschränkung der Bandbreite, festlegen. Wenn dieser Parameter auf "True" festgelegt wird, können diese Richtlinien außer Kraft gesetzt werden. Anders ausgedrückt: Wenn dieser Parameter auf "True" festgelegt ist, finden keine Bandbreitenprüfungen statt und Anrufe werden unabhängig von den Anrufsteuerungseinstellungen durchgestellt. Standard: False |
EnableCallPark |
Optional |
Boolescher Wert |
Mit der Anwendung zum Parken von Anrufen können Anrufe bei einer bestimmten Nummer innerhalb eines Nummernbereichs geparkt werden, um zu einem späteren Zeitpunkt abgerufen zu werden. Bei Festlegung von "True" wird die Anwendung aktiviert. Wenn dieser Parameter auf "False" festgelegt wird, können die dieser Richtlinie zugewiesenen Benutzer keine Anrufe parken, die über ihre Telefonnummer eingehen. Standard: False |
EnableCallTransfer |
Optional |
Boolescher Wert |
Bestimmt, ob Anrufe an eine andere Nummer weitergeleitet werden können. Wenn dieser Parameter auf "True" festgelegt wird, können Anrufe weitergeleitet werden. Bei Festlegung von "False" ist keine Weiterleitung möglich. Standard: True |
EnableDelegation |
Optional |
Boolescher Wert |
Mit der Anrufdelegierung kann ein Benutzer die Anrufe für einen anderen Benutzer entgegennehmen oder Anrufe im Namen des anderen Benutzers tätigen. Ein Vorgesetzter kann beispielsweise die Anrufdelegierung einrichten, damit bei eingehenden Anrufen sowohl das eigene als auch das Telefon eines Administrators läutet. Wenn dieser Parameter auf "True" festgelegt wird, können die dieser Richtlinie zugewiesenen Benutzer die Anrufdelegierung einrichten. Bei Festlegung von "False" wird die Anrufdelegierung deaktiviert. Standard: True |
EnableMaliciousCallTracing |
Optional |
Boolescher Wert |
Die Nachverfolgung bei Missbrauch durch Anrufer ist ein Standard, um Anrufe nachzuverfolgen, bei denen ein Benutzer eine Belästigung meldet. Diese Anrufe können auch dann nachverfolgt werden, wenn die Anruferkennung unterdrückt wird. Die Nachverfolgung ist nur durch autorisierte Stellen möglich, nicht durch den Benutzer. Wenn diese Eigenschaft auf "True" festgelegt wird, kann eine Nachverfolgung bei Missbrauch durch Anrufer aktiviert werden. Standard: False |
EnableTeamCall |
Optional |
Boolescher Wert |
Mit der Funktion für Teamanrufe kann ein Benutzer eine Gruppe von Benutzern bestimmen, deren Telefone beim Eingehen von Anrufen an die eigene Nummer läuten. Diese Funktion ist z. B. für Teams nützlich, in denen ein beliebiges Teammitglied eingehende Anrufe von Kunden annehmen kann. Bei Festlegung von "True" wird diese Funktion aktiviert. Standard: True |
Name |
Optional |
Zeichenfolge |
Ein Anzeigename zur Beschreibung dieser Richtlinie. Standard: DefaultPolicy |
PreventPSTNTollBypass |
Optional |
Boolescher Wert |
Für Anrufe im Telefonfestnetz (Public Switched Telephone Network, PSTN) fallen üblicherweise Gebühren an. Organisationen können diese Gebühren durch die Implementierung einer VoIP-Lösung (Voice over Internet Protocol) umgehen, bei der sich Zweigstellen über Netzwerkanrufe verbinden können. Wenn dieser Parameter auf "True" festgelegt wird, erfolgen Anrufe nicht über das Netzwerk (zur Umgehung der Gebühren), sondern gebührenpflichtig über das Telefonfestnetz. Standard: False |
PstnUsages |
Optional |
PSListModifier |
Eine Liste der für diese Richtlinie verfügbaren PSTN-Verwendungen. Die PSTN-Verwendung verknüpft eine VoIP-Richtlinie mit einer Telefonroute. In diese Liste kann ein Zeichenfolgenwert gesetzt werden, sofern dieser Wert in der aktuellen globalen Liste von PSTN-Verwendungen vorhanden ist. (Doppelte Zeichenfolgen sind nicht zulässig, alle Einträge müssen eindeutig sein.) Die Liste der PSTN-Verwendungen kann mit dem Cmdlet Get-CsPstnUsage abgerufen werden. Diese Liste ist standardmäßig leer. Wenn Sie keinen Wert für diesen Parameter bereitstellen, wird eine Warnmeldung angezeigt, dass Benutzer, denen diese Richtlinie zugewiesen wurde, keine ausgehenden PSTN-Anrufe tätigen können. |
Force |
Optional |
Switch-Parameter |
Unterdrückt alle Bestätigungsaufforderungen, die andernfalls vor der Durchführung von Änderungen angezeigt würden. |
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 eine Instanz des Objekts "Microsoft.Rtc.Management.WritableConfig.Voice.VoicePolicy" erstellt.
Beispiel
-------------------------- Beispiel 1 --------------------------
New-CsVoicePolicy -Identity UserVoicePolicy1
In diesem Beispiel wird die neue benutzerbasierte VoIP-Richtlinie mit dem Identitätswert "UserVoicePolicy1" unter Verwendung der Standardeinstellungen erstellt.
-------------------------- Beispiel 2 --------------------------
New-CsVoicePolicy UserVoicePolicy2 -AllowSimulRing $false -PstnUsages @{add = "Local"}
In diesem Beispiel wird die neue benutzerbasierte VoIP-Richtlinie mit dem Identitätswert "UserVoicePolicy2" erstellt. Zudem wird die Eigenschaft "AllowSimulRing" auf "False" festgelegt, sodass die Funktion für gleichzeitiges Klingeln bei den dieser Richtlinie zugewiesenen Benutzern nicht aktiviert ist. Über diese Funktion wird festgelegt, ob beim Klingeln des Bürotelefons eines Benutzers gleichzeitig auch ein zweites Telefon (z. B. ein Mobiltelefon) läuten soll. Mit diesem Befehl wird außerdem "Local" zu der Liste von PSTN-Verwendungen hinzugefügt, wodurch diese VoIP-Richtlinie einer VoIP-Route zugeordnet wird, die ebenfalls die PSTN-Verwendung "Local" verwendet. (Beachten Sie, dass der Parameter "Identity" nicht explizit angegeben wird. Der Parameter "Identity" ist ein Positionsparameter. Wenn Sie den Identitätswert in der Parameterliste zuerst angeben, muss daher nicht explizit angegeben werden, dass es sich um die Identität handelt.)
-------------------------- Beispiel 3 --------------------------
$a = Get-CsPstnUsage
New-CsVoicePolicy site:Redmond -PstnUsages @{add = $a.Usage}
In diesem Beispiel wird eine neue VoIP-Richtlinie für den Standort "Redmond" erstellt. Zudem werden alle für die Organisation definierten PSTN-Verwendungen auf diese Richtlinie angewendet. In der ersten Zeile dieses Beispiels wird das Cmdlet Get-CsPstnUsage aufgerufen, um den globalen Satz mit PSTN-Verwendungen für die Organisation abzurufen und in der Variablen "$a" zu speichern. In der zweiten Zeile wird New-CsVoicePolicy aufgerufen, um die neue VoIP-Richtlinie für den Standort "Redmond" zu erstellen. An den Parameter "PstnUsages" wird ein Wert übergeben, um dieser Richtlinie die im globalen Satz von PSTN-Verwendungen enthaltene Liste hinzuzufügen. Beachten Sie die Syntax des add-Werts: $a.Usage. Dies bezieht sich auf die Eigenschaft "Usage" der PSTN-Verwendungseinstellungen, welche die Liste der PSTN-Verwendungen enthält.
Siehe auch
Weitere Ressourcen
Remove-CsVoicePolicy
Set-CsVoicePolicy
Get-CsVoicePolicy
Grant-CsVoicePolicy
Test-CsVoicePolicy
Get-CsPstnUsage