• Articolo

Set-CsMediaConfiguration

 

Ultima modifica dell'argomento: 2012-03-26

Modifica una raccolta esistente di impostazioni multimediali.

Sintassi

Set-CsMediaConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-EnableQoS <$true | $false>] [-EnableSiren <$true | $false>] [-EncryptionLevel <SupportEncryption | RequireEncryption | DoNotSupportEncryption>] [-Force <SwitchParameter>] [-MaxVideoRateAllowed <CIF250K | VGA600K | Hd720p15M>] [-WhatIf [<SwitchParameter>]]

Set-CsMediaConfiguration [-Confirm [<SwitchParameter>]] [-EnableQoS <$true | $false>] [-EnableSiren <$true | $false>] [-EncryptionLevel <SupportEncryption | RequireEncryption | DoNotSupportEncryption>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaxVideoRateAllowed <CIF250K | VGA600K | Hd720p15M>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Questo cmdlet consente di modificare una raccolta di impostazioni che definiscono la configurazione multimediale. Queste azioni sono relative a chiamate audio e video tra endpoint client.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Set-CsMediaConfiguration in locale: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control, controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (compresi eventuali ruoli RBAC personalizzati creati autonomamente), eseguire il cmdlet riportato di seguito dal prompt di Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsMediaConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identità XDS

L'identificatore univoco delle impostazioni di configurazione multimediali che si desidera modificare. Questo identificatore specifica l'ambito a cui viene applicata la configurazione (globale, sito o servizio).

Instance

Facoltativo

MediaSettings

Un'istanza dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings. Per recuperare questo oggetto è possibile chiamare il cmdlet Get-CsMediaConfiguration con un'identità specifica. È quindi possibile assegnare nuovi valori alle proprietà dell'oggetto e poi salvare le modifiche passando l'oggetto a Set-CsMediaConfiguration.

EnableQoS

Facoltativo

Booleano

QoS consente di monitorare la qualità dei segnali vocali in una rete.

EnableSiren

Facoltativo

Booleano

Per impostazione predefinita, Mediation Server non effettua la negoziazione di Siren come possibile codec per le chiamate tra se stesso e altri client Microsoft Lync 2010. Se questa impostazione è True, Siren viene incluso come possibile codec per l'utilizzo tra Mediation Server e altri client Lync 2010.

EncryptionLevel

Facoltativo

EncryptionLevel

Il livello di crittografia tra le entità di Unified Communications.

Valori validi:

SupportEncryption: viene utilizzato Secure Real-Time Transport Protocol (SRTP) se è possibile effettuare la negoziazione.

RequireEncryption: SRTP deve essere negoziato.

DoNotSupportEncryption: SRTP non deve essere utilizzato.

Per questo valore non viene fatta distinzione tra maiuscole e minuscole. Per informazioni dettagliate, vedere gli esempi in questo argomento.

Valore predefinito: RequireEncryption

MaxVideoRateAllowed

Facoltativo

MaxVideoRateAllowed

La velocità massima di trasferimento dei segnali video agli endpoint client.

Valori validi: Hd720p15M, VGA600K, CIF250K

Hd720p15M - Alta definizione, con risoluzione 1280 x 720 e proporzioni 16:9.

VGA600K - VGA, con risoluzione 640 x 480, 25 fps e proporzioni 4:3.

CIF250K - Formato video CIF (Common Intermediate Format), 15 fps con risoluzione 352 x 288.

Questi valori non fanno distinzione tra maiuscole e minuscole e vengono convertiti nel formato maiuscolo/minuscolo corretto in fase di creazione della configurazione. Per informazioni dettagliate, vedere gli esempi in questo argomento.

Valore predefinito: VGA600K

Force

Facoltativo

Parametro opzionale

Elimina qualsiasi richiesta di conferma che, in caso contrario, sarebbe visualizzata prima di effettuare le modifiche.

WhatIf

Facoltativo

Parametro opzionale

Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.

Confirm

Facoltativo

Parametro opzionale

Viene visualizzata una richiesta di conferma prima di eseguire il comando.

Tipi di input

Oggetto Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings. Consente di accettare l'input da pipeline di oggetti configurazione multimediale.

Tipi restituiti

Set-CsMediaConfiguration non restituisce alcun oggetto o valore. Il cmdlet, invece, consente di configurare le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings.

Esempio

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

Set-CsMediaConfiguration -Identity site:Redmond1 -MaxVideoRateAllowed hd720p15m

Con l'esempio mostrato sopra viene modificata la raccolta di configurazioni multimediali il cui parametro Identity è site:Redmond1. In particolare, il comando imposta il valore della proprietà MaxVideoRateAllowed su Hd720p15M. Si noti che il valore passato al parametro MaxVideoRateAllowed deve essere uno dei valori specificati nella descrizione del parametro. Si noti inoltre per i valori non viene fatta distinzione tra maiuscole e minuscole. Il valore immesso qui come hd720p15m viene automaticamente convertito nella forma appropriata (in questo caso Hd720p15M).

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

Set-CsMediaConfiguration site:Redmond1 -EncryptionLevel donotsupportencryption

Con questo esempio la raccolta di configurazioni multimediali con identità site:Redmond1 viene modificata in modo da utilizzare il valore DoNotSupportEncryption per EncryptionLevel. Questo valore non fa distinzione tra maiuscole e minuscole; il valore è stato immesso come donotsupportencryption, ma sarà considerato valido in quanto viene automaticamente convertito nella forma mista (DoNotSupportEncryption).