Freigeben über

  • Artikel

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.