Set-CsAudioTestServiceApplication
Letztes Änderungsdatum des Themas: 2012-03-27
Ermöglicht das Ändern der Eigenschaftswerte für alle Audiotestdienst-Anwendungskontakte, die gegenwärtig in Ihrer Organisation verwendet werden.
Syntax
Set-CsAudioTestServiceApplication -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-CSEnabled <$true | $false>] [-DisplayName <String>] [-DisplayNumber <String>] [-EnabledForFederation <$true | $false>] [-EnterpriseVoiceEnabled <$true | $false>] [-LineURI <String>] [-PassThru <SwitchParameter>] [-PrimaryLanguage <String>] [-SecondaryLanguages <MultiValuedProperty>] [-SipAddress <String>] [-Type <String>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Über den Audiotestdienst können Microsoft Lync 2010-Benutzer ihre VoIP-Verbindungen testen, bevor sie einen Anruf tätigen. Zu diesem Zweck klicken Benutzer im Dialogfeld "Lync 2010-Optionen" auf der Registerkarte "Audiogerät" auf die Schaltfläche "Anrufqualität prüfen". Wenn ein Benutzer auf diese Schaltfläche klickt, wird ein automatisierter Audiotestdienst angerufen. Der Anruf wird entgegengenommen, und nach der Wiedergabe einer kurzen Einführungsansage wird der Anrufer zur Aufzeichnung einer kurzen Nachricht (mit einer maximalen Dauer von 10 Sekunden) aufgefordert. Diese Aufzeichnung wird anschließend wiedergegeben, sodass der Anrufer die Qualität seines Anrufs über die aktuelle Verbindung überprüfen kann.
Der Audiotestdienst basiert zum Teil auf Active Directory-Kontaktobjekten. Diese Objekte werden automatisch für Sie erstellt, wenn Sie Audio Bot installieren. Diese Objekte können nicht manuell erstellt werden. Administratoren können jedoch mithilfe des Cmdlets Get-CsAudioTestServiceApplication Informationen zu den verschiedenen Testdienstkontakten abrufen, die gegenwärtig in der Organisation verwendet werden. Administratoren können auch das Cmdlet Set-CsAudioTestServiceApplication verwenden, um die Eigenschaften dieser Kontakte zu ändern.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Set-CsAudioTestServiceApplication 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-CsAudioTestServiceApplication"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
UserID-Parameter |
SIP-Adresse des zu ändernden Audiotestdienst-Kontakts. |
Enabled |
Optional |
Boolescher Wert |
Gibt an, ob das Kontaktobjekt für Lync Server 2010 aktiviert ist. Wenn dieser Wert auf "False" ($False) festgelegt wird, kann der Kontakt sich nicht mehr bei Lync Server anmelden. Bei Festlegung auf "True" ($True) werden die Anmeldeberechtigungen des Kontakts erneut aktiviert. |
DisplayName |
Optional |
Zeichenfolge |
Active Directory-Anzeigename für das Kontaktobjekt. |
DisplayNumber |
Optional |
Zeichenfolge |
"DisplayNumber" ist zwar eine gültige Eigenschaft, wird aber nicht mit dem Audiotestdienst verwendet. |
EnabledForFederation |
Optional |
Boolescher Wert |
Gibt an, ob dieser Kontakt für Benutzer aus einer Partnerdomäne verfügbar ist. Wenn "False" festgelegt wurde, können nur Benutzer innerhalb Ihrer Organisation auf den Kontakt zugreifen. |
EnterpriseVoiceEnabled |
Optional |
Boolescher Wert |
Gibt an, ob das Kontaktobjekt für Enterprise-VoIP aktiviert wurde, sprich für die Microsoft-Implementierung von VoIP (Voice over Internet Protocol). Mit Enterprise-VoIP können Benutzer Anrufe über das Internet tätigen und müssen nicht länger das standardmäßige Telefonnetz nutzen. |
LineUri |
Optional |
Zeichenfolge |
"LineUri" ist zwar eine gültige Eigenschaft, wird aber nicht mit dem Audiotestdienst verwendet. |
PrimaryLanguage |
Optional |
Zeichenfolge |
Primäre Sprache für den Audiotestdienst. Die Sprache muss mit einem der zulässigen Sprachcodes für Einwahlkonferenzen konfiguriert werden, z. B. "en-US" für US-Englisch, "fr-FR" für Französisch. Um eine Liste der verfügbaren Sprachcodes zurückzugeben, geben Sie an der Windows PowerShell-Eingabeaufforderung folgenden Befehl ein: Get-CsDialInConferencingLanguageList | Select-Object -ExpandProperty Languages. |
SecondaryLanguages |
Optional |
Zeichenfolgenarray |
"SecondaryLanguages" ist zwar eine gültige Eigenschaft, wird aber nicht mit dem Audiotestdienst verwendet. |
SipAddress |
Optional |
SIP-Adresse |
Eindeutige ID, mit der das Kontaktobjekt mithilfe von SIP-Geräten wie Lync 2010 kommunizieren kann. Die SIP-Adresse muss mit "sip": beginnen. Beispiel: -SipAddress "sip:kenmyer@litwareinc.com". |
Type |
Optional |
Zeichenfolge |
Gibt den Typ des bereitzustellenden Testkontakts an. Kontakte werden standardmäßig als "Automaton" aufgelistet, d. h., sie können mit Anrufern interagieren. |
PassThru |
Optional |
Switch-Parameter |
Ermöglicht das Weiterleiten eines Benutzerobjekts, das den Benutzer darstellt, dem die Richtlinie zugewiesen wird. Das Cmdlet Set-CsAudioTestServiceApplication leitet standardmäßig keine Objekte weiter. |
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
Set-CsAudioTestServiceApplication akzeptiert weitergeleitete Instanzen des Objekts "Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact".
Rückgabetypen
Set-CsAudioTestServiceApplication gibt keine Objekte oder Werte zurück.
Beispiel
-------------------------- Beispiel 1 --------------------------
Set-CsAudioTestServiceApplication -Identity "sip:RedmondAudioTest@litwareinc.com" -PrimaryLanguage "en-US"
In Beispiel 1 wird die primäre Sprache für den Audiotestdienst-Kontakt "sip:RedmondAudioTest@litwareinc.com" auf US-Englisch (en-US) festgelegt.
-------------------------- Beispiel 2 --------------------------
Set-CsAudioTestServiceApplication -Identity "sip:RedmondAudioTest@litwareinc.com" -PrimaryLanguage $Null
In dem vorstehenden Beispiel wird der Wert der Eigenschaft "PrimaryLanguage" für den Audiotestdienst-Kontakt "sip:RedmondAudioTest@litwareinc.com" gelöscht. Dazu wird der Parameter "PrimaryLanguage" angegeben und der Parameterwert auf "$Null" festgelegt.
-------------------------- Beispiel 3 --------------------------
Get-CsAudioTestServiceApplication | Set-CsAudioTestServiceApplication -PrimaryLanguage "en-US"
In Beispiel 3 werden alle Audiotestdienst-Kontakte, die derzeit in der Organisation verwendet werden, so konfiguriert, dass US-Englisch als primäre Sprache verwendet wird. Dazu wird Get-CsAudioTestServiceApplication zunächst ohne Parameter aufgerufen, um eine Auflistung der Audiotestdienst-Kontakte zurückzugeben. Diese Auflistung wird dann an das Cmdlet Set-CsAudioTestServiceApplication weitergeleitet, das der Eigenschaft "PrimaryLanguage" für jeden Kontakt in der Auflistung den Wert "en-Us" (US-Englisch) zuweist.