Get-CsCallParkOrbit
Letztes Änderungsdatum des Themas: 2012-03-23
Ruft die Orbitbereichseinstellungen für das Parken von Anrufen in einer Organisation ab.
Syntax
Get-CsCallParkOrbit [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsCallParkOrbit [-Filter <String>] [-LocalStore <SwitchParameter>]
Detaillierte Beschreibung
Mit diesem Cmdlet werden die Orbiteinstellungen beim Parken von Anrufen abgerufen, die für eine Organisation definiert sind. Sie können einen einzelnen Orbitbereich für das Parken von Anrufen (dieser wird über den Parameter "Identity" angegeben) abrufen oder Get-CsCallParkOrbit ohne Parameter aufrufen, um alle für eine Organisation definierten Orbitbereiche für das Parken von Anrufen abzurufen. Orbits für das Parken von Anrufen umfassen Einstellungen, über die eine Reihe von Nummern angegeben werden, die ein Benutzer zum Parken eines Anrufs verwenden kann. Darüber hinaus werden über diese Einstellungen die Server angegeben, die diesen Nummernbereichen zugeordnet sind.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Get-CsCallParkOrbit lokal ausführen: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmin. 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 "Get-CsCallParkOrbit"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Optional |
Zeichenfolge |
Der eindeutige Name des Orbitbereichs für das Parken von Anrufen. Dieser Name wurde vom Administrator beim Definieren des Orbitbereichs für das Parken von Anrufen zugewiesen. |
Filter |
Optional |
Zeichenfolge |
Dieser Parameter akzeptiert eine Platzhalterzeichenfolge und gibt alle Orbitbereiche für das Parken von Anrufen zurück, deren Identitäten mit dieser Zeichenfolge übereinstimmen. Bei Verwendung des Filterwerts "Redmond*" werden beispielsweise alle Orbitbereiche für das Parken von Anrufen zurückgegeben, deren Namen mit der Zeichenfolge "Redmond" beginnen, wie z. B. "Redmond 1", "Redmond 2" und "RedmondCPO". |
LocalStore |
Optional |
GUID |
Ruft die Orbitinformationen zum Parken von Anrufen aus dem lokalen Replikat des zentraler Verwaltungsspeichers ab, statt die Daten aus dem zentraler Verwaltungsspeicher selbst abzurufen. |
Eingabetypen
Keine.
Rückgabetypen
Dieses Cmdlet gibt ein Objekt vom Typ "Microsoft.Rtc.Management.Voice.Helpers.DisplayCallParkOrbit" zurück.
Beispiel
-------------------------- Beispiel 1 --------------------------
Get-CsCallParkOrbit
In diesem Beispiel wird Get-CsCallParkOrbit ohne zusätzliche Parameter aufgerufen. Bei diesem Aufruf gibt Get-CsCallParkOrbit eine Auflistung aller Orbitbereiche für das Parken von Anrufen zurück, die für die Verwendung in Ihrer Organisation konfiguriert sind.
-------------------------- Beispiel 2 --------------------------
Get-CsCallParkOrbit -Identity "Redmond CPO 1"
Im vorstehenden Beispiel wird Get-CsCallParkOrbit verwendet, um Informationen zum Orbitbereich "Redmond CPO 1" zurückzugeben.
-------------------------- Beispiel 3 --------------------------
Get-CsCallParkOrbit -Filter *Redmond*
Über den Befehl in diesem Beispiel werden alle Orbitbereiche für das Parken von Anrufen zurückgegeben, deren Identität die Zeichenfolge "Redmond" enthält. Dieser Befehl gibt z. B. Orbits mit den Identitäten "Redmond 501", "CP Redmond 1" und "ARedmond" zurück. Der Parameter "Filter" wird mit dem Platzhalterzeichen (*) verwendet, um die gewünschte Suchzeichenfolge anzugeben. (Bei dieser Suche wird die Groß-/Kleinschreibung nicht berücksichtigt.)
-------------------------- Beispiel 4 --------------------------
Get-CsCallParkOrbit | Where-Object {$_.CallParkServiceId.toString() -eq "ApplicationServer:pool0.litwareinc.com"}
Dieser Befehl gibt alle Orbitbereiche für das Parken von Anrufen zurück, die dem Dienst zum Parken von Anrufen mit der ID "ApplicationServer:pool0.litwareinc.com" zugewiesen sind. Über das Cmdlet Get-CsCallParkOrbit wird eine Auflistung sämtlicher Orbitbereiche für das Parken von Anrufen abgerufen, die anschließend an das Cmdlet Where-Object weitergeleitet wird. Bei diesem Aufruf von Where-Object werden alle Orbits in der Auflistung ermittelt, deren Eigenschaft "CallParkServiceId" den Wert "ApplicationServer:pool0.litwareinc.com" aufweist. Beachten Sie, dass die Methode "toString" am Ende des Parameternamens "CallParkServiceId" hinzugefügt wird. "CallParkServiceId" ist vom Typ "WritableServiceId". Um diesen Wert mit der bereitgestellten Zeichenfolge zu vergleichen, müssen wir ihn zunächst über die Methode "toString" in eine Zeichenfolge umwandeln.
-------------------------- Beispiel 5 --------------------------
Get-CsCallParkOrbit | Where-Object {$_.NumberRangeStart.StartsWith("*")}
Über den Befehl in diesem Beispiel werden alle Orbitbereiche für das Parken von Anrufen zurückgegeben, deren Nummernbereich mit dem Präfix "*" beginnt. Nachdem über Get-CsCallParkOrbit eine Auflistung aller Orbitbereiche für das Parken von Anrufen abgerufen wird, wird diese Auflistung an Where-Object weitergeleitet. Where-Object schränkt die Auflistung auf Orbitbereiche ein, deren Standort für das Parken von Anrufen mit einem Sternchen (*) beginnt. Zu diesem Zweck wird die Eigenschaft "StartsWith" des NumberRangeStart-Objekts auf die Zeichenfolge "*" überprüft.
-------------------------- Beispiel 6 --------------------------
Get-CsCallParkOrbit | Where-Object {[Char]::IsDigit($_.NumberRangeStart[0])}
Über den Befehl in diesem Beispiel werden alle Orbitbereiche für das Parken von Anrufen zurückgegeben, bei denen den Nummern innerhalb des Bereichs kein Präfix zugewiesen ist. (Bei einem Präfix handelt es sich um den Wert "*" oder "#", der einer Nummer vorangestellt ist.) Alle über diesen Befehl zurückgegebenen Orbits für das Parken von Anrufen weisen Bereiche auf, die ausschließlich Nummern ohne weitere Zeichen umfassen. Über Get-CsCallParkOrbit wird eine Auflistung aller Orbitbereiche für das Parken von Anrufen abgerufen, und diese Auflistung wird anschließend an Where-Object weitergeleitet. Bei Betrachtung der Kriterien beim Aufruf von Where-Object sehen Sie Folgendes: $_.NumberRangeStart[0]). Über diesen Wert wird das erste Zeichen in der Nummer am Anfang des Bereichs zurückgegeben. (Beachten Sie, dass lediglich der Anfang des Bereichs überprüft werden muss. Wenn die erste Nummer im Bereich kein Präfix besitzt, weist auch die letzte kein Präfix auf.) Dieses Zeichen wird an die Funktion "IsDigit" übergeben, um zu ermitteln, ob es sich um ein numerisches Zeichen handelt. Trifft dies zu, werden die Informationen zu diesem Orbit für das entsprechende Element der Auflistung zurückgegeben.