Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
SI APPLICA A:
2013
2016
2019
Subscription Edition
SharePoint in Microsoft 365
Quando si esegue lo script Microsoft PowerShell di BackupMonitoringSettings.ps1 in una farm di SharePoint, creare un file chiamato Profilo. Profilo segue un XML Schema. È possibile modificare le impostazioni degli elementi dello schema per creare un Profilo personalizzato. È possibile utilizzare quindi il Profilo personalizzato per automatizzare la configurazione delle impostazioni di monitoraggio in un ambiente di SharePoint. Per informazioni introduttive sulla configurazione del monitoraggio tramite script, vedere Panoramica sulla configurazione del monitoraggio tramite script in SharePoint Server.
Gli amministratori possono eseguire gli script prima, durante e dopo le modifiche alla farm, come ad esempio, topologia della farm, principali modifiche di sicurezza, applicazione degli aggiornamenti software o esecuzione di un test delle prestazioni. Gli script modificano le impostazioni affinché tutti i dati di monitoraggio necessari vengano raccolti durante l'evento senza sovraccaricare il database di registrazione durante il normale funzionamento.
Nota
[!NOTA] È necessario scaricare gli script PowerShell per eseguire il backup, ripristinare o modificare le impostazioni di monitoraggio della farm. Gli script sono disponibili in TechNet Gallery in Scripted Monitoring Configuration - BackupMonitoringSettings e Scripted Monitoring Configuration - AlterMonitoringSettings. Lo script BackupMonitoringSettings.ps1 PowerShell crea il Profilo di backup dal quale creare altri Profili.
È possibile creare uno o più Profili per regolare il livello di monitoraggio nelle varie fasi del ciclo di vita di SharePoint. È inoltre possibile utilizzare un Profilo personalizzato per configurare il monitoraggio in diverse farm contemporaneamente.
Generalmente vengono creati Profili per i seguenti scopi:
Per completare la configurazione delle impostazioni di monitoraggio in una farm dopo l'installazione di SharePoint Server
Per modificare le impostazioni di monitoraggio in una farm appena prima di una modifica amministrativa, ad esempio la modifica delle impostazioni in un'applicazione del servizio di ricerca nella farm
Di conseguenza, è possibile acquisire più dati di monitoraggio correlati a tale modifica ed eliminare dati monitoraggio indesiderati. Quindi è possibile ripristinare le impostazioni di monitoraggio originali dopo aver completato la modifica.
Per ripristinare le impostazioni di monitoraggio in una farm dopo alcune modifiche amministrative
Per ripristinare un set di impostazioni di monitoraggio precedente
È necessario eseguire tale operazione se si apportano modifiche manuali alle impostazioni e si decide di ripristinare le impostazioni precedenti.
Per ripristinare le impostazioni predefinite
Per creare un profilo che è possibile applicare a più farm
Eseguire il backup delle impostazioni originali
È necessario eseguire sempre il backup delle impostazioni di monitoraggio predefinite prima di modificarle. In questo modo, sarà possibile ripristinare le impostazioni in caso fosse necessario. Il Profilo di backup può inoltre fungere da punto di inizio per altri Profili che si desidera creare. Per ulteriori informazioni su come eseguire il backup delle impostazioni, vedere Eseguire la configurazione del monitoraggio tramite script in SharePoint Server.
Informazioni sullo schema Profilo
Quando si esegue lo script PowerShell BackupMonitoringSettings.ps1, si crea un Profilo che rispetta il seguente XML Schema. Gli elementi del file contengono le impostazioni di monitoraggio associate dalla farm.
<?xml version="1.0" standalone="yes"?>
<Configuration>
<FarmDiagnosticConfig />
<UsageServices>
<UsageService />
</UsageServices>
<UsageDefinitions>
<UsageDefinition />
</UsageDefinitions>
<LogLevels>
<LogLevel />
</LogLevels>
<TimerJobs>
<TimerJob />
</TimerJobs>
<HealthAnalyzerRules>
<HealthAnalyzerRule />
</HealthAnalyzerRules>
</Configuration>
Importante
[!IMPORTANTE] Nelle tabelle seguenti, non è possibile modificare i valori nei campi contrassegnati come Di sola lettura. Se si modificano i valori nei campi di sola lettura nei Profili, potrebbero verificarsi risultati imprevisti.
Impostazioni per l'elemento FarmDiagnosticConfig
| Nome | Tipo valore | Note |
|---|---|---|
| AllowLegacyTraceProviders |
Booleano |
Specifica che i provider di traccia creati per le versioni precedenti di Prodotti e tecnologie SharePoint possono scrivere nella sessione di traccia per SharePoint Server |
| AppAnalyticsAutomaticUploadEnabled |
Booleano |
Specifica se i dati di utilizzo aggregati delle applicazioni vengono caricati automaticamente per Microsoft. |
| CustomerExperienceImprovementProgramEnabled |
Booleano |
Specifica se Gruppo di gestione ha abilitato la funzionalità Analisi utilizzo software. |
| ErrorReportingEnabled |
Booleano |
Ottiene o imposta un valore per indicare se la raccolta dei dati su un arresto anomalo e la segnalazione errori sono abilitate. |
| ErrorReportingAutomaticUploadEnabled |
Booleano |
Specifica se la partecipazione al programma Analisi utilizzo software è abilitata. Tale programma è progettato per migliorare la qualità, l'affidabilità e le prestazioni dei prodotti e delle tecnologie Microsoft. Con il consenso esplicito degli utenti, vengono inviate informazioni anonime sul server a Microsoft allo scopo di migliorare SharePoint Server. |
| DownloadErrorReportingUpdatesEnabled |
Booleano |
Specifica se le segnalazioni errori vengono inviate automaticamente a Microsoft. Le segnalazioni errori includono quanto segue: Informazioni sulla condizione del server quando si verifica un problema, la versione del sistema operativo e l'hardware del computer in uso, nonché l'ID digitale del prodotto, che potrà essere utilizzato per identificare la licenza. Nota: Poiché per l'invio delle segnalazioni errori ci si connette a un servizio online, viene inoltre inviato l'indirizzo IP del computer, ma questo viene utilizzato solo a fini statistici. |
| DaysToKeepLogs |
Intero |
Specifica il numero di giorni per la conservazione dei file di registro di traccia. Il tipo deve essere un numero valido compreso tra 1 e 366. Il valore predefinito è 14 giorni. |
| LogMaxDiskSpaceUsageEnabled |
Booleano |
Specifica se limitare lo spazio massimo da utilizzare per i file di registro di traccia. |
| LogDiskSpaceUsageGB |
Intero |
Specifica la quantità massima di spazio di archiviazione da utilizzare per i file di registro di traccia, in gigabyte (GB). Il valore predefinito è 1000 e diventa effettivo solo quando il parametro LogMaxDiskSpaceusageEnabled viene impostato su True. Il tipo deve essere un numero valido compreso tra 1 e 1000. |
| LogLocation |
String:Path |
Questo è il percorso completo in cui archiviare i file di log. Può essere un percorso remoto. Esempio: "%CommonProgramFiles%\Microsoft Shared\Web Server Extensions\16\LOGS" e "%CommonProgramFiles%\Microsoft Shared\Web Server Extensions\15\LOGS" |
| LogCutInterval |
Intero |
Specifica un periodo di tempo per il rollover al file di registro successivo. Il tipo deve essere un numero valido compreso tra 0 e 1440. |
| EventLogFloodProtectionEnabled |
Booleano |
Specifica se la caratteristica di protezione da attacchi flood al registro eventi è abilitata. Se nel registro eventi vengono scritti più eventi simili, alcuni messaggi duplicati vengono eliminati. Dopo un periodo di tempo, un messaggio di riepilogo mostra quanti eventi sono stati eliminati. |
| EventLogFloodProtectionThreshold |
Intero |
Specifica il numero di eventi consentiti in un determinato intervallo di tempo prima che un evento sia considerato un tentativo di attacco flood del registro eventi. L'intervallo consentito di numeri interi è compreso tra 1 e 100. Il valore predefinito è 5. |
| EventLogFloodProtectionTriggerPeriod |
Intero |
Specifica l'intervallo in minuti di osservazione di eventi che potrebbero causare attacchi flood. L'intervallo consentito di numeri interi è compreso tra 1 e 1440. Il valore predefinito è 2. |
| EventLogFloodProtectionQuietPeriod |
Intero |
Specifica l'intervallo di tempo in minuti che deve trascorrere senza un evento che attiva l'uscita dalla protezione da attacchi flood. L'intervallo consentito di numeri interi è compreso tra 1 e 1440. Il valore predefinito è 2. |
| EventLogFloodProtectionNotifyInterval |
Intero |
Specifica la frequenza in minuti per la scrittura di un evento di riepilogo che indica il numero di eventi soppressi per la protezione da attacchi flood. L'intervallo consentito di numeri interi è compreso tra 1 e 1440. Il valore predefinito è 5. |
| ScriptErrorReportingEnabled |
Booleano |
Abilita o disabilita la segnalazione degli errori di script nel file di log. |
| ScriptErrorReportingRequireAuth |
Booleano |
Specifica se è richiesta l'autenticazione per la segnalazione errori di script. |
| ScriptErrorReportingDelay |
Intero |
Specifica il tempo in minuti tra le segnalazioni errori di script. Il valore deve essere un numero intero compreso tra 0 e 1440. Il valore è specificato in minuti. Il valore predefinito è 30. |
Seguire la seguente tabella come riferimento per le impostazioni di UsageServices.
Elementi delle impostazioni UsageServices
| Nome | Tipo valore | Note |
|---|---|---|
| ID |
GUID: Sola lettura |
Un GUID, nel formato 12345678-90ab-cdef-1234-567890bcdefgh. |
| UsageLogLocation |
Percorso |
Specifica il percorso di ogni computer della farm in cui vengono creati i file di registro. In tutti i computer nella farm deve esistere lo stesso percorso. |
| LoggingEnabled |
Booleano |
Specifica che i dati di utilizzo vengono registrati nei relativi file. |
| UsageLogMaxFileSizeKB |
Intero |
Specifica la dimensione massima di un singolo file di dati di utilizzo da applicare a tutti i provider di dati di utilizzo. Il valore minimo è 512 kilobyte (KB) e il valore massimo è 65536 KB. |
| UsageLogCutTime |
Intero |
Specifica per quanti minuti vengono raccolti i dati di utilizzo per ogni file di log dei dati di utilizzo. L'intervallo predefinito è di 5 minuti. Il valore deve essere un numero intero compreso tra 1 e 1440. |
Utilizzare la seguente tabella come riferimento per le impostazioni di UsageDefinition.
Elementi delle impostazioni UsageDefinition
| Nome | Tipo valore | Note |
|---|---|---|
| ID |
GUID: Sola lettura |
Un GUID, nel formato 12345678-90ab-cdef-1234-567890bcdefgh. |
| Name |
Stringa: Sola lettura |
Il nome della stringa di UsageDefinition. |
| DaysRetained |
Intero |
Specifica per quanti giorni vengono conservati i dati di utilizzo per il relativo provider nel database del servizio di utilizzo. Il valore predefinito è 14. Il tipo deve essere un numero intero compreso tra 0 e 31. |
| DaysToKeepUsageFiles |
Intero |
Specifica il numero di giorni per la conservazione dei file dei dati di utilizzo. Tale valore deve essere inferiore o uguale al valore del parametro DaysRetained. |
| Abilitata |
Booleano |
Attiva o disattiva il provider di dati di utilizzo specificato. |
Seguire la seguente tabella come riferimento per le impostazioni di LogLevel.
Elementi delle impostazioni LogLevel
| Nome | Tipo valore | Note |
|---|---|---|
| Area |
Stringa: Sola lettura |
Il componente o il servizio a cui si applica LogLevel. |
| Identità |
Stringa: Sola lettura |
Specifica i nomi della categoria o del set di categorie per cui impostare la limitazione, ad esempio "Unified Logging Service". Nota: Se non si specifica il parametro Identity, l'impostazione di limitazione degli eventi verrà applicata a tutte le categorie nella farm. |
| EventSeverity |
String:[None | ErrorCritical |Error | Warning |Information | Verbose] |
Specifica il livello di registrazione da impostare. Il livello di categoria p uno dei seguenti valori:[None | ErrorCritical |Error | Warning |Information | Verbose] |
| TraceSeverity |
String:[None | Unexpected |Monitorable | High |Medium | Verbose | VerboseX] |
Specifica la limitazione di traccia da impostare per le categorie specificate. I file di registro di traccia sono file di testo scritti nel percorso del registro di traccia definito nella pagina Diagnostic Logging Settings in il sito Web Amministrazione centrale SharePoint. Il tipo deve essere uno dei valori seguenti:[None | Unexpected |Monitorable | High |Medium | Verbose | VerboseX] |
Seguire la seguente tabella come riferimento per le impostazioni di Processo timer.
Elementi delle impostazioni Processo timer
| Nome | Tipo valore | Note |
|---|---|---|
| Identità |
GUID: Sola lettura |
Specifica il processo timer da aggiornare. Il tipo deve essere un GUID valido nel formato 12345678-90ab-cdef-1234-567890bcdefgh. |
| Pianificazione |
String |
Specifica la pianificazione per l'esecuzione del processo timer. Il tipo deve essere una pianificazione valida del servizio Timer di SharePoint (SPTimer) in uno dei formati di pianificazione seguenti: Ogni 5 minuti tra 0 e 59, ogni ora compreso tra 0 e 59, ogni giorno alle 15:00:00, ogni settimana tra venerdì alle 22:00:00 e domenica alle 06:00:00, ogni mese il 15 alle 15:00:00 e ogni anno il 1° gennaio alle 15:00:00 |
| Abilitata |
Booleano |
Attiva o disattiva il processo timer. |
Utilizzare la seguente tabella come riferimento per le impostazioni di HealthAnalyzerRule.
Elementi delle impostazioni HealthAnalyzerRule
| Nome | Tipo valore | Note |
|---|---|---|
| Identità |
GUID: Sola lettura |
Specifica il nome o il GUID della regola dell'analizzatore dell'integrità da impostare. |
| Attivata |
Booleano |
Attiva o disattiva la regola analizzatore dell'integrità. |
Creare Profili
È possibile creare un numero illimitato di Profili. Ogni Profilo può essere utilizzato per diversi scopi, ad esempio per aumentare i livelli di monitoraggio prima di una modifica specifica all'ambiente o per abbassare il livello dopo una modifica.
È necessario solo creare voci del profilo per le modifiche specifiche da applicare. Le altre impostazioni rimarranno invariate. Ad esempio, se si desidera modificare alcune impostazioni LogLevel, è sufficiente specificare tali impostazioni nel Profilo. Le impostazioni che non sono specificate nel Profilo non vengono modificate.
È consigliabile utilizzare una convenzione di denominazione per i Profili affinché sia possibile organizzarli e utilizzarli più facilmente.
Importante
[!IMPORTANTE] È necessario eseguire sempre il backup delle impostazioni di monitoraggio predefinite prima di modificarle. Utilizzare sempre la copia di backup del Profilo e mai il file originale.
Vedere anche
Concetti
Panoramica sulla configurazione del monitoraggio tramite script in SharePoint Server
Eseguire la configurazione del monitoraggio tramite script in SharePoint Server