Freigeben über

  • Artikel

Set-CsCpsConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-26

Ändert eine vorhandene Auflistung von Einstellungen für den Dienst für das Parken von Anrufen. Die Funktion zum Parken von Anrufen ist ein Dienst, über den Benutzer eingehende Anrufe "parken" können. Beim Parken eines Anrufs wird der Anruf an eine Nummer in einem angegebenen Bereich (oder Orbit) übergeben und anschließend sofort in der Warteschleife platziert. Sämtliche Benutzer (nicht nur der Benutzer, der den Anruf ursprünglich entgegengenommen hat) können das Gespräch von einem beliebigen Telefon aus fortführen, indem sie einfach die richtige Nummer eingeben.

Syntax

Set-CsCpsConfiguration [-Identity <XdsIdentity>] [-CallPickupTimeoutThreshold <TimeSpan>] [-Confirm [<SwitchParameter>]] [-EnableMusicOnHold <$true | $false>] [-Force <SwitchParameter>] [-MaxCallPickupAttempts <Int32>] [-OnTimeoutURI <String>] [-WhatIf [<SwitchParameter>]]

Set-CsCpsConfiguration [-CallPickupTimeoutThreshold <TimeSpan>] [-Confirm [<SwitchParameter>]] [-EnableMusicOnHold <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaxCallPickupAttempts <Int32>] [-OnTimeoutURI <String>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Dieses Cmdlet wird zum Ändern einer vorhandenen Konfiguration des Diensts für das Parken von Anrufen verwendet. Eine Konfiguration des Diensts für das Parken von Anrufen gibt an, wie mit einem geparkten Anruf verfahren wird. Wenn ein geparkter Anruf beispielsweise nach einem bestimmten Zeitraum nicht beantwortet wird, kann er automatisch an einen anderen Benutzer, z. B. an einen Administrator, oder an eine Reaktionsgruppe weitergeleitet werden. Um zu verhindern, dass Anrufe vergessen werden, können die Einstellungen so konfiguriert werden, dass das Telefon nach einem bestimmten Zeitraum erneut läutet. Darüber hinaus kann der Dienst für das Parken von Anrufen so konfiguriert werden, dass für den Anrufer eines geparkten Anrufs Wartemusik wiedergegeben wird.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Set-CsCpsConfiguration 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 "Set-CsCpsConfiguration"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

Zeichenfolge

Eine eindeutige ID für die Konfiguration, die geändert werden soll. Der Identitätswert gibt den Bereich an, auf den die Konfiguration angewendet wird. Eine Konfiguration kann entweder global oder auf einen bestimmten Standort angewendet werden (im Format "site:<Standortname>", z. B. "site:Redmond").

Instance

Optional

CallParkServiceSettings

Ein Objektverweis auf ein Konfigurationsobjekt des Diensts für das Parken von Anwendungen vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.CallParkServiceSettings.CallParkServiceSettings". Dieses Objekt kann durch Aufrufen des Cmdlets Get-CsCpsConfiguration abgerufen werden. Das Objekt kann anschließend geändert und die Änderungen gespeichert werden, indem das Objekt in diesem Parameter wieder an Set-CsCpsConfiguration übergeben wird.

CallPickupTimeoutThreshold

Optional

TimeSpan

Die Zeitspanne, die nach dem Parken eines Anrufs verstreicht, bis das Telefon zurückgerufen wird, an dem der Anruf entgegengenommen wurde.

Dieser Wert muss im Format "hh:mm:ss" (hh = Stunden, mm = Minuten, ss = Sekunden) eingegeben werden.

Mindestwert: 10 Sekunden (00:00:10); Höchstwert: 10 Minuten (00:10:00)

EnableMusicOnHold

Optional

Boolescher Wert

Legt fest, ob der Anrufer eines geparkten Anrufs Wartemusik hört.

Microsoft Lync Server 2010 umfasst eine Standarddatei für Wartemusik. Sie können diese Datei (und damit die Musik, die der Anrufer während der Wartezeit hört) über das Cmdlet Set-CsCallParkServiceMusicOnHoldFile ändern.

MaxCallPickupAttempts

Optional

Int32

Die Anzahl der Rückrufe, die für einen geparkten Anruf beim antwortenden Telefon erfolgen, bevor der Anruf an den Fallback-URI weitergeleitet wird. Der Fallback-URI wird mit dem Parameter "OnTimeoutURI" festgelegt.

Mindestwert: 1; Höchstwert: 10

OnTimeoutURI

Optional

Zeichenfolge

Die SIP-Adresse des Benutzers oder der Reaktionsgruppe, an die nicht beantwortete geparkte Anrufe weitergeleitet werden. Der geparkte Anruf wird weitergeleitet, nachdem die Anzahl der über den Parameter "MaxCallPickupAttempts" definierten Rückrufe erreicht wurde. Wenn dieser Parameter auf "Null" festgelegt ist, wird "OnTimeoutURI" ignoriert und der geparkte Anruf nach erfolglosen Rückrufversuchen getrennt.

Bei den Werten muss es sich um SIP-URI handeln, beginnend mit "sip:". Beispiel: sip:rgs1@litwareinc.com.

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.Settings.CallParkServiceSettings.CallParkServiceSettings-Objekt. Akzeptiert eine weitergeleitete Eingabe von Konfigurationsobjekten für den Dienst zum Parken von Anrufen.

Rückgabetypen

Ändert ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.CallParkServiceSettings.CallParkServiceSettings".

Beispiel

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

Set-CsCpsConfiguration -Identity site:Redmond1 -MaxCallPickupAttempts 2

Der Befehl in Beispiel 1 ändert die Konfiguration des Dienstes zum Parken von Anrufen mit dem Identitätswert "site:Redmond1", indem die Anzahl der Rückrufe, die für einen geparkten Anruf beim antwortenden Telefon erfolgen, auf 2 festgelegt wird. Hierzu wird der Parameter "MaxCallPickupAttempts" verwendet und auf den Wert 2 festgelegt.

-------------------------- Beispiel 2 --------------------------

Get-CsCpsConfiguration | Set-CsCpsConfiguration -MaxCallPickupAttempts 2

Beispiel 2 ist eine Variante des Befehls aus Beispiel 1. In diesem Fall wird jedoch für alle Konfigurationen (nicht nur für eine Konfiguration) des Diensts für das Parken von Anrufen die Eigenschaft "MaxCallPickupAttempts" auf den Wert 2 festgelegt. Hierzu wird mit Get-CsCpsConfiguration eine Auflistung aller Einstellungen des Diensts für das Parken von Anrufen abgerufen, die in der Organisation verwendet werden. Diese Auflistung wird dann an das Cmdlet Set-CsCpsConfiguration weitergeleitet, das für jedes Element in der Auflistung die Eigenschaft "MaxCallPickupAttempts" auf den Wert 2 festgelegt.

-------------------------- Beispiel 3 --------------------------

Set-CsCpsConfiguration -Identity site:Redmond1 -CallPickupTimeoutThreshold 00:00:45

In diesem Beispiel wird die Konfiguration der Anwendung für das Parken von Anrufen für den Standort "Redmond1" geändert, indem der Zeitraum bis zum Rückruf für einen geparkten Anruf (enthalten in der Eigenschaft "CallPickupTimeoutThreshold") auf 45 Sekunden festgelegt wird.