PS C:\Users\Admin> help gsv -full
NAME
Get-Service
SYNOPSIS
Gets the services on the local computer.
SYNTAX
Get-Service [[-name] <string[]>] [-include <string[]>] [-exclude <string[]>] [<CommonParameters>]
Get-Service -displayName <string[]> [-include <string[]>] [-exclude <string[]>] [<CommonParameters>]
Get-Service [-inputObject <ServiceController[]>] [-include <string[]>] [-exclude <string[]>] [<CommonParameters>]
DETAILED DESCRIPTION
The Get-Service cmdlet gets objects representing the services on the local computer, including running and stopped services. You can direct Get-Service to get only particular services by specifying the service name or display name of the services, or you can use the InputObject parameter to supply a service object representing each of the services that you want to retrieve.
PARAMETERS
-name <string[]>
Specifies the service names of services to be retrieved. Wildcards are permitted. By default, Get-Service gets all of the services on the computer.
Required? false
Position? 1
Default value *
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? true
-inclnde <string[]>
Retrieves only the specified services. The value of this parameter qualifies the Name parameter. Enter a name element or pattern, such as "s*". Wildcards are permitted.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? true
-exclude <string[]>
Omits the specified services. The value of this parameter qualifies the Name parameter. Enter a name element or pattern, such as "s*". Wildcards are permitted.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? true
-displayName <string[]>
Specifies the display names of services to be retrieved. Wildcards are permitted. By default, Get-Service gets all services on the computer.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? true
-inputObject <ServiceController[]>
Specifies the ServiceController objects to be retrieved. Enter a variable that contains the objects or type a command or expression that gets the objects.
Required? false
Position? named
Default value
Accept pipeline input? true (ByValue)
Accept wildcard characters? true
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, and -OutVariable. For more information, type, "get-help about_commonparameters".
INPUT TYPE
Object
RETURN TYPE
System.ServiceProcess.ServiceController
NOTES
For more information, type "Get-Help Get-Service -detailed". For technical information, type "Get-Help Get-Service -full".
Get-Service can display services only when the current user has permission to see them. If Get-Service does not display services, you might not have permission to see them.
To find the service name and display name of each service on your system, type "get-service". The service names appear in the "Name" column and the display names appear in the "DisplayName" column.
When specifying multiple values for a parameter, use commas to separate the values. For example, "<parameter-name> <value1>, <value2>".
You can also refer to Get-Service by its built-in alias, "gsv". For more information, see About_Alias.
----------------- EXAMPLE 1 -----------------
C:\PS>get-service
This command retrieves all of the services on the system. It behaves as though you typed "get-service *". The default display shows the status, service name, and display name of each service.
----------------- EXAMPLE 2 -----------------
C:\PS>get-service wmi*
This command retrieves services with service names that begin with "WMI".
----------------- EXAMPLE 3 -----------------
C:\PS>get-service -displayname *network*
This command displays services with a display name that includes the word "network." This command lets you find network-related services even when the service name does not include "Net," such as xmlprov, the Network Provisioning Service.
----------------- EXAMPLE 4 -----------------
C:\PS>$services = get-service
C:\PS>get-service -inputobject $Services -include RPC*
These commands display only the services with service names that begin with "RPC". The first command gets the services on the system and stores them in the $services variable. The second command gets the services in the $services variable, but includes only those that begin with "RPC". It uses the InputObject parameter to pass the objects stored in the variable to Get-Service.
----------------- EXAMPLE 5 -----------------
C:\PS>get-service | where-object {$_.Status -eq "Running"}
This command displays only the services that are currently running. It uses the Get-Service cmdlet to get all of the services on the computer. The pipeline operaton (|) passes the results to the Where-Object cmdlet, which selects only the services with a Status property that equals "Running."
Status is only one property of service objects. To see all of the properties, type "get-service | get-member".
RELATED LINKS
Resume-Service
Start-Service
Stop-Service
Restart-Service
Suspend-Service
Set-Service
New-Service
Get-Service [gsv]
