Skip to main content
Version: 4.0

Stop-ADTServiceAndDependencies

SYNOPSIS​

Stop a Windows service and its dependencies.

SYNTAX​

Stop-ADTServiceAndDependencies [-Name] <String> [-SkipDependentServices] [[-PendingStatusWait] <TimeSpan>]
 [-PassThru] [<CommonParameters>]

DESCRIPTION​

This function stops a specified Windows service and its dependencies. It provides options to skip stopping dependent services, wait for a service to get out of a pending state, and return the service object.

EXAMPLES​

EXAMPLE 1​

Stop-ADTServiceAndDependencies -Name 'wuauserv'

Stops the Windows Update service and its dependencies.

PARAMETERS​

-Name​

Specify the name of the service.

Type: String
Parameter Sets: (All)
Aliases: Service

Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SkipDependentServices​

Choose to skip checking for and stopping dependent services.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-PendingStatusWait​

The amount of time to wait for a service to get out of a pending state before continuing. Default is 60 seconds.

Type: TimeSpan
Parameter Sets: (All)
Aliases:

Required: False
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-PassThru​

Return the System.ServiceProcess.ServiceController service object.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters​

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS​

None​

You cannot pipe objects to this function.​

OUTPUTS​

System.ServiceProcess.ServiceController​

Returns the service object.​

NOTES​

An active ADT session is NOT required to use this function.

Tags: psadt
Website: https://psappdeploytoolkit.com
Copyright: (C) 2025 PSAppDeployToolkit Team (Sean Lillis, Dan Cunningham, Muhammad Mashwani, Mitch Richters, Dan Gough).
License: https://opensource.org/license/lgpl-3-0

https://psappdeploytoolkit.com/docs/reference/functions/Stop-ADTServiceAndDependencies