Condividi tramite

  • Articolo

New-CsMediaConfiguration

 

Ultima modifica dell'argomento: 2012-03-26

Consente di creare una nuova raccolta di impostazioni multimediali. Queste impostazioni possono essere utilizzate per specificare elementi quali il livello di crittografia supportato e la risoluzione video massima consentita.

Sintassi

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

Descrizione dettagliata

Questo cmdlet consente di creare una nuova raccolta di impostazioni che definiscono i comportamenti per azioni multimediali specifiche.

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

XdsIdentity

Un identificatore univoco che specifica l'ambito a cui viene applicata la configurazione (sito o servizio). Una configurazione nell'ambito del sito deve essere immessa come site:<nome sito> (ad esempio, site:Redmond). Un servizio deve essere immesso come <ruolo server>:<fqdn>, ad esempio, MediationServer:pool0.litwareinc.com. Esisterà sempre una configurazione multimediale nell'ambito globale che non potrà essere eliminata, per cui non sarà possibile creare una nuova configurazione globale.

Le configurazioni multimediali nell'ambito del servizio possono essere create solo per il servizio A/V Conferencing, Mediation Server e il server applicazioni.

EnableQoS

Facoltativo

Booleano

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

Valore predefinito: False

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.

Valore predefinito: False

EncryptionLevel

Facoltativo

EncryptionLevel

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

Valori validi:

SupportEncryption - verrà utilizzato il protocollo SRTP (Secure Real-Time Transport Protocol), se può essere negoziato.

RequireEncryption: è necessario negoziare il protocollo SRTP.

DoNotSupportEncryption: il protocollo SRTP non deve essere utilizzato.

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.

Si noti che questi valori non fanno distinzione tra maiuscole e minuscole e vengono convertiti nel formato maiuscolo/minuscolo corretto in fase di creazione della configurazione.

Valore predefinito: VGA600K

Force

Facoltativo

Parametro opzionale

Consente di evitare la visualizzazione delle richieste di conferma che altrimenti verrebbero visualizzate prima che vengano apportate le modifiche.

InMemory

Facoltativo

Parametro opzionale

Crea un riferimento a un oggetto senza eseguire realmente il commit dell'oggetto come modifica permanente. Se si assegna l'output del cmdlet chiamato con questo parametro a una variabile, è possibile apportare modifiche alle proprietà del riferimento all'oggetto e quindi eseguire il commit di queste modifiche chiamando il cmdlet Set- corrispondente.

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

Nessuno.

Tipi restituiti

Consente di creare un oggetto di tipo Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings.

Esempio

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

New-CsMediaConfiguration -Identity site:Redmond1 -EncryptionLevel RequireEncryption

Nell'Esempio 1 viene utilizzato il cmdlet New-CsMediaConfiguration per creare una nuova raccolta di configurazioni multimediali con Identity site:Redmond1. Questa nuova configurazione prevede che entrambe le parti coinvolte in una conversazione multimediale utilizzino la crittografia. Questo requisito viene imposto aggiungendo il parametro EncryptionLevel e impostandolo su RequireEncryption.

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

New-CsMediaConfiguration -Identity MediationServer:pool0.litwareinc.com -EnableSiren $True

In questo esempio viene utilizzato il cmdlet New-CsMediaConfiguration per creare una nuova raccolta di configurazioni multimediali con Identity MediationServer:pool0.litwareinc.com. In questa nuova configurazione, il parametro EnableSiren è impostato su True e di conseguenza il codec Siren è abilitato per le chiamate che coinvolgono Mediation Server.