Condividi tramite

  • Articolo

New-CsAVEdgeConfiguration

 

Ultima modifica dell'argomento: 2012-03-23

Crea una nuova raccolta di 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 utenti non connessi alla rete interna.

Sintassi

New-CsAVEdgeConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-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. Le impostazioni di configurazione di A/V Edge Server consentono agli amministratori di gestire il tempo di validità dell'autenticazione utente prima del rinnovo e di limitare la larghezza di banda utilizzabile da un singolo utente o da una singola porta.

Il cmdlet New-CsAVEdgeConfiguration consente di creare nuove raccolte di impostazioni di configurazione di A/V Edge Server nell'ambito del sito o del servizio. Come illustrato, le impostazioni A/V Edge possono anche essere configurate con ambito globale. Non è possibile tuttavia creare una nuova raccolta nell'ambito globale.

Si noti che un dato sito o servizio può ospitare al massimo un sola raccolta di impostazioni di configurazione di A/V Edge Server. Se il sito Redmond ospita già una raccolta di impostazioni di A/V Edge Server, non sarà possibile creare una nuova raccolta con Identity site:Redmond.

Se non espressamente indicato dal personale del supporto tecnico Microsoft, non è consigliabile modificare le impostazioni di configurazione di A/V Edge Server predefinite. Pertanto, non è probabilmente necessario creare una nuova raccolta di impostazioni per un sito o un servizio.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet New-CsAVEdgeConfiguration i 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 riportato di seguito dal prompt di Windows PowerShell:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Identità XDS

Identificatore univoco per la raccolta di impostazioni di configurazione A/V Edge da creare. Per creare una raccolta di impostazioni da applicare con ambiento di sito, utilizzare una sintassi analoga alla seguente: -Identity site:Redmond. Si noti che questo comando avrà esito negativo se al sito Redmond è già stata applicata una raccolta di impostazioni di configurazione di A/V Edge Server. Per le impostazioni configurate nell'ambito del servizio deve essere utilizzata una sintassi simile alla seguente: -Identity service:EdgeServer:atl-cs-001.litwareinc.com.

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

Numero intero

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.

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. New-CsAVEdgeConfiguration non accetta l'input da pipeline.

Tipi restituiti

Crea le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.MediaRelaySettings.

Esempio

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

New-CsAVEdgeConfiguration -Identity site:Redmond -MaxTokenLifetime "04:00:00"

Nell'esempio 1 viene creata una nuova raccolta di impostazioni di configurazione A/V Edge per il sito Redmond. In questo esempio il valore della proprietà MaxTokenLifetime è impostato su 4 ore (04 ore : 00 minuti : 00 secondi).

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

$x = New-CsAVEdgeConfiguration -Identity site:Redmond -InMemory
$x.MaxTokenLifetime = "04:00:00"
Set-CsAVEdgeConfiguration -Instance $x

Nell'esempio 2 viene illustrato come è possibile creare una nuova raccolta di impostazioni di configurazione di A/V Edge Server in memoria e quindi trasformare queste impostazioni virtuali in una raccolta effettiva di impostazioni di A/V Edge Server. A tale scopo, il primo comando nell'esempio crea una nuova raccolta di impostazioni per il sito Redmond. Viene aggiunto il parametro InMemory per assicurare che queste impostazioni vengano create solo in memoria e non immediatamente applicate al sito Redmond. Poiché queste impostazioni sono presenti solo in memoria, devono essere archiviate in una variabile, in questo caso una variabile denominata $x.

Nel secondo comando il valore della proprietà MaxTokenLifetime è impostato su 4 ore (04 ore : 00 minuti : 00 secondi). Nel terzo comando viene utilizzato quindi Set-CsAVEdgeConfiguration per applicare le impostazioni archiviate nella variabile $x al sito Redmond.