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).
Vedere anche
Ulteriori risorse
Get-CsAVEdgeConfiguration
New-CsAVEdgeConfiguration
Remove-CsAVEdgeConfiguration