Get-CsAudioTestServiceApplication
Ultima modifica dell'argomento: 2012-03-23
Consente di ottenere informazioni relative all'applicazione del servizio di verifica audio attualmente utilizzata nell'organizzazione.
Sintassi
Get-CsAudioTestServiceApplication [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>]
Descrizione dettagliata
Il servizio di verifica audio consente agli utenti di Microsoft Lync 2010 di verificare le connessioni vocali prima di effettuare una chiamata. Per ottenere questo risultato, fare clic sul pulsante Controlla qualità chiamata che si trova sulla scheda Dispositivo audio della finestra di dialogo Opzioni di Lync 2010. Quando un utente fa clic su questo pulsante, verrà effettuata una chiamata al servizio di test audio automatizzato. Alla chiamata viene risposto e, dopo la riproduzione di una breve introduzione, viene chiesto all'utente di registrare un breve messaggio. La registrazione verrà quindi riprodotta, consentendo al chiamante di ascoltare il proprio messaggio sulla connessione corrente.
Il servizio di verifica audio fa affidamento, in parte, sugli oggetti contatto di Active Directory. Questi oggetti vengono creati automaticamente durante l'installazione di Audio Bot; non esiste la possibilità di creare manualmente questi oggetti. Tuttavia gli amministratori possono utilizzare il cmdlet Get-CsAudioTestServiceApplication per recuperare le informazioni sui diversi contatti del servizio di test utilizzati al momento nell'organizzazione. Gli amministratori possono utilizzare Set-CsAudioTestServiceApplication anche per modificare le proprietà di questi contatti.
Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Get-CsAudioTestServiceApplication può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. Per ottenere un elenco di tutti i ruoli RBAC (controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati), utilizzare il seguente comando dal prompt di Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsAudioTestServiceApplication"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Facoltativo |
Parametro User ID |
Indirizzo SIP del contatto del servizio di verifica audio. |
Credential |
Facoltativo |
Oggetto PSCredential |
Consente di eseguire il cmdlet utilizzando credenziali alternative. Può essere necessario se l'account utilizzato per accedere a Windows non dispone dei privilegi necessari richiesti per lavorare con gli oggetti contatto. Per utilizzare il parametro Credential è necessario creare per prima cosa un oggetto PSCredential utilizzando il cmdlet Get-Credential. Per informazioni dettagliate, vedere nella Guida l'argomento contenente le informazioni sul cmdlet Get-Credential. |
DomainController |
Facoltativo |
FQDN |
Consente di eseguire la connessione al controller di dominio specificato per recuperare le informazioni sul contatto. Per la connessione a un controller di dominio specifico, includere il parametro DomainController seguito dal nome computer (ad esempio, atl-cs-001) o dal nome di dominio completo (FQDN) (ad esempio, atl-cs-001.litwareinc.com). |
Filter |
Facoltativo |
Stringa |
Consente di limitare i dati restituiti applicando un filtro in base ad attributi specifici per Lync Server 2010. Ad esempio, è possibile limitare i dati restituiti agli oggetti contatto della verifica audio con un nome visualizzato specifico o a quelli che fanno uso di una particolare lingua. Il parametro Filter utilizza la stessa sintassi di filtro Windows PowerShell impiegata dal cmdlet Where-Object. Ad esempio, un filtro che restituisca solo i contatti con nome visualizzato Audio Test Service Contacts assomiglierà al seguente, con DisplayName che rappresenta l'attributo di Active Directory, -eq che rappresenta l'operatore di comparazione (uguale a); "Audio Test Service Contact" che rappresenta il valore del filtro: -Filter {DisplayName -eq "Audio Test Service Contact"} Non è possibile utilizzare i parametri Filter e Identity nello stesso comando. |
OU |
Facoltativo |
Nome distinto di Active Directory |
Consente di limitare i contatti recuperati da una specifica unità organizzativa di Active Directory (OU). Il parametro OU restituisce i dati dell'unità organizzativa specificata e delle unità organizzative figlio. Ad esempio, se l'unità organizzativa Finance contiene due unità organizzative figlio, AccountsPayable e AccountsReceivable, saranno restituiti gli utenti di tutte e tre le unità organizzative. Per specificare una OU occorre utilizzare il nome distinto (DN) del contenitore, ad esempio: -OU "OU=Finance,dc=litwareinc,dc=com". |
ResultSize |
Facoltativo |
Numero intero |
Consente di limitare il numero di record restituiti da un comando. Ad esempio, per ottenere sette utenti (indipendentemente dal numero di utenti nella foresta), includere il parametro ResultSize e impostarne il valore su 7. Si noti che non c'è modo di stabilire quali saranno i sette utenti restituiti. Se si imposta ResultSize su 7, ma la foresta contiene solo tre utenti, il comando restituirà i tre utenti e verrà completato senza errori. ResultSize può essere impostato su qualsiasi numero intero compreso tra 0 e 2147483647. Se impostato su 0, il comando verrà eseguito ma i dati non verranno restituiti. |
Tipi di input
Nessuno.
Tipi restituiti
Get-CsAudioTestServiceApplication restituisce istanze dell'oggetto Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact.
Esempio
-------------------------- Esempio 1 ------------------------
Get-CsAudioTestServiceApplication
Nell'esempio precedente, viene utilizzato Get-CsAudioTestServiceApplication senza altri parametri per ottenere una raccolta di tutti i contatti del servizio di verifica audio utilizzati al momento nell'organizzazione.
-------------------------- Esempio 2 ------------------------
Get-CsAudioTestServiceApplication -Identity "sip:RedmondAudioTest@litwareinc.com"
Nell'Esempio 2 viene restituito un singolo contatto del servizio di verifica audio: il contatto con Identity sip:RedmondAudioTest@litwareinc.com.
-------------------------- Esempio 3 ------------------------
Get-CsAudioTestServiceApplication -Filter {DisplayName -like "*Redmond*"}
Nell'Esempio 3 vengono restituiti tutti i contatti del servizio verifica audio con un nome visualizzato che contiene il valore di stringa "Redmond". Per ottenere questo risultato il comando utilizza il parametro Filter ed il valore di filtro {DisplayName –like "*Redmond*"}; questo valore di filtro limita i contatti restituiti a quelli il cui nome visualizzato contiene il valore di stringa "Redmond". Questo comando restituisce i contatti con nome visualizzato "Redmond Audio Test Service Contact", "Redmond Audio Bot" e "Test Contact for Redmond".