Start-SPDiagnosticsSession

  • Riferimento
Modulo:
SharePointServer
Si applica a:
SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Avvia una sessione diagnostica allo scopo di segnalare le informazioni di diagnostica al database del servizio di utilizzo.

Sintassi

Start-SPDiagnosticsSession
     [-AssignmentCollection <SPAssignmentCollection>]
     [-CorrelationId <Guid>]
     [-Dashboard]
     [-TraceLevel <String>]
     [<CommonParameters>]

Descrizione

Usare il Start-SPDiagnosticsSession cmdlet per segnalare le informazioni di diagnostica al database di utilizzo. Dopo l'avvio di una sessione di diagnostica, tutti i Windows PowerShell per i cmdlet di SharePoint negli script Windows PowerShell useranno la stessa correlazione per segnalare le informazioni di diagnostica.

Per le autorizzazioni e le informazioni più recenti su Windows PowerShell per i prodotti SharePoint, vedere la documentazione online nella pagina Cmdlet server SharePoint.

Esempio

-------------ESEMPIO-------

$correlationId = [guid]::NewGuid()
Start-SPDiagnosticsSession -CorrelationId $correlationId -Dashboard:$true -TraceLevel Verbose

In questo esempio viene avviata una sessione diagnostica per un ID correlazione specificato con il livello di traccia dettagliato (Verbose).

Parametri

-AssignmentCollection

Consente di gestire gli oggetti ai fini della corretta eliminazione dalla memoria. Oggetti quali SPWeb o SPSite richiedono quantità di memoria elevate e per utilizzarli negli script Windows PowerShell è necessario gestire la memoria in modo appropriato. Tramite l'oggetto SPAssignment è possibile assegnare oggetti a una variabile ed eliminarli quando è necessario liberare memoria. Gli oggetti SPWeb, SPSite e SPSiteAdministration utilizzati vengono automaticamente eliminati dalla memoria se non viene utilizzato un insieme di assegnazioni o il parametro Global.

Quando viene utilizzato il parametro Global, tutti gli oggetti vengono memorizzati nell'area di archiviazione globale. Se gli oggetti non vengono utilizzati immediatamente o eliminati dalla memoria tramite il comando Stop-SPAssignment, può verificarsi una condizione di memoria insufficiente.

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-CorrelationId

Specifica l'ID correlazione da utilizzare per la sessione diagnostica.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Dashboard

Specifica che la diagnostica venga eseguita come se il dashboard di sviluppo fosse abilitato.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-TraceLevel

Specifica la sostituzione del livello di traccia URL (Unified Logging Service):

--High --Medium --Monitorable --Unexpected --Verbose --VerboseEx --None

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019