Condividi tramite

  • Articolo

Remove-CsDiagnosticConfiguration

 

Ultima modifica dell'argomento: 2012-03-25

Rimuove una o più raccolte di impostazioni di configurazione della diagnostica attualmente in uso nell'organizzazione. Le impostazioni di configurazione della diagnostica vengono utilizzate per determinare se il traffico proveniente o diretto verso un determinato dominio o URI (Uniform Resource Identifier) viene registrato nei file di registro di Microsoft Lync Server 2010.

Sintassi

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

Descrizione dettagliata

Se si abilita la registrazione per Lync Server 2010, per impostazione predefinita verrà incluso nei file di registro il traffico diretto o proveniente da un qualsiasi dominio o URI. In questo modo, nei file di registro verrà inclusa la maggior quantità di informazioni possibile.

Esiste tuttavia il rischio che una tale quantità di informazioni risulti eccessiva. Se ad esempio si verificano problemi di connettività con un determinato dominio, è possibile limitare la registrazione al traffico tra la rete e il dominio specifico. In questo modo risulterà più semplice identificare i record pertinenti e potrebbero pertanto essere agevolate la diagnosi e la risoluzione del problema.

Le impostazioni di configurazione della diagnostica consentono di specificare i domini o gli URI che verranno registrati nei file di registro. Se è abilitato un filtro di diagnostica, verrà registrato solo il traffico diretto o proveniente dai domini specificati. Lync Server consente di creare impostazioni di configurazione della diagnostica e di applicare filtri di diagnostica nell'ambito del sito. Ciò consente a sua volta di applicare ad esempio filtri al sito Redmond lasciando disabilitati i filtri negli altri siti.

È possibile utilizzare il cmdlet Remove-CsDiagnosticConfiguration per rimuovere le impostazioni di configurazione della diagnostica create nell'ambito del sito. Il cmdlet Remove-CsDiagnosticConfiguration può essere eseguito anche per le impostazioni di configurazione della diagnostica globali. In questo caso tuttavia la raccolta non verrà eliminata, in quanto in Lync Server le raccolte globali non possono essere eliminate. La rimozione di una raccolta globale tuttavia fa sì che per tutte le relative proprietà vengano ripristinati i valori predefiniti. Tutti i filtri aggiunti alla raccolta verranno pertanto rimossi.

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Identità XDS

Identificatore univoco delle impostazioni di configurazione della diagnostica da rimuovere. Per rimuovere le impostazioni configurate nell'ambito del sito, utilizzare una sintassi simile a quella riportata di seguito: -Identity "site:Redmond".

Il cmdlet Remove-CsDiagnosticConfiguration può anche essere eseguito per le impostazioni globali di configurazione. In questo caso, utilizzare la sintassi -Identity global. Le impostazioni globali non verranno effettivamente rimosse, ma verranno ripristinati i valori predefiniti di tutte le relative proprietà.

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.Diagnostics.DiagnosticFilterSettings. Remove-CsDiagnosticConfiguration accetta le istanze da pipeline dell'oggetto impostazioni filtro di diagnostica.

Tipi restituiti

Nessuno. Remove-CsDiagnosticConfiguration piuttosto elimina le istanze esistenti dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticFilterSettings.

Esempio

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

Remove-CsDiagnosticConfiguration -Identity site:Redmond

Con il comando precedente vengono eliminate le impostazioni di configurazione della diagnostica con valore Identity site:Redmond.

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

Get-CsDiagnosticConfiguration -Filter site:* | Remove-CsDiagnosticConfiguration

Con il comando riportato nell'esempio 2 vengono eliminate tutte le impostazioni di configurazione della diagnostica definite nell'ambito del sito. A tale scopo, il comando chiama innanzitutto Get-CsDiagnosticConfiguration con il parametro Filter. Il valore di filtro "site:*" restituisce solo i dati relativi alle impostazioni con valore Identity che inizia con i caratteri "site:". La raccolta filtrata viene quindi inviata tramite pipe a Remove-CsDiagnosticConfiguration, che rimuove ogni elemento della raccolta.

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

Get-CsDiagnosticConfiguration | Remove-CsDiagnosticConfiguration

Con il comando riportato nell'esempio 3 vengono eliminate tutte le impostazioni di configurazione della diagnostica attualmente in uso nell'organizzazione. Per eseguire questa attività, viene chiamato innanzitutto Get-CsDiagnosticConfiguration senza alcun parametro per restituire una raccolta di tutte le impostazioni di configurazione della diagnostica attualmente in uso nell'organizzazione. Questi elementi vengono quindi inviati tramite pipe a Remove-CsDiagnosticConfiguration, che rimuove ogni elemento della raccolta.