• Articolo

Get-CsConferenceDirectory

 

Ultima modifica dell'argomento: 2012-03-23

Restituisce informazioni sulle directory conferenza configurate per l'utilizzo nella propria organizzazione. Le directory conferenza vengono utilizzate per consentire agli utenti di conferenze telefoniche con accesso esterno di individuare le informazioni sulle conferenze.

Sintassi

Get-CsConferenceDirectory [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]

Get-CsConferenceDirectory [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrizione dettagliata

Quando si crea un URI di conferenze telefoniche con accesso esterno, all'URI viene assegnato un indirizzo SIP univoco. Tuttavia, gli indirizzi SIP sono difficili da convertire per i dispositivi non abilitati per SIP; ad esempio, un telefono PSTN (Public Switched Telephone Network) non è in grado di convertire un indirizzo SIP. Per questo motivo, Microsoft Lync Server 2010 utilizza le directory conferenza per consentire a questi dispositivi di individuare e connettersi alle conferenze con accesso esterno. Per ottenere questo risultato, viene creata una directory conferenza SIP associata ad ogni URI di conferenze con accesso esterno che viene identificata come numero intero piuttosto che come un URI SIP. I telefoni e altri dispositivi di tipo PSTN possono utilizzare questi numeri (piuttosto che un URI SIP) quando si connettono alle conferenze; infatti, il numero della directory viene incluso nell'ID conferenza PSTN che gli utenti immettono quando si connettono ad una conferenza con accesso esterno.

Il cmdlet Get-CsConferenceDirectory consente di ottenere informazioni su tutte le directory conferenza configurate per l'utilizzo nella propria organizzazione.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Get-CsConferenceDirectory può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalUserAdmins, RTCUniversalServerAdmins. 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-CsConferenceDirectory"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

XdsIdentity

Identificatore numerico (ad esempio, 7) della directory conferenza da ottenere. Se questo parametro viene omesso, il cmdlet Get-CsConferenceDirectory restituisce le informazioni su tutte le directory conferenza in uso nell'organizzazione.

Filter

Facoltativo

Stringa

Consente di utilizzare i caratteri jolly per specificare l'identità della directory (o delle directory) conferenza da ottenere. Dal momento che le identità delle directory sono valori numerici, questo parametro potrebbe avere il valore minimo. Tuttavia, questa sintassi restituirà tutte le directory conferenza la cui identità inizia con il numero 3: -Filter "3*".

LocalStore

Facoltativo

Parametro opzionale

Consente di recuperare i dati la directory conferenza dalla replica locale di archivio di gestione centrale invece che da archivio di gestione centrale.

Tipi di input

Nessuno. Get-CsConferenceDirectory non accetta input tramite pipeline.

Tipi restituiti

Get-CsConferenceDirectory restituisce le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.PstnConf.ConferenceDirectories.

Esempio

-------------------------- Esempio 1 ------------------------

Get-CsConferenceDirectory

Il comando riportato nell'Esempio 1 restituisce le informazioni su tutte le directory conferenza configurate per l'utilizzo nella propria organizzazione.

-------------------------- Esempio 2 ------------------------

Get-CsConferenceDirectory -Identity 2

Nell'Esempio 2 vengono restituite le informazioni sulla directory conferenza con Identity 2. Dal momento che le identità devono essere univoche, questo comando non restituirà mai più di una singola directory conferenza.

-------------------------- Esempio 3 ------------------------

Get-CsConferenceDirectory | Where-Object {$_.ServiceID -match "UserServer:atl-cs-001.litwareinc.com"}

Il comando precedente restituisce tutte le directory conferenza ospitate sul servizio UserServer:atl-cs-001.litwareinc.com. Per ottenere questo risultato, il comando utilizza il cmdlet Get-CsConferenceDirectory senza alcun parametro aggiuntivo in modo da ottenere una raccolta di tutte le directory conferenza trovate nell'organizzazione. Questa raccolta viene quindi inviata tramite pipe al cmdlet Where-Object che seleziona solo le directory in cui ServiceID è uguale a "UserServer:atl-cs-001.litwareinc.com".