functions/Get-DbaXEventsSession.ps1

function Get-DbaXEventsSession
{
 <#
.SYNOPSIS
Get a list of Extended Events Sessions
 
.DESCRIPTION
Retrieves a list of Extended Events Sessions
 
.PARAMETER SqlInstance
The SQL Instances that you're connecting to.
 
.PARAMETER SqlCredential
Credential object used to connect to the SQL Server as a different user
 
.PARAMETER Sessions
Only return specific sessions. This parameter is auto-populated.
 
.NOTES
Tags: Memory
Author: Klaas Vandenberghe ( @PowerDBAKlaas )
     
dbatools PowerShell module (https://dbatools.io)
Copyright (C) 2016 Chrissy LeMaire
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/>.
 
     
.LINK
https://dbatools.io/Get-DbaXEventsSession
 
.EXAMPLE
Get-DbaXEventsSession -SqlServer ServerA\sql987
 
Returns a custom object with ComputerName, SQLInstance, Session, StartTime, Status and other properties.
 
.EXAMPLE
Get-DbaXEventsSession -SqlServer ServerA\sql987 | Format-Table ComputerName, SQLInstance, Session, Status -AutoSize
 
Returns a formatted table displaying ComputerName, SQLInstance, Session, and Status.
 
.EXAMPLE
'ServerA\sql987','ServerB' | Get-DbaXEventsSession
 
Returns a custom object with ComputerName, SQLInstance, Session, StartTime, Status and other properties, from multiple SQL Instances.
#>

    [CmdletBinding()]
    param (
        [parameter(Mandatory = $true, ValueFromPipeline = $true)]
        [Alias("ServerInstance", "SqlServer")]
        [string[]]$SqlInstance,
        [PsCredential]$SqlCredential
    )
    
    DynamicParam { if ($SqlInstance) { return (Get-ParamSqlExtendedEvents -SqlServer $SqlInstance[0] -SqlCredential $SqlCredential) } }
    
    BEGIN
    {
        if ([System.Reflection.Assembly]::LoadWithPartialName("Microsoft.SqlServer.Management.XEvent") -eq $null)
        {
            throw "SMO version is too old. To collect Extended Events, you must have SQL Server Management Studio 2012 or higher installed."
        }
        $sessions = $psboundparameters.Sessions
    }
    PROCESS
    {
        foreach ($instance in $SqlInstance)
        {
            Write-Verbose "Connecting to $instance."
            try
            {
                $server = Connect-SqlServer -SqlServer $instance -SqlCredential $Credential -ErrorAction SilentlyContinue
                Write-Verbose "SQL Instance $instance is version $($server.versionmajor)."
            }
            catch
            {
                Write-Warning " Failed to connect to $instance."
                continue
            }
            if ($server.versionmajor -lt 11)
            {
                Write-Warning "$instance is lower than SQL Server 2012 and does not support extended events."
                continue
            }
            else
            {
                $SqlConn = $server.ConnectionContext.SqlConnectionObject
                $SqlStoreConnection = New-Object Microsoft.SqlServer.Management.Sdk.Sfc.SqlStoreConnection $SqlConn
                $XEStore = New-Object  Microsoft.SqlServer.Management.XEvent.XEStore $SqlStoreConnection
                Write-Verbose "Getting XEvents Sessions on $instance."
                
                $xesessions = $XEStore.sessions
                
                if ($sessions)
                {
                    $xesessions = $xesessions | Where-Object { $_.Name -in $sessions }
                }
                
                try
                {
                    $xesessions |
                    ForEach-Object {
                        [PSCustomObject]@{
                            ComputerName = $server.NetName
                            SQLInstance = $server.ServiceName
                            Session = $_.Name
                            Status = switch ($_.IsRunning) { $true { "Running" } $false { "Stopped" } }
                            StartTime = $_.StartTime
                            AutoStart = $_.AutoStart
                            State = $_.State
                            Targets = $_.Targets
                            Events = $_.Events
                            MaxMemory = $_.MaxMemory
                            MaxEventSize = $_.MaxEventSize
                        }
                    }
                }
                catch
                {
                    Write-Warning "Failed to get XEvents Sessions on $instance."
                }
            }
        }
    }
    END { }
}