Get-CsAudioTestServiceApplication
Letztes Änderungsdatum des Themas: 2012-03-23
Ermöglicht das Zurückgeben von Informationen zur Audiotestdienst-Anwendung, die in Ihrer Organisation verwendet wird.
Syntax
Get-CsAudioTestServiceApplication [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>]
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 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 sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Get-CsAudioTestServiceApplication lokal auszuführen: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. 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-CsAudioTestServiceApplication"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Optional |
Benutzer-ID |
SIP-Adresse des Audiotestdienst-Kontakts. |
Credential |
Optional |
PS-Objekt mit Anmeldeinformationen |
Ermöglicht die Ausführung des Cmdlets mit anderen Anmeldeinformationen. Dies kann notwendig sein, wenn das für die Anmeldung bei Windows verwendete Konto nicht über die erforderlichen Berechtigungen verfügt, um mit Kontaktobjekten zu arbeiten. Zur Verwendung des Parameters "Credential" muss zunächst mit dem Cmdlet Get-Credential das PS-Objekt mit Anmeldeinformationen erstellt werden. Einzelheiten finden Sie im Hilfethema zum Cmdlet Get-Credential. |
DomainController |
Optional |
FQDN |
Ermöglicht es Ihnen, zum Abrufen von Kontaktinformationen eine Verbindung mit dem angegebenen Domänencontroller herzustellen. Zum Herstellen einer Verbindung mit einem bestimmten Domänencontroller nehmen Sie den Parameter "DomainController" auf und geben anschließend den Computernamen (z. B. "atl-cs-001") oder den vollqualifizierten Domänennamen (z. B. "atl-cs-001.litwareinc.com") an. |
Filter |
Optional |
Zeichenfolge |
Ermöglicht die Einschränkung der zurückgegebenen Daten, indem diese nach Lync Server 2010-spezifischen Attributen gefiltert werden. Die zurückgegebenen Daten können z. B. auf Audiotestkontakt-Objekte beschränkt werden, die einen bestimmten Anzeigenamen aufweisen oder eine bestimmte Sprache verwenden. Der Parameter "Filter" verwendet dieselbe Windows PowerShell-Filterungssyntax wie das Cmdlet Where-Object. Ein Filter, der beispielsweise nur Kontakte mit dem Anzeigenamen "Audio Test Service Contacts" zurückgibt, sieht folgendermaßen aus, wobei "DisplayName" für das Active Directory-Attribut steht, "-eq" den Vergleichsoperator (equal to) darstellt, und "Audio Test Service Contact" der Filterwert ist: -Filter {DisplayName -eq "Audio Test Service Contact"} Sie können die Parameter "Filter" und "Identity" nicht im gleichen Befehl verwenden. |
OU |
Optional |
Active Directory-DN (Distinguished Name) |
Ermöglicht es Ihnen, Kontakte aus einer bestimmten Active Directory-Organisationseinheit (Organizational Unit, OU) zurückzugeben. Der Parameter "OU" gibt Daten aus der angegebenen OU und allen untergeordneten OUs zurück. Wenn die OU "Finance" z. B. über zwei untergeordnete OUs verfügt ("AccountsPayable" und "AccountsReceivable") werden alle Benutzer aus diesen drei OUs zurückgegeben. Verwenden Sie beim Angeben einer Organisationseinheit den Distinguished Name (DN) des Containers, z. B.: -OU "OU=Finance,dc=litwareinc,dc=com". |
ResultSize |
Optional |
Ganze Zahl |
Ermöglicht es Ihnen, die Anzahl von zurückgegebenen Datensätzen einzuschränken. Um beispielsweise sieben Benutzer zurückzugeben (unabhängig von der Anzahl von Benutzern in der Gesamtstruktur), verwenden Sie den Parameter "ResultSize" und setzen seinen Wert auf 7. Beachten Sie, dass nicht garantiert werden kann, welche sieben Benutzer zurückgegeben werden. Wenn Sie "ResultSize" auf 7 festlegen, jedoch nur drei Benutzer in Ihrer Gesamtstruktur vorhanden sind, werden diese drei Benutzer zurückgegeben, und der Befehl wird anschließend ohne Fehler abgeschlossen. Für die Ergebnisgröße kann ein ganzzahliger Wert zwischen einschließlich 0 und 2147483647 festgelegt werden. Bei Festlegung von 0 wird der Befehl ausgeführt, es werden jedoch keine Daten zurückgegeben. |
Eingabetypen
Keine.
Rückgabetypen
Mit Get-CsAudioTestServiceApplication werden Instanzen des Objekts "Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact" zurückgegeben.
Beispiel
-------------------------- Beispiel 1 --------------------------
Get-CsAudioTestServiceApplication
Im vorstehenden Beispiel wird Get-CsAudioTestServiceApplication ohne zusätzliche Parameter aufgerufen, um eine Auflistung aller Audiotestdienst-Kontakte zurückzugeben, die gegenwärtig in der Organisation verwendet werden.
-------------------------- Beispiel 2 --------------------------
Get-CsAudioTestServiceApplication -Identity "sip:RedmondAudioTest@litwareinc.com"
In Beispiel 2 wird ein einzelner Audiotestdienst-Kontakt zurückgegeben: Der Kontakt weist die Identität "sip:RedmondAudioTest@litwareinc.com" auf.
-------------------------- Beispiel 3 --------------------------
Get-CsAudioTestServiceApplication -Filter {DisplayName -like "*Redmond*"}
In Beispiel 3 werden alle Audiotestdienst-Kontakte zurückgegeben, deren Anzeigename die Zeichenfolge "Redmond" enthält. Hierzu verwendet der Befehl den Parameter "Filter" und den Filterwert "{DisplayName –like "*Redmond*"}". Dieser Filterwert schränkt die zurückgegeben Daten auf die Kontakte ein, deren Anzeigenamen die Zeichenfolge "Redmond" enthält. Mit diesem Befehl werden Kontakte mit Anzeigenamen wie "Redmond Audio Test Service Contact", "Redmond Audio Bot" und "Test Contact for Redmond" zurückgegeben.