Freigeben über

  • Artikel

New-CsCpsConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-23

Erstellt eine neue Einstellungsauflistung für den Dienst zum 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 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 die richtige Nummer eingeben.

Syntax

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

Detaillierte Beschreibung

Dieses Cmdlet wird zum Erstellen einer neuen Konfiguration des Diensts für das Parken von Anrufen verwendet. Wenn der Dienst für das Parken von Anrufen installiert ist, werden standardmäßig globale Einstellungen konfiguriert, die aktualisiert aber nicht entfernt werden können. (Das "Entfernen" der globalen Einstellungen führt lediglich dazu, dass sie auf die Standardwerte zurückgesetzt werden.) Daher wird dieses Cmdlet nur zum Erstellen standortspezifischer Einstellungen 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 New-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 "New-CsCpsConfiguration"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Der Standort, auf den die Einstellungen angewendet werden. Dieser muss im Format "site:<Standortname>" eingegeben werden, beispielsweise "site:Redmond". Auf globaler Ebene liegt immer eine Konfiguration vor, sie kann jedoch nicht entfernt werden. Mit diesem Cmdlet kann somit keine globale Konfiguration neu erstellt werden.

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.

Standard: 00:01:30 (90 Sekunden); 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.

Standard: True

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.

Standard: 1; 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.

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

Dieses Cmdlet erstellt ein Objekt vom Typ Microsoft.Rtc.Management.WritableConfig.Settings.CallParkServiceSettings.CallParkServiceSettings.

Beispiel

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

New-CsCpsConfiguration -Identity site:Redmond1 -EnableMusicOnHold $False

Der Befehl in Beispiel 1 verwendet das Cmdlet New-CsCpsConfiguration, um eine Konfiguration des Diensts für das Parken von Anrufen für den Standort "Redmond1" zu erstellen. Diese Konfiguration wird mit Standardwerten erstellt, abgesehen von "EnableMusicOnHold". Dieser Befehl legt diese Eigenschaft auf "False" fest, d. h., der Anrufer, dessen Anruf geparkt wurde, hört während der Wartezeit keine Musik. ("EnableMusicOnHold" wird standardmäßig auf "True" festgelegt, unter der Voraussetzung, dass der Dienst für das Parken von Anrufen bereitgestellt wurde.)

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

New-CsCpsConfiguration -Identity site:Redmond1 -OnTimeoutURI sip:kenmyer@litwareinc.com

Der Befehl in Beispiel 2 verwendet das Cmdlet New-CsCpsConfiguration, um eine Konfiguration des Diensts für das Parken von Anrufen für den Standort "Redmond1" zu erstellen. Standardmäßig wird kein Wert für "OnTimeoutURI" angegeben, daher wird in diesem Beispiel ein Wert für diesen Parameter hinzugefügt. In diesem Beispiel wird "OnTimeoutURI" auf "sip:kenmyer@litwareinc.com" festgelegt. Der an diesen Parameter übergebene Wert muss mit der Zeichenfolge "sip:" beginnen und sollte auf einen Benutzer oder eine Reaktionsgruppe verweisen, der/die geparkte Anrufe empfängt, die nach einer bestimmten Anzahl von Rückrufversuchen nicht angenommen werden.

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

New-CsCpsConfiguration -Identity site:Redmond1 -MaxCallPickupAttempts 2

Dieser Befehl verwendet das Cmdlet New-CsCpsConfiguration, um eine Konfiguration des Diensts für das Parken von Anrufen für den Standort "Redmond1" zu erstellen. Für diesen Standort wurde "MaxCallPickupAttempts" auf 2 festgelegt. Dies bedeutet, dass zwei Rückrufe erfolgen.