Condividi tramite

  • Articolo

Set-CsAVEdgeConfiguration

 

Ultima modifica dell'argomento: 2012-03-26

Consente di modificare le impostazioni di configurazione per i computer che eseguono il servizio A/V Edge (questi computer sono conosciuti anche come server A/V Edge Server). Un server A/V Edge Server consente agli utenti interni di condividere dati audio e video con utenti esterni (ovvero con utenti che non hanno effettuato l'accesso alla rete interna), nonché di scambiare file e partecipare a sessioni di condivisione desktop.

Sintassi

Set-CsAVEdgeConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-MaxBandwidthPerPortKb <UInt32>] [-MaxBandwidthPerUserKb <UInt32>] [-MaxTokenLifetime <TimeSpan>] [-WhatIf [<SwitchParameter>]]

Set-CsAVEdgeConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaxBandwidthPerPortKb <UInt32>] [-MaxBandwidthPerUserKb <UInt32>] [-MaxTokenLifetime <TimeSpan>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Un server A/V Edge Server consente di scambiare traffico audio e video attraverso un firewall aziendale. In questo modo gli utenti possono tra l'altro utilizzare Microsoft Lync Server 2010 su Internet e quindi scambiare dati audio e video con utenti che hanno effettuato l'accesso al sistema all'interno del firewall. Le impostazioni di configurazione di Edge Server possono essere assegnate nell'ambito globale, del sito e del servizio. Queste impostazioni di configurazione consentono agli amministratori di effettuare operazioni quali gestire il tempo di validità dell'autenticazione utente prima del rinnovo e limitare la larghezza di banda utilizzabile da un singolo utente o da una singola porta.

Il cmdlet Set-CsAVEdgeConfiguration consente di modificare le impostazioni di configurazione del server A/V Edge Server attualmente in uso nell'organizzazione. Se non espressamente indicato dal personale del supporto tecnico Microsoft, è tuttavia consigliabile per gli amministratori non modificare le impostazioni predefinite di A/V Edge Server.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Set-CsAVEdgeConfiguration i membri dei seguenti gruppi: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control) a cui è stato assegnato questo cmdlet, inclusi gli eventuali ruoli RBAC personalizzati creati dall'utente, dal prompt di Windows PowerShell eseguire il seguente comando:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identità XDS

Identificatore univoco della raccolta di impostazioni di configurazione di A/V Edge Server da modificare. Per modificare la raccolta globale, utilizzare la sintassi seguente: -Identity global. Per modificare la raccolta di un sito, usare una sintassi simile alla seguente: -Identity site:Redmond. Le impostazioni configurate nell'ambito del servizio possono essere referenziate con una sintassi simile alla seguente: -Identity service:EdgeServer:atl-cs-001.litwareinc.com.

Instance

Facoltativo

Oggetto MediaRelaySettings

Consente di passare al cmdlet un riferimento a un oggetto anziché impostare singoli valori di parametro.

MaxBandwidthPerPortKB

Facoltativo

Numero intero

Indica la larghezza di banda massima (in kilobit al secondo) che è possibile allocare a una singola porta. È possibile impostare la larghezza di banda massima su qualsiasi valore intero compreso tra 1 e 4294967296 (4096 gigabit) al secondo. Il valore predefinito è 3000.

MaxBandwidthPerUserKB

Facoltativo

Numero intero

Indica la larghezza di banda massima (in kilobit al secondo) che è possibile allocare a un utente. È possibile impostare la larghezza di banda massima su qualsiasi valore intero compreso tra 1 e 4294967296 (4096 gigabit) al secondo. Il valore predefinito è 10000.

MaxTokenLifetime

Facoltativo

TimeSpan

Quantità massima di tempo per cui un token può essere utilizzato prima di scadere e dover essere rinnovato. Le durate dei token sono espresse utilizzando il formato seguente: Giorni.Ore:Minuti:Secondi. La durata 13 giorni ad esempio deve essere espressa come indicato di seguito, ovvero con un punto (.) dopo il numero dei giorni e due punti (:) per separare le ore, i minuti e i secondi:

13.00:00:00

Il valore predefinito di 8 ore deve essere espresso come segue:

08:00:00

La durata token minima consentita è di un minuto (00:01:00); la durata massima consentita è di 180 giorni (180.00:00:00).

Force

Facoltativo

Parametro opzionale

Consente di evitare la visualizzazione di qualunque messaggio di errore non grave che potrebbe essere generato nel corso dell'esecuzione del comando.

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.Edge.MediaRelaySettings. Set-CsAVEdgeConfiguration accetta l'input da pipeline di oggetti impostazioni di Media Relay.

Tipi restituiti

Set-CsAVEdgeConfiguration non restituisce un valore o un oggetto. Il cmdlet piuttosto configura le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.MediaRelaySettings.

Esempio

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

Set-CsAVEdgeConfiguration -Identity global -MaxTokenLifetime "04:00:00"

Nell'esempio 1 il comando modifica la proprietà MaxTokenLifetime relativa alle impostazioni di configurazione globali del server A/V Edge Server. In questo esempio la durata massima del token è impostata su 4 ore (04 ore : 00 minuti : 00 secondi).