Set-ServiceConfig

Windows: Configures system service properties and state

Script

#Requires -Version 5.1

[CmdletBinding()]
Param
(
    [Parameter(Mandatory = $true, ValueFromPipeline = $true)]
    [string]$Name,

    [string]$ComputerName = $env:COMPUTERNAME,

    [string]$DisplayName,

    [string]$Description,

    [ValidateSet('Automatic', 'Manual', 'Disabled')]
    [string]$StartupType,

    [ValidateSet('Running', 'Stopped', 'Paused')]
    [string]$Status
)

Process {
    try {
        $setParams = @{
            'Name'         = $Name
            'ComputerName' = $ComputerName
            'Confirm'      = $false
            'ErrorAction'  = 'Stop'
        }

        if ($PSBoundParameters.ContainsKey('DisplayName')) {
            $setParams.Add('DisplayName', $DisplayName)
        }

        if ($PSBoundParameters.ContainsKey('Description')) {
            $setParams.Add('Description', $Description)
        }

        if ($PSBoundParameters.ContainsKey('StartupType')) {
            $setParams.Add('StartupType', $StartupType)
        }

        if ($PSBoundParameters.ContainsKey('Status')) {
            $setParams.Add('Status', $Status)
        }

        if ($setParams.Count -gt 3) {
            Set-Service @setParams
        }

        $updatedService = Get-Service -Name $Name -ComputerName $ComputerName -ErrorAction Stop
        
        $result = [PSCustomObject]@{
            Name        = $updatedService.Name
            DisplayName = $updatedService.DisplayName
            Status      = $updatedService.Status
            StartupType = $updatedService.StartType
            Computer    = $ComputerName
        }

        Write-Output $result
    }
    catch {
        throw
    }
}

Customize

Name string

Specifies the name of the service to configure.

ComputerName string

Specifies the name of the target computer. Defaults to the local computer.

env string

DisplayName string

Specifies a new display name for the service.

Description string

Specifies a new description for the service.

StartupType string

Specifies the startup type for the service (Automatic, Manual, or Disabled).

Status string

Specifies the desired operational status (Running, Stopped, or Paused).