Condividi tramite

  • Articolo

Get-CsAVEdgeConfiguration

 

Ultima modifica dell'argomento: 2012-03-23

Restituisce informazioni di configurazione per i computer in cui è in esecuzione il servizio A/V Edge nell'organizzazione. Le impostazioni di configurazione disponibili in tali computer, noti anche come A/V Edge Server, consentono 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

Get-CsAVEdgeConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsAVEdgeConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrizione dettagliata

Un computer A/V Edge Server consente di scambiare traffico audio e video attraverso il 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 A/V Edge consentono agli amministratori di effettuare operazioni quali gestire la durata del periodo 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 Get-CsAVEdgeConfiguration consente di recuperare informazioni sulle impostazioni di configurazione A/V Edge attualmente in uso nell'organizzazione.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Get-CsAVEdgeConfiguration i membri dei seguenti gruppi: RTCUniversalUserAdmins, 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 "Get-CsAVEdgeConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identità XDS

Identificatore univoco per la raccolta delle impostazioni di configurazione di A/V Edge da recuperare. Per recuperare la raccolta globale, la sintassi utilizzata è la seguente: -Identity global. Per recuperare una raccolta di siti, utilizzare una sintassi analoga 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. Non è possibile utilizzare i caratteri jolly per specificare l'identità di un criterio.

Se il parametro non è incluso, Get-CsAVEdgeConfiguration restituirà una raccolta di tutte le impostazioni di configurazione Edge attualmente in uso nell'organizzazione.

Filter

Facoltativo

Stringa

Consente l'utilizzo di caratteri jolly quando si specificano le impostazioni di configurazione A/V Edge da restituire. Ad esempio, per restituire tutte le impostazioni configurate nell'ambito del sito, utilizzare la seguente sintassi: -Filter site:*. Per restituire una raccolta di tutte le impostazioni configurate nell'ambito del servizio, utilizzare la seguente sintassi: -Filter "service:*".

LocalStore

Facoltativo

Parametro opzionale

Recupera i dati di configurazione A/V Edge dalla replica locale dell'archivio di gestione centrale anziché dall'archivio di gestione centrale stesso.

Tipi di input

Nessuno. Get-CsAVEdgeConfiguration non accetta l'input da pipeline.

Tipi restituiti

Get-CsAVEdgeConfiguration restituisce istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.MediaRelaySettings.

Esempio

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

Get-CsAVEdgeConfiguration

Il comando mostrato nell'esempio 1 restituisce una raccolta di tutte le impostazioni di configurazione di A/V Edge configurate per l'utilizzo nell'organizzazione. La chiamata a Get-CsAVEdgeConfiguration senza ulteriori parametri restituisce sempre una raccolta completa di impostazioni di configurazione A/V Edge.

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

Get-CsAVEdgeConfiguration -Identity site:Redmond

Nell'esempio 2 viene restituita una singola raccolta di impostazioni di configurazione di A/V Edge: la raccolta con Identity site:Redmond.

-------------------------- Esempio 3 ------------------------

Get-CsAVEdgeConfiguration -Filter "site:*"

Con il comando precedente viene restituita una raccolta di tutte le impostazioni di configurazione di A/V Edge configurate nell'ambito del sito. A tale scopo, viene chiamato Get-CsAVEdgeConfiguration con il parametro Filter. Il valore di filtro "site:*" limita i dati restituiti alle impostazioni con valore Identity che inizia con i caratteri "site:". Per definizione, i dati restituiti vengono così limitati alle impostazioni configurate nell'ambito del sito.

-------------------------- Esempio 4 ------------------------

Get-CsAVEdgeConfiguration | Where-Object {$_.MaxBandwidthPerUserKB -gt 10000}

Nell'esempio 4 le uniche impostazioni di configurazione A/V Edge restituite sono quelle in cui la proprietà MaxBandwidthPerUserKB è maggiore di 10.000 kilobit al secondo. Per eseguire questa attività, nel comando viene innanzitutto chiamato Get-CsAVEdgeConfiguration senza alcun parametro. In questo modo, viene restituita una raccolta di tutte le impostazioni di configurazione A/V Edge attualmente in uso. Tale raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona solo le impostazioni in cui la proprietà MaxBandwidthPerUserKB è maggiore di 10000 kilobit al secondo.

-------------------------- Esempio 5 ------------------------

Get-CsAVEdgeConfiguration | Where-Object {$_.MaxBandwidthPerUserKB -eq 10000}

L'esempio 5 è analogo al comando mostrato nell'esempio 4. Nell'esempio 5 tuttavia le uniche impostazioni A/V Edge restituite sono quelle in cui la proprietà MaxBandwidthPerUserKB è esattamente uguale a 10000 kilobit al secondo.

-------------------------- Esempio 6 ------------------------

Get-CsAVEdgeConfiguration | Where-Object {$_.MaxTokenLifetime -lt "08:00:00"}

Il comando mostrato nell'esempio 6 restituisce solo le impostazioni di configurazione A/V Edge in cui la proprietà MaxTokenLifetime è minore di 8 ore (08 ore : 00 minuti : 00 secondi). A tale scopo, nel comando viene innanzitutto chiamatoGet-CsAVEdgeConfiguration senza alcun parametro per restituire una raccolta di tutte le impostazioni di configurazione A/V Edge utilizzate nell'organizzazione. La raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona solo le impostazioni in cui MaxTokenLifetime è minore di 8 ore (08:00:00).