Set-SPDeveloperDashboard

Sets the Developer Dashboard Settings.

Set-SPDeveloperDashboard [-AutoLaunchEnabled [<Boolean>]] [-DisplayLevel [<SPDeveloperDashboardLevel>]] [-MaximumCriticalEventsToTrack [<Int32>]] [-MaximumSQLQueriesToTrack [<Int32>]] [-RequiredPermissions [<SPBasePermissions>]] [-TraceEnabled [<Boolean>]] [-AdditionalEventsToTrack [<String[]>]] [-AssignmentCollection [<SPAssignmentCollection>]]

Parameters

1

ParameterRequiredTypeDescription
AutoLaunchEnabledFalseBoolean

Indicates whether the developer dashboard can be auto launched.

DisplayLevelFalseSPDeveloperDashboardLevel

Indicates whether the developer dashboard is set to Off, On, or On Demand.

MaximumCriticalEventsToTrackFalseInt32

The maximum number of critical events and asserts that will be recorded in a single transaction (i.e. one request or timer job). If a single transaction has more than this number of asserts the remainder will be ignored. This can be set to 0 to disable assert tracking.

MaximumSQLQueriesToTrackFalseInt32

The maximum number of SQL queries that will be recorded in a single transaction (i.e. one request or timer job). If a single transaction executes more than this number of requests the query will be counted but the query call stack and text will not be kept.

RequiredPermissionsFalseSPBasePermissions

A permission mask defining the permissions required to see the developer dashboard. This defaults to SPBasePermissions.AddAndCustomizePages.

TraceEnabledFalseBoolean

Whether a link to display full verbose trace will be available at the bottom of the page when the developer dashboard is launched or not.

AdditionalEventsToTrackFalseString[]

A list of URL tags to track in addition to events with severity above High.

AssignmentCollectionFalseSPAssignmentCollection

Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.

When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

Detailed Description

Sets the Developer Dashboard Settings.

Copyright 2016 Falchion Consulting, LLC

> For more information on this cmdlet and others:

> http://blog.falchionconsulting.com/

> Use of this cmdlet is at your own risk.

> Gary Lapointe assumes no liability.

Examples

------------------EXAMPLE 1-----------------------

PS C:\> Set-SPDeveloperDashboard -DisplayLevel OnDemand -TraceEnabled $true

This example enables the developer dashboard.

------------------EXAMPLE 2-----------------------

PS C:\> Set-SPDeveloperDashboard -RequiredPermissions "ManageWeb,ManageSubwebs"

This example sets the required permissions to view the developer dashboard.