Functions/Stop-ExPerfwiz.ps1
|
Function Stop-ExPerfwiz { <# .SYNOPSIS Stop a data collector set. .DESCRIPTION Stops a data collector set on the local or remote server. .PARAMETER Name Name of the data collector set to stop. Default Exchange_Perfwiz .PARAMETER Server Name of the server to stop the collector set on. Default LocalHost .OUTPUTS Logs all activity into $env:LOCALAPPDATA\ExPefwiz.log file .EXAMPLE Stop the default data collector set on the local server Stop-ExPerfwiz .EXAMPLE Stop a data colletor set on a remote server Stop-ExPerfwiz -Name "My Collector Set" -Server RemoteServer-01 #> [CmdletBinding(SupportsShouldProcess = $true, ConfirmImpact = 'Medium')] param ( [Parameter(ValueFromPipelineByPropertyName)] [string] $Name = "Exchange_Perfwiz", [string] $Server = $env:ComputerName ) Process { Write-Logfile -string ("Stopping ExPerfwiz: " + $server + "\" + $Name) # Remove the experfwiz counter set if ($PSCmdlet.ShouldProcess("$Server\$Name", "Stopping ExPerfwiz Data Collection")) { [string]$logman = logman stop -name $Name -s $server } # Check if we have an error and throw and error if needed. If ($logman | select-string "Error:") { # if we are not running already then just move on if ($logman | select-string "is not running") { Write-LogFile "Collector Not Running" } else { Write-Logfile "[ERROR] - Unable to Stop Collector" Write-Logfile $logman Throw $logman } } else { Write-Logfile "ExPerfwiz Stopped" } } } |