• Artikel

Set-CsVoiceConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-26

Ändert eine Liste von VoIP-Testkonfigurationen.

Syntax

Set-CsVoiceConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-VoiceTestConfigurations <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Set-CsVoiceConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-VoiceTestConfigurations <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

VoIP-Testkonfigurationen werden dazu verwendet, eine bestimmte VoIP-Richtlinie, -Route und einen bestimmten Satz mit Wähleinstellungen für eine Telefonnummer zu testen. Dieses Cmdlet kann verwendet werden, um VoIP-Testkonfigurationen aus einer Liste mit allen VoIP-Testkonfigurationen für eine Microsoft Lync Server 2010-Bereitstellung zu ändern.

Mit diesem Cmdlet wird ein Objekt vom Typ "VoiceConfiguration" geändert. Dieses Objekt ist lediglich ein Containerobjekt für VoIP-Testkonfigurationen. Daher wird die Verwendung dieses Cmdlets nicht empfohlen. Ändern Sie zum Bearbeiten der VoIP-Konfigurationen die einzelnen VoIP-Testkonfigurationen über das Cmdlet Set-CsVoiceTestConfiguration.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

Zeichenfolge

Der Gültigkeitsbereich dieses Objekts. Der einzige zulässige Wert für diesen Parameter lautet "Global".

Instance

Optional

VoiceConfiguration

Ein Verweis auf ein VoIP-Konfigurationsobjekt (Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoiceConfiguration). Objekte von diesem Typ können mit dem Cmdlet Get-CsVoiceConfiguration abgerufen werden.

VoiceTestConfigurations

Optional

PSListModifier

Eine Liste aller VoIP-Testkonfigurationen (Microsoft.Rtc.Management.WritableConfig.Policy.Voice.TestConfiguration-Objekte), die für die Lync Server 2010-Bereitstellung definiert sind.

Sie sollten einzelne VoIP-Testkonfigurationsobjekte über das Cmdlet Set-CsVoiceTestConfiguration ändern. Dies ist die empfohlene Methode zum Ändern von Konfigurationen in dieser Liste.

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.VoiceConfiguration-Objekt. Akzeptiert eine weitergeleitete Eingabe von VoIP-Konfigurationsobjekten.

Rückgabetypen

Set-CsVoiceConfiguration gibt keine Werte oder Objekte zurück. Stattdessen werden mit dem Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoiceConfiguration" konfiguriert.

Beispiel

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

$a = Get-CsVoiceConfiguration
$b = $a.VoiceTestConfigurations | Where-Object {$_.Name -eq "TestConfig2"}
$b.DialedNumber = 5551212
$b.ExpectedTranslatedNumber = +5551212
Set-CsVoiceConfiguration -Instance $a

Zum Ändern einer VoIP-Testkonfiguration innerhalb einer VoIP-Konfiguration sind mehrere Schritte erforderlich. In diesem Beispiel wird zunächst das VoIP-Konfigurationsobjekt abgerufen, indem Get-CsVoiceConfiguration aufgerufen wird. Anschließend wird das abgerufene Objekt (es wird nur ein Objekt zurückgegeben) der Variablen "$a" zugewiesen.

In Zeile 2 des Beispiels werden die Inhalte der Eigenschaft "VoiceTestConfigurations", bei der es sich um eine Auflistung von VoIP-Testkonfigurationsobjekten handelt, aus der Variablen "$a" abgerufen. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Auflistung nach dem VoIP-Testkonfigurationsobjekt mit dem Namen "TestConfig2" durchsucht. Dieses Objekt wird der Variablen "$b" zugewiesen.

Anschließend wird das VoIP-Testkonfigurationsobjekt "TestConfig2" geändert, indem wir den Eigenschaften "DialedNumber" und "ExpectedTranslatedNumber" neue Werte zuweisen. Durch eine Aktualisierung des Objekts wird das Objekt in der Variablen "$a" aktualisiert. Das Objekt befindet sich jedoch weiterhin nur im Arbeitsspeicher. Im letzten Schritt müssen die vorgenommenen Änderungen gespeichert werden, indem "$a" an den Parameter "Instance" des CmdletsSet-CsVoiceConfiguration übergeben wird.

Hierbei handelt es sich nicht um die empfohlene Vorgehensweise zum Ändern einer VoIP-Konfiguration. Ändern Sie zum Bearbeiten einer VoIP-Konfiguration einfach die einzelnen VoIP-Testkonfigurationen über die Eigenschaft Set-CsVoiceTestConfiguration, wie nachfolgend gezeigt:

Set-CsVoiceTestConfiguration -Identity TestConfig2 -DialedNumber 5551212 -ExpectedTranslatedNumber +5551212

Diese eine Zeile führt dieselbe Aufgabe aus wie Beispiel 1.