Set-CsPstnUsage
Letztes Änderungsdatum des Themas: 2012-03-25
Ändert einen Satz von Zeichenfolgen, die die zulässigen Verwendungen des Telefonfestnetzes (Public Switched Telephone Network, PSTN) identifizieren. Mit diesem Cmdlet können der Liste von PSTN-Verwendungen weitere hinzugefügt sowie einzelne daraus entfernt werden.
Syntax
Set-CsPstnUsage [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Usage <PSListModifier>] [-WhatIf [<SwitchParameter>]]
Set-CsPstnUsage [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Usage <PSListModifier>] [-WhatIf [<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. Das Cmdlet Set-CsPstnUsage wird zum Hinzufügen oder Entfernen von Telefonverwendungen zu bzw. aus der Verwendungsliste eingesetzt. Da diese Liste global ist, kann sie von Richtlinien und Routen innerhalb der Microsoft Lync Server 2010-Bereitstellung verwendet werden.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Set-CsPstnUsage 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-CsPstnUsage"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Optional |
XdsIdentity |
Die Ebene, auf der diese Einstellungen angewendet werden. Die Identität für dieses Cmdlet ist immer "Global". |
Instance |
Optional |
PstnUsages |
Ein Verweis auf das PSTN-Verwendungsobjekt. Dieses Objekt muss ein Objekt vom Typ "PstnUsages" sein und kann mithilfe von Get-CsPstnUsage abgerufen werden. |
Usage |
Optional |
PSListModifier |
Umfasst eine Liste der zulässigen Verwendungszeichenfolgen. Für diese Einträge kann ein beliebiger Zeichenfolgenwert verwendet werden. |
Force |
Optional |
Switch-Parameter |
Unterdrückt alle Bestätigungsaufforderungen, die andernfalls vor der Durchführung von Änderungen angezeigt würden. |
WhatIf |
Optional |
Switch-Parameter |
Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen. |
Confirm |
Optional |
Switch-Parameter |
Fordert Sie vor der Ausführung des Befehls zum Bestätigen auf. |
Eingabetypen
Microsoft.Rtc.Management.WritableConfig.Policy.Voice.PstnUsages-Objekt. Akzeptiert eine weitergeleitete Eingabe von PSTN-Verwendungsobjekten.
Rückgabetypen
Dieses Cmdlet gibt keine Werte oder Objekte zurück. Stattdessen werden mit dem Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Policy.Voice.PstnUsages" konfiguriert.
Beispiel
-------------------------- Beispiel 1 --------------------------
Set-CsPstnUsage -Identity global -Usage @{add="International"}
Über diesen Befehl wird die Zeichenfolge "International" zur aktuellen Liste der verfügbaren PSTN-Verwendungen hinzugefügt.
-------------------------- Beispiel 2 --------------------------
Set-CsPstnUsage -Identity global -Usage @{remove="Local"}
Über diesen Befehl wird die Zeichenfolge "Local" aus der Liste der verfügbaren PSTN-Verwendungen entfernt.
-------------------------- Beispiel 3 --------------------------
Set-CsPstnUsage -Usage @{remove="Local"}
Über den Befehl in diesem Beispiel wird dieselbe Aktion wie in Beispiel 2 ausgeführt: Die PSTN-Verwendung "Local" wird entfernt. In diesem Beispiel wird der Befehl ohne Angabe des Parameters "Identity" gezeigt. Die einzige für das Cmdlet Set-CsPstnUsage verfügbare Identität lautet "Global". Beim Auslassen des Parameters "Identity" wird der Standardwert "Global" verwendet.
-------------------------- Beispiel 4 --------------------------
Set-CsPstnUsage -Usage @{replace="International","Restricted"}
Über diesen Befehl werden sämtliche Daten in der Verwendungsliste durch die Werte "International" und "Restricted" ersetzt. Alle zuvor vorhandenen Verwendungen werden entfernt.