Public/Stop-DataConduITService.ps1
|
<#
.SYNOPSIS Stops the DataConduIT service. .DESCRIPTION Stops the DataConduIT service. If the result returns null, try the parameter "-Verbose" to get more details. .EXAMPLE Stop-DataConduITService .LINK https://github.com/erwindevreugd/PSDataConduIT .EXTERNALHELP PSDataConduIT-help.xml #> function Stop-DataConduITService { [CmdletBinding()] param ( [Parameter( Position = 0, Mandatory = $false, ValueFromPipelineByPropertyName = $true, HelpMessage = 'The name of the server where the DataConduIT service is running or localhost.')] [string] $Server = $Script:Server, [Parameter( Mandatory = $false, ValueFromPipelineByPropertyName = $true, HelpMessage = 'The credentials used to authenticate the user to the DataConduIT service.')] [PSCredential] $Credential = $Script:Credential, [Parameter( Mandatory = $false, ValueFromPipelineByPropertyName = $false, HelpMessage = 'Returns an object that represents the service. By default, this cmdlet does not generate any output.')] [switch] $PassThru ) process { if (($service = Get-DataConduITService -Server $Server -Credential $Credential) -eq $null) { Write-Error -Message ("DataConduIT service not found on server '$($Server)'") return } [void]$service.StopService.Invoke(); Write-Verbose -Message ("DataConduIT Service stopped on '$($Server)'") if ($PassThru) { Get-DataConduITService -Server $Server -Credential $Credential } } } |