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.