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.
Vedere anche
Ulteriori risorse
New-CsMediaConfiguration
Set-CsMediaConfiguration
Get-CsMediaConfiguration