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.
Siehe auch
Weitere Ressourcen
Remove-CsVoiceConfiguration
Get-CsVoiceConfiguration
New-CsVoiceTestConfiguration
Set-CsVoiceTestConfiguration
Get-CsVoiceTestConfiguration