Partager via


Get-Service

Obtient les services sur l’ordinateur.

Syntaxe

Get-Service
   [[-Name] <String[]>]
   [-DependentServices]
   [-RequiredServices]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [<CommonParameters>]
Get-Service
   [-DependentServices]
   [-RequiredServices]
   -DisplayName <String[]>
   [-Include <String[]>]
   [-Exclude <String[]>]
   [<CommonParameters>]
Get-Service
   [-DependentServices]
   [-RequiredServices]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-InputObject <ServiceController[]>]
   [<CommonParameters>]

Description

Cette applet de commande est disponible uniquement sur la plateforme Windows.

L’applet Get-Service de commande obtient des objets qui représentent les services sur un ordinateur, y compris l’exécution et l’arrêt des services. Par défaut, lorsqu’il 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 obtient tous les services sur l’ordinateur. Il se comporte comme si vous avez tapé Get-Service *. L’affichage par défaut répertorie l’état, le nom 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 qui commencent 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 du nom complet recherche des services liés au réseau même si le nom du service n’inclut Netpas , tel que xmlprov, le service d’approvisionnement 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 winpar , à 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 Runningest .

Get-Service | Where-Object {$_.Status -eq "Running"}

Get-Service obtient tous les services sur l’ordinateur et envoie les objets vers le bas du pipeline. L’applet Where-Object de commande sélectionne uniquement les services dont la propriété Status est Runningégale.

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 : Répertorier les services sur l’ordinateur qui ont des services dépendants

Cet exemple obtient 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 Get-Service de commande obtient tous les services sur l’ordinateur et envoie les objets vers le bas du pipeline. L’applet Where-Object de commande sélectionne les services dont la propriété DependentServices n’est pas null.

Les résultats sont envoyés au pipeline à l’applet Format-List de commande. 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 7 : 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 l’exécution des services. Cela se produit parce que la valeur de Status est une énumération, dans laquelle Stopped a une valeur 1, et 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 Sort-Object de commande.

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 8 : 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 retournée.

Get-Service "WinRM" -RequiredServices

Exemple 9 : Obtenir un service via l’opérateur de pipeline

Cet exemple obtient le service WinRM sur l’ordinateur local. La chaîne de nom de service, entre guillemets, est envoyée au pipeline Get-Service.

"WinRM" | Get-Service

Paramètres

-DependentServices

Indique que cette applet de commande obtient uniquement les services qui dépendent du service spécifié.

Type:SwitchParameter
Alias:DS
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisplayName

Spécifie, en tant que tableau de chaînes, les noms d’affichage des services à récupérer. Les caractères génériques sont autorisés.

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:True

-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.

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:True

-Include

Spécifie, en tant que tableau de chaînes, un service ou des services inclus dans 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.

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:True

-InputObject

Spécifie les objets ServiceController représentant les services à récupérer. Entrez une variable contenant les objets, ou tapez une commande ou une expression qui obtient ces objets. Vous pouvez diriger un objet de service vers cette applet de commande.

Type:ServiceController[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Name

Spécifie les noms des services à récupérer. Les caractères génériques sont autorisés.

Type:String[]
Alias:ServiceName
Position:0
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:True

-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.

Type:SwitchParameter
Alias:SDO, ServicesDependedOn
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:True

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

PowerShell inclut les alias suivants pour Get-Service:

  • Windows :
    • gsv

Cette applet de commande est disponible uniquement sur les plateformes Windows.

À compter de PowerShell 6.0, les propriétés suivantes sont ajoutées aux objets ServiceController : UserName, Description, DelayedAutoStart, BinaryPathName et StartupType .

Cette applet de commande ne peut afficher les services que lorsque l’utilisateur actuel est autorisé à les afficher. 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 Name 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 les services apparaissent avant Running les services. La propriété Status d’un service est une valeur énumérée dans laquelle les noms des états représentent des valeurs entières. Le tri repose sur la valeur entière, et non sur le nom. Running apparaît avant Stopped , car Stopped a une valeur , 1et Running a une valeur de 4. Pour plus d’informations, consultez ServiceControllerStatus.