Start-SPDiagnosticsSession

  • Referência
Módulo:
SharePointServer
Aplica-se a:
SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Inicia uma sessão de diagnóstico para relatar informações de diagnóstico para o banco de dados de uso.

Syntax

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

Description

Use o Start-SPDiagnosticsSession cmdlet para relatar informações de diagnóstico ao banco de dados de uso. Depois que uma sessão de diagnóstico for iniciada, todos os Windows PowerShell para cmdlets do SharePoint em scripts de Windows PowerShell usarão a mesma correlação para relatar informações de diagnóstico.

Para obter as permissões e informações mais recentes sobre o Windows PowerShell para Produtos SharePoint, confira a documentação online em Cmdlets do SharePoint Server.

Exemplos

-------------EXEMPLO-------

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

Este exemplo inicia uma sessão de diagnósticos para uma ID de correlação especificada com o nível de rastreamento de verbose.

Parâmetros

-AssignmentCollection

Gerencia objetos para o devido descarte. O uso de objetos como SPWeb ou SPSite pode consumir grandes quantidades de memória e o uso desses objetos em scripts do Windows PowerShell requer gerenciamento de memória adequado. Usando o objeto SPAssignment, você poderá atribuir objetos a uma variável e descartar os objetos após o uso para liberar memória. Quando objetos SPWeb, SPSite ou SPSiteAdministration são usados, os objetos são automaticamente descartados se um conjunto de atribuições ou o parâmetro Global não forem usados.

Quando o parâmetro Global é usado, todos os objetos estão contidos no repositório global. Quando os objetos não são usados imediatamente ou são descartados com o uso do comando Stop-SPAssignment, pode ocorrer um cenário de memória insuficiente.

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

Especifica a ID de correlação a ser usada para a sessão de diagnósticos.

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

Especifica que o diagnóstico se comporta como se o painel de desenvolvedores estivesse habilitado.

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

Especifica a substituição do nível de traço Unified Logging Service (ULS).

--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