• Articolo

Remove-CsMediaConfiguration

 

Ultima modifica dell'argomento: 2012-03-26

Consente di rimuovere la raccolta di impostazioni di configurazione multimediale specificata

Sintassi

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

Descrizione dettagliata

Questo cmdlet rimuove una raccolta di impostazioni multimediali. Queste impostazioni sono relative alle chiamate audio e video tra endpoint client.

Questo cmdlet può essere utilizzato anche per rimuovere le impostazioni multimediali globali. In questo caso, però, le impostazioni non vengono effettivamente rimosse; in realtà, vengono ripristinate ai loro valori predefiniti.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Remove-CsMediaConfiguration può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalServerAdmins. Per ottenere un elenco di tutti i ruoli RBAC (controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati), utilizzare il seguente comando dal prompt di Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsMediaConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

XdsIdentity

L'identificatore univoco delle impostazioni di configurazione multimediali che si desidera rimuovere. Questo identificatore specifica l'ambito a cui viene applicata la configurazione (globale, sito o servizio).

Force

Facoltativo

Parametro opzionale

Consente di evitare la visualizzazione delle richieste di conferma che altrimenti verrebbero visualizzate prima che vengano apportate le modifiche.

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.Media.MediaSettings. Accetta input tramite pipeline da oggetti configurazione multimediale.

Tipi restituiti

Consente di rimuovere un oggetto di tipo Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings.

Esempio

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

Remove-CsMediaConfiguration -Identity site:Redmond1

Con l'esempio 1 viene utilizzato Remove-CsMediaConfiguration per eliminare la nuova raccolta di configurazione multimediale con Identity site:Redmond1. Quando le impostazioni multimediali vengono rimosse dall'ambito del sito, il sito inizia automaticamente a utilizzare le impostazioni multimediali globali.

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

Get-CsMediaConfiguration | Where-Object {$_.EncryptionLevel -eq "RequireEncryption"} | Remove-CsMediaConfiguration

Nell'esempio precedente vengono utilizzati tre cmdlet (Get-CsMediaConfiguration, Where-Object e Remove-CsMediaConfiguration) per rimuovere tutte le raccolte di configurazione multimediale che richiedono la crittografia per tutte le parti coinvolte nella conversazione. Per ottenere questo risultato, il comando utilizza prima il cmdlet Get-CsMediaConfiguration per ottenere tutte le raccolte di configurazione multimediale dell'organizzazione. Le informazioni vengono quindi inviate tramite pipe al cmdlet Where-Object che applica un filtro per limitare i dati della pipeline alle raccolte per cui la proprietà EncryptionLevel è uguale a (-eq) RequireEncryption. Infine, il gruppo di dati filtrati viene inviato al cmdlet Remove-CsMediaConfiguration che elimina ogni elemento nel gruppo.

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

Get-CsMediaConfiguration -Filter service:* | Remove-CsMediaConfiguration

Con questo esempio vengono rimosse tutte le configurazioni multimediali definite con ambito servizio (vale a dire che la configurazione si applica a un servizio specifico). Questo risultato viene ottenuto utilizzando il cmdlet Get-CsMediaConfiguration con Filter service:*. Questo filtro recupera tutte le raccolte di configurazione multimediali la cui Identity inizia con service:, cioè tutte le raccolte nell'ambito del servizio. Il gruppo di raccolte viene quindi inviato tramite pipe al cmdlet Remove-CsMediaConfiguration che le rimuove tutte.