Set-CsRgsAgentGroup

Syntax

Set-CsRgsAgentGroup -Instance <AgentGroup> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Wenn jemand eine der Reaktionsgruppenanwendung zugeordnete Telefonnummer anruft, ermittelt der Dienst zunächst, welcher Workflow der gewählten Nummer entspricht. Gemäß der Konfiguration dieses Workflows wird der Anruf möglicherweise an das interaktive Sprachantwortsystem weitergeleitet, um einen Satz von Fragen zu beantworten (dem Anrufer werden Fragen wie z. B. "Haben Sie eine Frage zu Hardware- oder Softwaresupport?" gestellt). Alternativ kann der Anruf in einer Reaktionsgruppenwarteschleife platziert werden, bis eine Person verfügbar ist, die den Anruf entgegennehmen kann. Die für die Entgegennahme von Anrufen zuständigen Personen werden als Agenten, und eine Gruppe von Agenten wird als Reaktionsgruppen-Agentengruppe bezeichnet. Agentengruppen sind Workflows zugeordnet und können außerdem Gruppen zugeordnet werden, die ihren Zuständigkeitsbereich reflektieren: Mitarbeiter des Helpdesks können in der Agentengruppe "Help Desk", Kundensupportagenten dagegen in der Agentengruppe "Customer Support" zusammengefasst werden.

Neue Agentengruppen werden mit dem Cmdlet New-CsRgsAgentGroup erstellt. Verwenden Sie das Cmdlet Set-RgsAgentGroup, wenn Sie nach der Erstellung einer Agentengruppe Änderungen an dieser Gruppe vornehmen müssen. Mithilfe dieses Cmdlets können unter anderem einzelne Agenten einer Gruppe hinzugefügt oder aus dieser entfernt werden. Beachten Sie, dass die Eigenschaften einer Agentengruppe mit Set-CsRgsAgentGroup nicht direkt geändert werden. Zum Ändern einer Gruppe müssen Sie zunächst einen Objektverweis auf diese Gruppe erstellen. Dazu wird Get-CsRgsAgentGroup aufgerufen, um die Gruppe abzurufen, und das zurückgegebene Objekt anschließend in einer Variablen gespeichert. Nach der Erstellung des Objektverweises können Sie die Gruppeneigenschaften im Arbeitsspeicher ändern. Danach müssen Sie Set-CsRgsAgentGroup aufrufen, um die Änderungen in der eigentliche Reaktionsgruppen-Agentengruppe zu speichern. Wenn Sie Set-CsRgsAgentGroup nicht aufrufen, sind die Änderungen nur im Arbeitsspeicher vorhanden und gehen verloren, sobald Sie Windows PowerShell beenden oder die Objektverweisvariable löschen.

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

Parameter

Eingabetypen

Microsoft.Rtc.Rgs.Management.WritableSettings.AgentGroup-Objekt Set-CsRgsAgentGroup akzeptiert weitergeleitete Objektinstanzen der Reaktionsgruppen-Agentengruppe.

Rückgabetypen

Set-CsRgsAgentGroup gibt keine Objekte oder Werte zurück. Stattdessen werden mit dem Cmdlet bestehende Instanzen des Objekts "Microsoft.Rtc.Rgs.Management.WritableSettings.AgentGroup" geändert.

Beispiel

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

$x = Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
$x.RoutingMethod = "RoundRobin"
Set-CsRgsAgentGroup -Instance $x

Die Befehle in Beispiel 1 ändern die Eigenschaft "RoutingMethod" für die Reaktionsgruppen-Agentengruppe "Help Desk" (die für den Dienst "ApplicationServer:atl-cs-001.litwareinc.com" gefunden wurde). Hierzu ruft der Befehl zunächst mithilfe des Cmdlets Get-CsRgsAgentGroup die Agentengruppe "Help Desk" (-Name "Help Desk") aus "ApplicationServer:atl-cs-001.litwareinc.com" ab. Anschließend wird das Agentengruppenobjekt in der Variablen "$x" gespeichert.

Befehl 2 im Beispiel ändert den Wert der Eigenschaft "RoutingMethod". Im letzten Befehl des Beispiels werden diese Änderungen mithilfe des Cmdlets Set-CsRgsAgentGroup in die eigentliche Agentengruppe "Help Desk" geschrieben.

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

