Freigeben über


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.

Siehe auch

Weitere Ressourcen

Get-CsPstnUsage