-
Notifications
You must be signed in to change notification settings - Fork 206
/
Copy pathSet-SysMService.ps1
86 lines (71 loc) · 3.02 KB
/
Set-SysMService.ps1
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
#Requires -Version 5.0
<#
.SYNOPSIS
Starts, stops, and suspends a service, and changes its properties
.DESCRIPTION
.NOTES
This PowerShell script was developed and optimized for ScriptRunner. The use of the scripts requires ScriptRunner.
The customer or user is authorized to copy the script from the repository and use them in ScriptRunner.
The terms of use for ScriptRunner do not apply to this script. In particular, ScriptRunner Software GmbH assumes no liability for the function,
the use and the consequences of the use of this freely available script.
PowerShell is a product of Microsoft Corporation. ScriptRunner is a product of ScriptRunner Software GmbH.
© ScriptRunner Software GmbH
.COMPONENT
.LINK
https://github.com/scriptrunner/ActionPacks/tree/master/WinSystemManagement/Services
.Parameter ComputerName
[sr-en] Gets the service running on the specified computer. The default is the local computer
.Parameter ServiceName
[sr-en] Service name of the service to be changed
.Parameter DisplayName
[sr-en] New display name for the service
.Parameter Description
[sr-en] New description for the service
.Parameter StartupType
[sr-en] Changes the start mode of the service
.Parameter Status
[sr-en] Starts, stops, or suspends (pauses) the service
#>
[CmdLetBinding()]
Param(
[Parameter(Mandatory = $true)]
[string]$ServiceName,
[string]$ComputerName,
[string]$DisplayName ,
[string]$Description,
[ValidateSet("Automatic","Manual","Disabled")]
[string]$StartupType,
[ValidateSet("Running","Stopped","Paused")]
[string]$Status
)
try{
[string[]]$Properties = @('Name','DisplayName','Status','RequiredServices','DependentServices','CanStop','CanShutdown','CanPauseAndContinue')
if([System.String]::IsNullOrWhiteSpace($ComputerName) -eq $true){
$ComputerName = "."
}
$Script:srv = Get-Service -ComputerName $ComputerName -Name $ServiceName -ErrorAction Stop
if($PSBoundParameters.ContainsKey("DisplayName") -eq $true){
$null = Set-Service -ComputerName $ComputerName -Name $Script:srv.Name -DisplayName $DisplayName -Confirm:$false -ErrorAction Stop
}
if($PSBoundParameters.ContainsKey("Description") -eq $true){
$null = Set-Service -ComputerName $ComputerName -Name $Script:srv.Name -Description $Description -Confirm:$false -ErrorAction Stop
}
if($PSBoundParameters.ContainsKey("StartupType") -eq $true){
$null = Set-Service -ComputerName $ComputerName -Name $Script:srv.Name -StartupType $StartupType -Confirm:$false -ErrorAction Stop
}
if($PSBoundParameters.ContainsKey("Status") -eq $true){
$null = Set-Service -ComputerName $ComputerName -Name $Script:srv.Name -Status $Status -Confirm:$false -ErrorAction Stop
}
$result = Get-Service -ComputerName $ComputerName -Name $Script:srv.Name -ErrorAction Stop | Select-Object $Properties
if($SRXEnv) {
$SRXEnv.ResultMessage = $result
}
else{
Write-Output $result
}
}
catch{
throw
}
finally{
}