Remove-CsQoEConfiguration
Ultima modifica dell'argomento: 2012-03-27
Consente di rimuovere una raccolta di impostazioni della qualità percepita dagli utenti (QoE).
Sintassi
Remove-CsQoEConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
La metrica QoE consente di tenere traccia delle chiamate audio e video effettuate all'interno dell'organizzazione, inclusi dati quali il numero di pacchetti di rete persi, il rumore di fondo e l'instabilità (differenze nel ritardo dei pacchetti). Questa metrica viene archiviata in un database dedicato, diverso da quello degli altri dati (ad esempio, record dettagli chiamata) e ciò consente di abilitare e disabilitare la qualità percepita dagli utenti (QoE) indipendentemente dalla registrazione degli altri dati. Utilizzare questo cmdlet per rimuovere le impostazioni di configurazione della qualità percepita dagli utenti (QoE) a livello di sito. Se si utilizza questo cmdlet nella configurazione della qualità percepita dagli utenti (QoE) a livello globale, per tutte le proprietà verranno ripristinati i valori predefiniti.
Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Remove-CsQoEConfiguration 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-CsQoEConfiguration"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Obbligatorio |
XdsIdentity |
L'identificatore univoco delle impostazioni che si desidera rimuovere. I valori possibili sono global e site:<nome sito>, dove <nome sito> è il nome del sito nella distribuzione di Microsoft Lync Server 2010 dove si trovano le impostazioni da rimuovere. |
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.QoE.QoESettings. Accetta input tramite pipeline da oggetti configurazione QoE.
Tipi restituiti
Questo cmdlet non restituisce alcun oggetto o valore. Il cmdlet rimuove invece le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.QoE.QoESettings.
Esempio
-------------------------- Esempio 1 --------------------------
Remove-CsQoEConfiguration -Identity site:Redmond
Il comando precedente utilizza il cmdlet Remove-CsQoEConfiguration per rimuovere le impostazioni della qualità percepita dagli utenti (QoE) assegnate al sito Redmond. L'utilizzo del parametro Identity fa in modo che vengano rimosse solo le impostazioni assegnate al sito specificato.
-------------------------- Esempio 2 --------------------------
Get-CsQoEConfiguration -Filter site:* | Remove-CsQoEConfiguration
Il comando riportato nell'Esempio 2 rimuove tutte le impostazioni della qualità percepita dagli utenti (QoE) assegnate nell'ambito del sito. Per ottenere questo risultato, il comando prima utilizza Get-CsQoEConfiguration e il parametro Filter per recuperare le impostazioni QoE appropriate; la stringa con caratteri jolly "site:*" fa in modo che solo le impostazioni la cui identità inizia con site: vengano restituite. La raccolta filtrata viene quindi inviata tramite pipe al cmdlet Remove-CsQoEConfiguration che elimina tutti gli elementi della raccolta.
-------------------------- Esempio 3 --------------------------
Get-CsQoEConfiguration | Where-Object {$_.KeepQoEDataForDays -lt 30} | Remove-CsQoEConfiguration
Nell'Esempio 3, vengono eliminate tutte le impostazioni della qualità percepita dagli utenti (QoE) in cui la proprietà KeepQoEDataForDays è minore di 30. Per ottenere questo risultato, il comando utilizza prima il cmdlet Get-CsQoEConfiguration senza alcun parametro aggiuntivo in modo da restituire una raccolta di tutte le impostazioni QoE attualmente in uso nell'organizzazione. La raccolta così ottenuta viene quindi inviata tramite pipe al cmdlet Where-Object che seleziona solo quelle impostazioni in cui la proprietà KeepQoEDataForDays è minore di (-lt) 30 giorni. Questa raccolta filtrata viene a sua volta inviata tramite pipe al cmdlet Remove-CsQoEConfiguration che elimina ogni elemento della raccolta.