Freigeben über


Get-CsPstnUsage

 

Letztes Änderungsdatum des Themas: 2012-03-23

Gibt Informationen über die in Ihrer Organisation verwendeten Verwendungsdatensätze des Telefonfestnetzes (Public Switched Telephone Network, PSTN) zurück.

Syntax

Get-CsPstnUsage [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

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

Detaillierte Beschreibung

Bei PSTN-Verwendungen handelt es sich um Zeichenfolgenwerte, die für die Anrufautorisierung verwendet werden. Eine PSTN-Verwendung verknüpft eine VoIP-Richtlinie mit einer Route. Mit dem Cmdlet Get-CsPstnUsage wird die Liste aller in Ihrer Organisation verfügbaren PSTN-Verwendungen innerhalb einer Organisation abgerufen.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Die Ebene, auf der diese Einstellungen angewendet werden. Für PSTN-Verwendungen kann nur der Identitätswert "Global" angewendet werden.

Filter

Optional

Zeichenfolge

Mithilfe des Parameters "Filter" können nur PSTN-Verwendungen abgerufen werden, deren Identitätswert mit einer bestimmten Platzhalterzeichenfolge übereinstimmt. Da der einzige verfügbare Identitätswert für PSTN-Verwendungen jedoch "Global" ist, ist die Verwendung dieses Parameters mit diesem Cmdlet nicht sinnvoll.

LocalStore

Optional

Switch-Parameter

Ruft die PSTN-Verwendungsinformationen aus dem lokalen Datenspeicher statt vom zentraler Verwaltungsspeicher ab.

Eingabetypen

Keine.

Rückgabetypen

Mit Get-CsPstnUsage werden Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Policy.Voice.PSTNUsages" zurückgegeben.

Beispiel

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

Get-CsPstnUsage

Mit diesem Befehl wird die Liste der globalen PSTN-Verwendungen zurückgegeben, die innerhalb der Organisation verfügbar sind.

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

(Get-CsPstnUsage).Usage

Der Befehl in diesem Beispiel gibt eine Liste aller definierten PSTN-Verwendungen zurück. Dabei wird in der Ausgabe eine Verwendung pro Zeile angezeigt. Wenn Get-CsPstnUsage allein aufgerufen wird, werden die Listen "Identity" und "Usage" zurückgegeben. Wenn die Liste "Usage" mehr als drei oder vier Einträge umfasst, wird die Liste in der Ausgabe wie im folgenden Beispiel abgekürzt:

Usage : {Internal, Local, Long Distance, International...}

Verwenden Sie den Befehl in diesem Beispiel, um lediglich eine Liste der Verwendungen anzuzeigen. Die Ausgabe entspricht in etwa folgendem Beispiel:

Internal

Local

Long Distance

International

Restricted

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

(Get-CsPstnUsage).Usage | ForEach-Object {if ($_ -like "*tern*") {$_}}

Mit diesem Befehl werden alle PSTN-Verwendungen zurückgegeben, deren Namen die Zeichenfolge "tern" enthalten. Dieser Befehl gibt z. B. "Internal" und "International" zurück, nicht jedoch "Local" oder "Long Distance".

Im ersten Teil dieses Befehls wird das Cmdlet Get-CsPstnUsage in Klammern angegeben, sodass im ersten Schritt sämtliche PSTN-Verwendungen abgerufen werden. Die Eigenschaft ".Usage" gibt nur die Verwendungsinformationen für die PSTN-Verwendungen zurück, nicht jedoch den Identitätswert. Die Liste der Verwendungen wird dann an das Cmdlet ForEach-Object weitergeleitet, das die Verwendungszeichenfolgen nacheinander überprüft. Mit der If-Anweisung wird die aktuelle Verwendungszeichenfolge mit der Zeichenfolge "*tern*" verglichen (die Sternchen (*) sind Platzhalterzeichen), und die ermittelten Übereinstimmungen für dieses Muster werden angezeigt.

Siehe auch

Weitere Ressourcen

Set-CsPstnUsage
Get-CsVoicePolicy
Get-CsVoiceRoute