New-CsNetworkMediaBypassConfiguration
Ultima modifica dell'argomento: 2012-03-26
Crea nuove impostazioni globali per il bypass multimediale.
Sintassi
New-CsNetworkMediaBypassConfiguration [-AlwaysBypass <$true | $false>] [-BypassID <String>] [-Enabled <$true | $false>] [-EnableDefaultBypassID <$true | $false>] [-ExternalBypassMode <Nullable>] [-InternalBypassMode <Nullable>]
Descrizione dettagliata
Questo cmdlet consente di creare impostazioni globali per il bypass multimediale delle connessioni audio.
A differenza della maggior parte dei cmdlet New- in Microsoft Lync Server 2010, questo cmdlet non salva immediatamente la nuova configurazione, ma crea le impostazioni unicamente in memoria. L'oggetto creato da questo cmdlet deve essere salvato in una variabile e quindi assegnato alla proprietà MediaBypassSettings della configurazione di rete. Per informazioni dettagliate, vedere la sezione Esempi di questo argomento.
Le impostazioni create con questo cmdlet possono essere recuperate solo accedendo alla proprietà MediaBypassSettings della configurazione di rete globale. Per recuperare queste impostazioni, eseguire questo comando: (Get-CsNetworkConfiguration).MediaBypassSettings.
Utenti che possono eseguire questo cmdlet: per impostazione predefinita, il cmdlet New-CsNetworkMediaBypassConfiguration può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC a cui è stato assegnato questo cmdlet (compresi eventuali ruoli RBAC personalizzati creati autonomamente), eseguire il cmdlet seguente dal prompt di Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsNetworkMediaBypassConfiguration"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
AlwaysBypass |
Facoltativo |
Booleano |
Impostando questo parametro su True viene effettuato un tentativo di bypass multimediale per tutte le chiamate. Impostare il valore di questo parametro su True solo se il servizio Controllo di ammissione di chiamata non è implementato o è disabilitato. Impostare questo parametro su True solo per le distribuzioni in cui: - Non è necessario il controllo della larghezza di banda. - Non è necessaria una configurazione con granularità fine per determinare quando dovrebbe avvenire il bypass. - Esiste la piena connettività tra gateway e client. Se il parametro Enabled è impostato su True e AlwaysBypass è impostato su False, la logica di bypass utilizzerà i siti e le regioni di configurazione della rete per determinare quando è possibile il bypass. Se si imposta AlwaysBypass su True ma non si imposta anche il valore del parametro Enabled su True, viene visualizzato un messaggio di avviso. L'impostazione Ignora sempre viene ignorata se l'opzione Abilitato è impostata su false. Impostando sia AlwaysBypass sia Enabled su True viene generato automaticamente un ID di bypass che sarà memorizzato nella proprietà BypassID. Valore predefinito: False |
BypassID |
Facoltativo |
Stringa |
ID di bypass multimediale. Se il parametro AlwaysBypass è impostato su True e viene fornito un valore per questo parametro, il valore BypassID sarà associato a tutte le subnet. Se AlwaysBypass è False, il valore BypassID viene associato a tutte le subnet che non sono presenti nelle regioni e nei siti di configurazione della rete. Questo ID deve essere nel formato di un GUID (ad esempio, 96f14dea-5170-429a-b92b-f1cb909c4bb6). Tuttavia, in genere non è necessario impostare o modificare questo parametro. Questo valore viene generato automaticamente quando Enabled è impostato su True e quando 1) AlwaysBypass è impostato su True o 2) il parametro EnableDefaultBypassID è impostato su True. |
Enabled |
Facoltativo |
Booleano |
L'impostazione di questo parametro su True consente di abilitare il bypass multimediale. A questo punto le decisioni di bypass saranno basate sul valore dell'impostazione AlwaysBypass, secondo quanto riportato di seguito: - Se AlwaysBypass è True, il bypass viene tentato per tutte le chiamate. - Se AlwaysBypass è False, utilizzare la regione e il sito di configurazione della rete per determinare se il bypass è possibile. Valore predefinito: False |
EnableDefaultBypassID |
Facoltativo |
Booleano |
Questo valore viene applicato solo se AlwaysBypass è impostato su False. Impostando questo valore su True viene generato automaticamente un ID di bypass, che sarà memorizzato nella proprietà BypassID. Questo parametro è utile quando esiste un core ben connesso a siti remoti che presentano collegamenti con larghezza di banda vincolata. L'amministratore deve definire solamente le subnet associate ai siti remoti attraverso le aree e i siti di configurazione di rete. Eventuali subnet associate al core non devono essere definite e tra queste subnet sarà tentato automaticamente il bypass. Valore predefinito: False |
ExternalBypassMode |
Facoltativo |
BypassModeEnumType |
Riservato per utilizzi futuri. Il bypass multimediale esterno non è supportato in Lync Server 2010. Valore predefinito: Off |
InternalBypassMode |
Facoltativo |
BypassModeEnumType |
Il valore di questo parametro stabilisce quando i client che si connettono dall'interno della rete dell'organizzazione possono tentare l'esecuzione del bypass multimediale. Se Enabled è impostato su True, questo valore viene automaticamente cambiato in Any. Altri valori di questo parametro sono riservati per l'uso in futuro. Valore predefinito: Off |
Tipi di input
Nessuno.
Tipi restituiti
Consente di creare un riferimento oggetto di tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.MediaBypassSettingsType.
Esempio
-------------------------- Esempio 1 --------------------------
$a = New-CsNetworkMediaBypassConfiguration -AlwaysBypass $true -Enabled $true
Set-CsNetworkConfiguration -MediaBypassSettings $a
I comandi in questo esempio abilitano il bypass multimediale e lo configurano per tentare sempre il bypass. La prima riga dell'esempio è una chiamata al cmdlet New-CsNetworkMediaBypassConfiguration. Vengono passati due parametri a questo cmdlet, AlwaysBypass ed Enabled, impostati entrambi su True ($true). Con l'impostazione di Enabled su True viene abilitato il bypass multimediale, mentre impostando AlwaysBypass su True si garantisce il tentativo di applicare il bypass multimediale a tutte le chiamate. Con l'impostazione di questi due parametri viene automaticamente generato un valore per la proprietà BypassID. New-CsNetworkMediaBypassConfiguration consente di creare l'oggetto solo in memoria, pertanto l'oggetto viene assegnato alla variabile $a.
La configurazione del bypass multimediale viene memorizzata con le impostazioni di configurazione della rete. Di conseguenza, nella riga 2 dell'esempio vengono salvate le modifiche di configurazione del bypass multimediale apportate alla configurazione di rete chiamando il cmdlet Set-CsNetworkConfiguration e passando al parametro MediaBypassSettings l'oggetto di configurazione del bypass multimediale ($a) creato nella riga 1.
-------------------------- Esempio 2 --------------------------
$a = (Get-CsNetworkConfiguration).MediaBypassSettings
$a.AlwaysBypass = $false
Set-CsNetworkConfiguration -MediaBypassSettings $a
Non esiste un cmdlet Set-CsNetworkMediaBypassConfiguration in Lync Server, quindi per modificare le impostazioni esistenti occorre creare una nuova configurazione (come mostrato nell'esempio 1) per sostituire la configurazione esistente, oppure è necessario modificare le impostazioni recuperando quelle esistenti, cambiandole e poi salvando le modifiche con il cmdlet Set-CsNetworkConfiguration. Con questo esempio viene dimostrata la disattivazione dell'opzione AlwaysBypass con quest'ultima possibilità.
Nella prima riga nell'esempio vengono recuperare le impostazioni di bypass multimediale esistenti. A questo scopo, viene chiamato Get-CsNetworkConfiguration. La chiamata a questo cmdlet si trova tra parentesi per garantire che il cmdlet venga completato prima che siano eseguite altre parti del comando. Get-CsNetworkConfiguration recupera tutte le impostazioni per un'intera configurazione di rete. Poiché siamo interessati unicamente alle impostazioni di bypass multimediale, occorre specificare la proprietà MediaBypassSettings per recuperare solo queste impostazioni. Le impostazioni vengono assegnate alla variabile $a.
Nella riga 2 vengono modificate le impostazioni memorizzate nella variabile $a assegnando il valore False ($false) alla proprietà AlwaysBypass. Infine, nella riga 3 viene chiamato Set-CsNetworkConfiguration, passando al parametro MediaBypassSettings la variabile $a, che salva le modifiche apportate alla proprietà AlwaysBypass.