• Artikel

Get-CsVoiceRoute

 

Letztes Änderungsdatum des Themas: 2012-03-23

Gibt Informationen zu den VoIP-Routen zurück, die zur Verwendung in einer Organisation konfiguriert sind.

Syntax

Get-CsVoiceRoute [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]

Get-CsVoiceRoute [-Filter <String>] [-LocalStore <SwitchParameter>]

Detaillierte Beschreibung

Verwenden Sie dieses Cmdlet, um eine oder mehrere vorhandene VoIP-Routen abzurufen. VoIP-Routen umfassen Anweisungen, anhand derer Microsoft Lync Server 2010 ermittelt, wie Anrufe von Enterprise-VoIP-Benutzern bei Telefonnummern im Telefonfestnetz (Public Switched Telephone Network, PSTN) oder in einer Nebenstellenanlage (Private Branch Exchange, PBX) weitergeleitet werden sollen.

Dieses Cmdlet kann zum Abrufen von VoIP-Routeninformationen verwendet werden. Dazu zählt beispielsweise, welchen PSTN-Gateways die Route (gegebenenfalls) zugeordnet ist, welche PSTN-Verwendungen der Route zugeordnet sind, das Muster (in Form eines regulären Ausdrucks) zur Angabe der Telefonnummern, für welche die Route gilt, sowie Anruferkennungseinstellungen. Die PSTN-Verwendung ordnet die VoIP-Route einer VoIP-Richtlinie zu.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Get-CsVoiceRoute lokal auszuführen: RTCUniversalUserAdmins, 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 "Get-CsVoiceRoute"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsGlobalRelativeIdentity

Eine Zeichenfolge zur eindeutigen Kennzeichnung der VoIP-Route. Wenn kein Identitätswert angegeben wird, werden alle VoIP-Routen der Organisation zurückgegeben.

Filter

Optional

Zeichenfolge

Dieser Parameter filtert die Ergebnisse der Get-Operation basierend auf dem an diesen Parameter übergebenen Platzhalterwert.

LocalStore

Optional

Switch-Parameter

Ruft die VoIP-Route aus dem lokalen Replikat des zentraler Verwaltungsspeichers ab, statt die Daten aus dem zentraler Verwaltungsspeicher selbst abzurufen.

Eingabetypen

Keine.

Rückgabetypen

Mit diesem Cmdlet werden Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route" zurückgegeben.

Beispiel

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

Get-CsVoiceRoute

Ruft die Eigenschaften für alle VoIP-Routen ab, die innerhalb der Organisation definiert sind.

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

Get-CsVoiceRoute -Identity Route1

Ruft die Eigenschaften für die VoIP-Route "Route1" ab.

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

Get-CsVoiceRoute -Filter *test*

Mit diesem Befehl werden VoIP-Routeneinstellungen angezeigt, bei denen der Identitätswert die Zeichenfolge "test" (an beliebiger Stelle innerhalb des Werts) enthält. Um nur Identitätswerte zu ermitteln, bei denen die Zeichenfolge "test" am Ende des Werts steht, verwenden Sie den Wert "*test". Wenn Sie nur Identitätswerte ermitteln möchten, bei denen die Zeichenfolge "test" am Anfang des Identitätswerts steht, geben Sie den Wert "test*" an.

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

Get-CsVoiceRoute | Where-Object {$_.PstnGatewayList.Count -eq 0}

Mit diesem Befehl werden alle VoIP-Routen abgerufen, denen keine PSTN-Gateways zugewiesen wurden. Zunächst werden über das Cmdlet Get-CsVoiceRoute alle VoIP-Routen abgerufen. Diese VoIP-Routen werden dann an das Cmdlet Where-Object weitergeleitet. Where-Object schränkt die Ergebnisse der Get-Operation ein. In diesem Fall werden alle VoIP-Routen durchlaufen (dies wird durch "$_" angezeigt), und die Eigenschaft "Count" von "PstnGatewayList" wird überprüft. Wenn der Wert "Count" von PSTN-Gateways 0 lautet, ist die Liste leer und es wurden keine Gateways für die Route definiert.