Get-Service
Obtient les services sur un ordinateur local ou distant.
Syntaxe
Default (Par défaut)
Get-Service
[[-Name] <String[]>]
[-ComputerName <String[]>]
[-DependentServices]
[-RequiredServices]
[-Include <String[]>]
[-Exclude <String[]>]
[<CommonParameters>]
DisplayName
Get-Service
-DisplayName <String[]>
[-ComputerName <String[]>]
[-DependentServices]
[-RequiredServices]
[-Include <String[]>]
[-Exclude <String[]>]
[<CommonParameters>]
InputObject
Get-Service
[-ComputerName <String[]>]
[-DependentServices]
[-RequiredServices]
[-Include <String[]>]
[-Exclude <String[]>]
[-InputObject <ServiceController[]>]
[<CommonParameters>]
Description
L’applet de commande Get-Service obtient des objets qui représentent les services sur un ordinateur local ou sur un ordinateur distant, y compris l’exécution et l’arrêt des services. Par défaut, lorsque Get-Service est exécuté sans paramètres, tous les services de l’ordinateur local sont retournés.
Vous pouvez diriger cette applet de commande pour obtenir uniquement des services particuliers en spécifiant le nom du service ou le nom complet des services, ou vous pouvez diriger les objets de service vers cette applet de commande.
Exemples
Exemple 1 : Obtenir tous les services sur l’ordinateur
Cet exemple permet d'obtenir tous les services de l'ordinateur. Il se comporte comme si vous avez tapé Get-Service *. L’affichage par défaut affiche l’état, le nom du service et le nom d’affichage de chaque service.
Get-Service
Exemple 2 : Obtenir des services qui commencent par une chaîne de recherche
Cet exemple récupère des services avec des noms de service commençant par WMI (Windows Management Instrumentation).
Get-Service "wmi*"
Exemple 3 : Afficher les services qui incluent une chaîne de recherche
Cet exemple montre comment afficher les services avec un nom d’affichage qui inclut le mot network. La recherche par le nom d'affichage trouve des services liés au réseau même si le nom du service n’inclut pas Net, tels que xmlprov, le service de provisionnement réseau.
Get-Service -DisplayName "*network*"
Exemple 4 : Obtenir des services qui commencent par une chaîne de recherche et une exclusion
Cet exemple obtient uniquement les services dont les noms de service commencent par win, à l’exception du service WinRM.
Get-Service -Name "win*" -Exclude "WinRM"
Exemple 5 : Afficher les services actuellement actifs
Cet exemple montre comment afficher uniquement les services dont l’état est Running.
Get-Service | Where-Object {$_.Status -eq "Running"}
Get-Service obtient tous les services de l'ordinateur et envoie les objets vers le pipeline. L’applet de commande Where-Object sélectionne uniquement les services avec une propriété Status qui est égale à Running.
Status n’est qu’une des propriétés des objets Service. Pour afficher toutes les propriétés, tapez Get-Service | Get-Member.
Exemple 6 : Obtenir les services sur un ordinateur distant
Get-Service -ComputerName "Server02"
Cette commande obtient les services sur l’ordinateur distant Server02.
Étant donné que le paramètre ComputerName de Get-Service n’utilise pas la communication à distance Windows PowerShell, vous pouvez utiliser ce paramètre même si l’ordinateur n’est pas configuré pour la communication à distance dans Windows PowerShell.
Exemple 7 : Répertorier les services sur l’ordinateur local qui ont des services dépendants
Cet exemple récupère les services qui ont des services dépendants.
Get-Service |
Where-Object {$_.DependentServices} |
Format-List -Property Name, DependentServices, @{
Label="NoOfDependentServices"; Expression={$_.DependentServices.Count}
}
Name : AudioEndpointBuilder
DependentServices : {AudioSrv}
NoOfDependentServices : 1
Name : Dhcp
DependentServices : {WinHttpAutoProxySvc}
NoOfDependentServices : 1
...
L’applet de commande Get-Service obtient tous les services sur l’ordinateur et envoie les objets vers le bas du pipeline. L’applet de commande Where-Object sélectionne les services dont la propriété DependentServices n’est pas nul.
Les résultats sont envoyés le long du pipeline à la cmdlet Format-List. Le paramètre Property affiche le nom du service, le nom des services dépendants et une propriété calculée qui affiche le nombre de services dépendants pour chaque service.
Exemple 8 : Trier les services par valeur de propriété
Cet exemple montre que lorsque vous triez les services dans l'ordre croissant par la valeur de leur propriété Status, les services arrêtés s’affichent avant les services en cours d'exécution. Cela se produit parce que la valeur de Status est une énumération, dans laquelle Stopped a une valeur de 1et Running a une valeur de 4. Pour plus d’informations, consultez ServiceControllerStatus.
Pour répertorier d’abord les services en cours d’exécution, utilisez le paramètre décroissant de l’applet de commande Sort-Object.
Get-Service "s*" | Sort-Object Status
Status Name DisplayName
------ ---- -----------
Stopped stisvc Windows Image Acquisition (WIA)
Stopped SwPrv MS Software Shadow Copy Provider
Stopped SysmonLog Performance Logs and Alerts
Running Spooler Print Spooler
Running srservice System Restore Service
Running SSDPSRV SSDP Discovery Service
Running ShellHWDetection Shell Hardware Detection
Running Schedule Task Scheduler
Running SCardSvr Smart Card
Running SamSs Security Accounts Manager
Running SharedAccess Windows Firewall/Internet Connectio...
Running SENS System Event Notification
Running seclogon Secondary Logon
Exemple 9 : Obtenir des services sur plusieurs ordinateurs
Get-Service -Name "WinRM" -ComputerName "localhost", "Server01", "Server02" |
Format-Table -Property MachineName, Status, Name, DisplayName -Auto
MachineName Status Name DisplayName
------------ ------ ---- -----------
localhost Running WinRM Windows Remote Management (WS-Management)
Server01 Running WinRM Windows Remote Management (WS-Management)
Server02 Running WinRM Windows Remote Management (WS-Management)
Cette commande utilise l’applet de commande Get-Service pour exécuter une commande Get-Service Winrm sur deux ordinateurs distants et l’ordinateur local (localhost).
La commande s’exécute sur les ordinateurs distants et les résultats sont retournés à l’ordinateur local. Un opérateur de pipeline (|) envoie les résultats à l’applet de commande Format-Table, qui met les services en forme de table. La commande Format-Table utilise le paramètre Property pour spécifier les propriétés affichées dans la table, y compris la propriété MachineName.
Exemple 10 : Obtenir les services dépendants d’un service
Cet exemple obtient les services requis par le service WinRM. La valeur de la propriété ServicesDependedOn du service est renvoyée.
Get-Service "WinRM" -RequiredServices
Exemple 11 : Obtenir un service via l’opérateur de pipeline
Cet exemple obtient le service WinRM sur l’ordinateur local. La chaîne du nom du service, entre guillemets, est envoyée à la cmdlet Get-Service le long du pipeline.
"WinRM" | Get-Service
Paramètres
-ComputerName
Obtient les services en cours d’exécution sur les ordinateurs spécifiés. La valeur par défaut est l’ordinateur local.
Tapez le nom NetBIOS, une adresse IP ou un nom de domaine complet (FQDN) d’un ordinateur distant.
Pour spécifier l’ordinateur local, tapez le nom de l’ordinateur, un point (.) ou localhost.
Ce paramètre ne s’appuie pas sur la communication à distance Windows PowerShell. Vous pouvez utiliser le paramètre ComputerName de Get-Service même si votre ordinateur n’est pas configuré pour exécuter des commandes distantes.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Cn |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-DependentServices
Indique que cette applet de commande obtient uniquement les services qui dépendent du service spécifié.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | DS |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-DisplayName
Spécifie, sous la forme d'un tableau de chaînes, les noms d'affichage des services à récupérer. Les caractères génériques sont autorisés.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | True |
| DontShow: | False |
Jeux de paramètres
DisplayName
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Exclude
Spécifie, en tant que tableau de chaînes, un service ou des services que cette applet de commande exclut de l’opération.
La valeur de ce paramètre qualifie le paramètre Name. Entrez un élément de nom ou un modèle, tel que s*. Les caractères génériques sont autorisés.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | True |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Include
Spécifie, comme tableau de chaînes, un service ou des services inclus dans l'opération par ce cmdlet. La valeur de ce paramètre qualifie le paramètre Name. Entrez un élément de nom ou un modèle, tel que s*. Les caractères génériques sont autorisés.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | True |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-InputObject
Spécifie les objets ServiceController représentant les services à récupérer. Entrez une variable qui contient les objets, ou tapez une commande ou une expression qui obtient les objets. Vous pouvez diriger un objet de service vers cette applet de commande.
Propriétés du paramètre
| Type: | |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
InputObject
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Name
Spécifie les noms de service des services à récupérer. Les caractères génériques sont autorisés.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | True |
| DontShow: | False |
| Alias: | Nom du Service |
Jeux de paramètres
Default
| Position: | 0 |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-RequiredServices
Indique que cette applet de commande obtient uniquement les services requis par ce service. Ce paramètre obtient la valeur de la propriété ServicesDependedOn du service.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | True |
| DontShow: | False |
| Alias: | SDO, ServicesDependedOn |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
Entrées
ServiceController
Vous pouvez diriger un objet de service vers cette applet de commande.
String
Vous pouvez diriger un nom de service vers cette applet de commande.
Sorties
ServiceController
Cette applet de commande retourne des objets qui représentent les services sur l’ordinateur.
Notes
Windows PowerShell inclut les alias suivants pour Get-Service:
gsv
Cette applet de commande ne peut afficher les services que lorsque l’utilisateur actuel a l'autorisation de les voir. Si cette applet de commande n’affiche pas les services, il se peut que vous n’ayez pas l’autorisation de les voir.
Pour rechercher le nom du service et le nom complet de chaque service sur votre système, tapez Get-Service. Les noms de service apparaissent dans la colonne Nom et les noms d’affichage apparaissent dans la colonne DisplayName.
Remarque
En règle générale, Get-Service retourne des informations sur les services et non sur le pilote. Toutefois, si vous spécifiez le nom d’un pilote, Get-Service retourne des informations sur le pilote.
- L’énumération n’inclut pas les services de pilote de périphérique
- Lorsqu’un caractère générique est spécifié, l’applet de commande retourne uniquement les services Windows
- Si vous spécifiez le nom ou DisplayName correspondant exactement à un nom de service d’appareil, l’instance de l’appareil est retournée
Lorsque vous triez dans l’ordre croissant par valeur d’état, Stopped services apparaissent avant Running services. L'Status propriété d’un service est une valeur énumérée dans laquelle les noms des états représentent des valeurs entières. Le tri est basé sur la valeur entière, et non sur le nom.
Running apparaît avant Stopped, car Stopped a une valeur de 1et Running a une valeur de 4. Pour plus d’informations, consultez ServiceControllerStatus.