$x = Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
$x.DistributionGroupAddress = "helpdesk@litwareinc.com"
Set-CsRgsAgentGroup -Instance $x

In Beispiel 2 wird gezeigt, wie Sie die einer Reaktionsgruppen-Agentengruppe zugewiesene Verteilergruppe ändern können. Hierzu wird zunächst mithilfe des Cmdlets Get-CsRgsAgentGroup die zu ändernde Agentengruppe zurückgegeben, in diesem Fall die Gruppe "Help Desk" (-Name "Help Desk "), die für den Dienst "ApplicationServer:atl-cs-001.litwareinc.com" gefunden wurde. Nachdem die Gruppe mit Get-CsRgsAgentGroup zurückgegeben wurde, wird das resultierende Objekt in der Variablen "$x" gespeichert.

Mit dem zweiten Befehl im Beispiel wird der Eigenschaft "DistributionGroupAddress" ein neuer Wert ("helpdesk@litwareinc.com") zugewiesen. Anschließend wird die Änderung mithilfe des Cmdlets Set-CsRgsAgentGroup in die Gruppe "Help Desk" für "ApplicationServer:atl-cs-001.litwareinc.com" geschrieben.

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

$x = Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
$x.AgentsByUri.Add("sip:kenmyer@litwareinc.com")
Set-CsRgsAgentGroup -Instance $x

Der Befehl in Beispiel 3 fügt der Reaktionsgruppen-Agentengruppe "Help Desk" einen neuen Agenten hinzu. Hierzu wird zunächst mithilfe des Cmdlets Get-CsRgsAgentGroup die Gruppe "Help Desk" (-Name "Help Desk") aus dem Dienst "ApplicationServer:atl-cs-001.litwareinc.com" zurückgegeben. Das abgerufene Objekt wird dann in der Variablen "$x" gespeichert.

Im zweiten Befehl wird die Add-Methode verwendet, um der Eigenschaft "AgentsByUri" einen neuen Agenten hinzuzufügen. Hierzu wird die SIP-Adresse des neuen Agenten angegeben ("sip:kenmyer@litwareinc.com"). In Befehl 3 werden die Änderungen (d. h. das Hinzufügen des neuen Agenten) mithilfe des Cmdlets Set-CsRgsAgentGroup in die Gruppe "Help Desk" geschrieben. Wenn Sie Set-CsRgsAgentGroup nicht aufrufen, werden die Änderungen nur im Arbeitsspeicher vorgenommen, aber nicht der eigentlichen Agentengruppe zugewiesen.

-------------------------- Beispiel 4 --------------------------

$x = Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
$x.AgentsByUri.Remove("sip:kenmyer@litwareinc.com")
Set-CsRgsAgentGroup -Instance $x

In Beispiel 4 wird ein Agent aus der Reaktionsgruppen-Agentengruppe "Help Desk" entfernt, die für den Dienst "ApplicationServer:atl-cs-001.litwareinc.com" gefunden wurde. Hierzu wird zunächst mithilfe des Cmdlets Get-CsRgsAgentGroup die Gruppe "Help Desk" (-Name "Help Desk") aus "ApplicationServer:atl-cs-001.litwareinc.com" zurückgegeben. Anschließend wird das abgerufene Agentengruppenobjekt in der Variablen "$x" gespeichert.

Nach dem Abrufen der Agentengruppe wird ein Agent (der Agent mit der SIP-Adresse "sip:kenmyer@litwareinc.com") mithilfe der Remove-Methode aus der Gruppe entfernt. In Befehl 3 wird Set-CsRgsAgentGroup aufgerufen, um die Änderungen zu schreiben (d. h. den Agenten aus der Gruppe zu entfernen). Wenn Sie Set-CsRgsAgentGroup nicht aufrufen, werden die Änderungen nur im Arbeitsspeicher vorgenommen, aber nicht der eigentlichen Agentengruppe zugewiesen. Der Agent wird nur durch Aufrufen des Cmdlets Set-CsRgsAgentGroup entfernt.

Siehe auch

Weitere Ressourcen

Get-CsRgsAgentGroup
New-CsRgsAgentGroup
Remove-CsRgsAgentGroup