Freigeben über

  • Artikel

Get-CsVoicePolicy

 

Letztes Änderungsdatum des Themas: 2012-03-23

Gibt Informationen zu einer oder mehreren VoIP-Richtlinien zurück, die für Ihre Organisation konfiguriert sind.

Syntax

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

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

Detaillierte Beschreibung

Mit diesem Cmdlet werden Informationen zu VoIP-Richtlinien abgerufen. VoIP-Richtlinien werden zum Verwalten von Enterprise-VoIP-bezogenen Funktionen verwendet, z. B. für das gleichzeitige Klingeln (die Möglichkeit, ein zweites Telefon läuten zu lassen, wenn jemand die Nummer Ihres Bürotelefons wählt) und die Anrufweiterleitung. Verwenden Sie dieses Cmdlet zum Abrufen der Einstellungen, über die eine Vielzahl dieser Funktionen aktiviert oder deaktiviert wird.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Eine eindeutige ID zur Angabe des Gültigkeitsbereichs und in einigen Fällen des Namens der Richtlinie. Wenn dieser Parameter ausgelassen wird, werden alle VoIP-‏Richtlinien der Organisation zurückgegeben.

Filter

Optional

Zeichenfolge

Dieser Parameter akzeptiert eine Platzhalterzeichenfolge und gibt alle VoIP-Richtlinien zurück, deren Identitätswerte mit dieser Zeichenfolge übereinstimmen. Der Filterwert "site:*" gibt z. B. alle VoIP-Richtlinien zurück, die auf Standortebene definiert sind.

LocalStore

Optional

Switch-Parameter

Ruft die VoIP-Richtlinie 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.VoicePolicy" zurückgegeben.

Beispiel

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

Get-CsVoicePolicy

In diesem Beispiel werden alle für eine Organisation definierten VoIP-Richtlinien sowie deren Einstellungen angezeigt.

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

Get-CsVoicePolicy -Identity UserPolicy1

In diesem Beispiel wird der Parameter "Identity" verwendet, um die VoIP-Richtlinieneinstellungen für die benutzerbasierte Richtlinie "UserPolicy1" abzurufen.

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

Get-CsVoicePolicy -Filter tag*

In diesem Beispiel wird der Parameter "Filter" zum Abrufen aller VoIP-Richtlinieneinstellungen verwendet, die Benutzern zugewiesen werden können. Sämtliche benutzerbasierten VoIP-Richtlinien weisen einen Identitätswert mit dem Format tag:<Benutzer-VoIP-Richtlinie> auf. Die Ergebnisse werden daher nach "tag" gefiltert, um alle VoIP-Richtlinien für Benutzer abzurufen.