Freigeben über

  • Artikel

Set-CsVoicePolicy

 

Letztes Änderungsdatum des Themas: 2012-03-27

Ändert eine vorhandene VoIP-Richtlinie.

Syntax

Set-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>] [-Name <String>] [-PreventPSTNTollBypass <$true | $false>] [-PstnUsages <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Set-CsVoicePolicy [-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>] [-Instance <PSObject>] [-Name <String>] [-PreventPSTNTollBypass <$true | $false>] [-PstnUsages <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Dieses Cmdlet ändert eine vorhandene VoIP-Richtlinie. 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. Verwenden Sie dieses Cmdlet zum Ändern der Einstellungen, über die eine Vielzahl dieser Funktionen aktiviert oder deaktiviert wird.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Set-CsVoicePolicy lokal auszufü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 "Set-CsVoicePolicy"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

Zeichenfolge

Eine eindeutige ID zur Angabe des Gültigkeitsbereichs und in einigen Fällen des Namens der Richtlinie.

Instance

Optional

VoicePolicy

Ermöglicht Ihnen, einen Verweis auf ein Objekt an das Cmdlet zu übergeben, statt individuelle Parameterwerte festzulegen. Dieses Objekt muss vom Typ "VoicePolicy" sein und kann mit dem Cmdlet Get-CsVoicePolicy abgerufen werden.

AllowCallForwarding

Optional

Boolescher Wert

Wenn dieser Parameter auf "True" festgelegt ist, können Benutzer, die dieser Richtlinie zugeordnet sind, Anrufe weiterleiten. Wird "False" festgelegt, ist keine Anrufweiterleitung möglich.

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.

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 das gleichzeitige Klingeln aktiviert. Wenn dieser Parameter auf "False" festgelegt wird, kann das gleichzeitige Klingeln für die dieser Richtlinie zugewiesenen Benutzer nicht konfiguriert werden.

Description

Optional

Zeichenfolge

Eine Beschreibung der VoIP-Richtlinie.

Maximale Länge: 1040 Zeichen.

EnableBWPolicyOverride

Optional

Boolescher Wert

Zum Einschränken der Bandbreite und Festlegen verschiedener anderer Eigenschaften für die Netzwerkkonfiguration können Richtlinien festgelegt werden. 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.

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. Wird dieser Parameter auf "True" festgelegt, wird diese Anwendung für Benutzer aktiviert, denen diese Richtlinie zugewiesen ist. Wenn dieser Parameter auf "False" festgelegt wird, können die dieser Richtlinie zugewiesenen Benutzer keine Anrufe parken, die über ihre Telefonnummer eingehen.

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.

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 die Anrufdelegierung beispielsweise 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.

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.

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.

Name

Optional

Zeichenfolge

Ein Anzeigename zur Beschreibung dieser Richtlinie.

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.

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.

Wenn Sie diesen Parameter zum Entfernen aller PSTN-Verwendungen aus der Richtlinie verwenden, denken Sie daran, 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.

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

Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoicePolicy-Objekt. Akzeptiert eine weitergeleitete Eingabe von VoIP-Richtlinienobjekten.

Rückgabetypen

Dieses Cmdlet gibt keine Werte oder Objekte zurück. Stattdessen werden mit dem Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Voice.VoicePolicy" konfiguriert.

Beispiel

-------------------------- Beispiel 1 --------------------------

Set-CsVoicePolicy UserVoicePolicy2 -AllowSimulRing $false -PstnUsages @{remove="Local"}

In diesem Beispiel wird die Eigenschaft "AllowSimulRing" für die benutzerbasierte Richtlinie "UserVoicePolicy2" auf "False" gesetzt, sodass das gleichzeitige Klingeln für die dieser Richtlinie zugewiesenen Benutzer nicht aktiviert werden kann. Ü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. Über diesen Befehl wird zudem die Verwendung "Local" aus der Liste der Telefonverwendungen für diese Richtlinie entfernt. (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 2 --------------------------

$a = Get-CsPstnUsage
Set-CsVoicePolicy -Identity site:Redmond -PstnUsages @{replace=$a.Usage}

In diesem Beispiel wird die VoIP-Richtlinie für den Standort "Redmond" so geändert, dass alle für die Organisation definierten PSTN-Verwendungen auf diese Richtlinie angewendet werden. In der ersten Zeile dieses Beispiels wird das Cmdlet Get-CsPstnUsage aufgerufen, um den globalen Satz an PSTN-Verwendungen für die Organisation abzurufen und in der Variablen "$a" zu speichern. In der zweiten Zeile wird Set-CsVoicePolicy aufgerufen, um die VoIP-Richtlinie für den Standort "Redmond" zu ändern. Um die aktuelle Liste der Telefonverwendungen für die Richtlinie durch die Liste im globalen Satz mit PSTN-Verwendungen zu ersetzen, wird ein Wert an den Parameter "PstnUsages" übergeben. Beachten Sie die Syntax des ersetzten Werts: $a.Usage. Dies bezieht sich auf die Eigenschaft "Usage" der PSTN-Verwendungseinstellungen, welche die Liste der PSTN-Verwendungen enthält.