Condividi tramite

  • Articolo

Get-CsMediaConfiguration

 

Ultima modifica dell'argomento: 2012-03-23

Restituisce informazioni sulle impostazioni multimediali, inclusi il livello di crittografia supportato, un'indicazione del fatto che Siren possa essere utilizzato come codec vocale da Mediation Server nelle interazioni con i client Microsoft Lync 2010 e la risoluzione video massima consentita.

Sintassi

Get-CsMediaConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

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

Descrizione dettagliata

Questo cmdlet consente di recuperare una o più raccolte di impostazioni che definiscono le interazioni multimediali.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Get-CsMediaConfiguration 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-CsMediaConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

XdsIdentity

L'identificatore univoco della configurazione multimediale che si desidera recuperare. Questo identificatore specifica l'ambito a cui viene applicata la configurazione (globale, sito o servizio).

Filter

Facoltativo

Stringa

Questo parametro consente di filtrare i risultati dell'operazione Get in base ai caratteri jolly specificati per il parametro.

LocalStore

Facoltativo

Parametro opzionale

Consente di recuperare la configurazione multimediale dalla replica locale di archivio di gestione centrale invece che da archivio di gestione centrale.

Tipi di input

Nessuno.

Tipi restituiti

Get-CsMediaConfiguration restituisce le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings.

Esempio

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

Get-CsMediaConfiguration

Nell'Esempio 1 vengono restituite tutte le configurazioni multimediali in uso nella propria organizzazione attraverso l'utilizzo del cmdlet Get-CsMediaConfiguration senza alcun parametro aggiuntivo.

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

Get-CsMediaConfiguration -Identity site:Redmond1

Nell'esempio precedente viene restituita solamente la configurazione multimediale con Identity site:Redmond1. Poiché le identità devono essere univoche, l'utilizzo del parametro Identity garantisce che non verrà mai recuperato più di un elemento.

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

Get-CsMediaConfiguration -Filter site:*

Nell'esempio 3, il parametro Filter è utilizzato per restituire tutte le configurazioni che sono state impostate in ambito sito. La stringa di caratteri jolly site:* garantisce che Windows PowerShell restituisca solamente le raccolte di configurazione multimediali le cui identità iniziano con la stringa site:.

-------------------------- Esempio 4 --------------------------

Get-CsMediaConfiguration | Where-Object {$_.EncryptionLevel -eq "SupportEncryption"}

In questo esempio, vengono utilizzati i cmdlet Get-CsMediaConfiguration e Where-Object per ottenere tutte le configurazioni multimediali che supportano (ma non richiedono) la crittografia. Per ottenere questo risultato, il comando utilizza prima Get-CsMediaConfiguration per recuperare tutte le configurazioni multimediali in uso nella propria organizzazione. Le informazioni vengono quindi inviate tramite pipe al cmdlet Where-Object che applica un filtro per limitare i dati restituiti a quelle configurazioni in cui la proprietà EncryptionLevel è uguale a (-eq) SupportEncryption.

-------------------------- Esempio 5 --------------------------

Get-CsMediaConfiguration -Filter *:*med*

In questo esempio vengono recuperate tutte le configurazioni multimediali definite per i siti e servizi i cui nomi contengono la stringa "med". Ad esempio, questo comando consente di recuperare le impostazioni di configurazione multimediale definite per il sito medford1, il sito TwoMedfordPlace, il servizio MediationServer:redmond.litwareinc.com.