Condividi tramite

  • Articolo

Remove-CsAVEdgeConfiguration

 

Ultima modifica dell'argomento: 2012-03-27

Consente di rimuovere una raccolta esistente di impostazioni di configurazione applicate ai computer su cui è in esecuzione il servizio Access Edge (questi computer sono detti anche A/V Edge Server). Un A/V Edge Server consente agli utenti interni di condividere dati audio e video con utenti esterni (vale a dire non connessi alla rete interna).

Sintassi

Remove-CsAVEdgeConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Un A/V Edge Server offre un mezzo per scambiare traffico audio e video attraverso il firewall di un'organizzazione. Tra l'altro, ciò consente agli utenti di utilizzare Microsoft Lync Server 2010 in Internet e di scambiare i dati audio e video con gli utenti che hanno effettuato l'accesso al sistema dall'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 consentono agli amministratori di gestire il periodo di validità dell'autenticazione utente prima che sia necessario il rinnovo e di limitare la quantità di larghezza di banda utilizzabile da un singolo utente o da una singola porta.

Il cmdlet Remove-CsAVEdgeConfiguration consente di eliminare le impostazioni di configurazione A/V Edge applicate nell'ambito del sito o del servizio. Il cmdlet può essere eseguito anche sulle impostazioni globale, ma queste non saranno eliminate. In realtà, le proprietà contenute nella raccolta globale saranno riportate ai loro valori predefiniti.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Remove-CsAVEdgeConfiguration in locale: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control, controllo dell'accesso basato sui ruoli) 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 "Remove-CsAVEdgeConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Identità XDS

Identificatore univoco per le impostazioni di configurazione A/V Edge da rimuovere. Per "rimuovere" la raccolta globale, utilizzare la seguente sintassi: -Identity global. Come già osservato, le impostazioni globali non possono essere rimosse; in realtà, è possibile solamente riportare le proprietà ai valori predefiniti. Per rimuovere una raccolta di siti, utilizzare 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

Non è possibile utilizzare caratteri jolly quando si specifica l'identità di un criterio.

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. Remove-CsAVEdgeConfiguration consente di accettare l'input da pipeline di oggetti impostazioni di Media Relay. Questi oggetti sono stati recuperati eseguendo il cmdlet Get-CsAVEdgeConfiguration.

Tipi restituiti

Remove-CsAVEdgeConfiguration non restituisce alcun oggetto o valore. Il cmdlet, invece, consente di eliminare le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.MediaRelaySettings.

Esempio

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

Remove-CsAVEdgeConfiguration -Identity site:Redmond

Con il comando precedente vengono rimosse le impostazioni di configurazione A/V Edge con identità site:Redmond. Una volta rimosse le impostazioni, gli A/V Edge Server nel sito Redmond saranno governati dalle impostazioni di configurazione globali.

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

Get-CsAVEdgeConfiguration -Filter "service:*" | Remove-CsAVEdgeConfiguration

Con l'esempio 2 vengono rimosse tutte le impostazioni di configurazione A/V Edge applicate nell'ambito del servizio. A tal fine, il comando chiama per prima cosa Get-CsAVEdgeConfiguration con il parametro Filter; il valore del filtro "service:*" limita i dati restituiti alle impostazioni configurate nell'ambito del servizio. Tale raccolta filtrata viene quindi inviata tramite pipe a Remove-CsAVEdgeConfiguration, che elimina ciascun elemento nella raccolta.

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

Get-CsAVEdgeConfiguration | Where-Object {$_.MaxBandwidthPerUserKB -lt 5000} | Remove-CsAVEdgeConfiguration

Con il comando mostrato nell'esempio 3 vengono eliminate tutte le impostazioni di configurazione A/V Edge in cui il valore della proprietà MaxBandwidthPerUserKB è inferiore a 5.000 kilobit al secondo. Per eseguire questa operazione, il comando chiama per prima cosa Get-CsAVEdgeConfiguration senza parametri aggiuntivi per restituire una raccolta di tutte le impostazioni A/V Edge attualmente in uso nell'organizzazione. La raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona solo le impostazioni in cui la proprietà MaxBandwidthPerUserKB è minore di 5000. La raccolta filtrata viene quindi inviata tramite pipe a Remove-CsAVEdgeConfiguration, che elimina ciascun elemento nella raccolta.