Set-CsVoicePolicy

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

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.

Siehe auch

Weitere Ressourcen

New-CsVoicePolicy
Remove-CsVoicePolicy
Get-CsVoicePolicy
Grant-CsVoicePolicy
Test-CsVoicePolicy
Get-CsPstnUsage