Partager via

Get-Service

  • Référence
Module:
Microsoft.PowerShell.Management

Obtient les services sur un ordinateur local ou distant.

Syntaxe

Get-Service
   [[-Name] <String[]>]
   [-ComputerName <String[]>]
   [-DependentServices]
   [-RequiredServices]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [<CommonParameters>]
Get-Service
   [-ComputerName <String[]>]
   [-DependentServices]
   [-RequiredServices]
   -DisplayName <String[]>
   [-Include <String[]>]
   [-Exclude <String[]>]
   [<CommonParameters>]
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.

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

Get-Service

Cette commande obtient tous les services sur 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.

Exemple 2 : Obtenir des services qui commencent par une chaîne de recherche

Get-Service "wmi*"

Cette commande récupère les services dont les noms de service commencent par WMI (acronyme de Windows Management Instrumentation).

Exemple 3 : Afficher les services qui incluent une chaîne de recherche

Get-Service -Displayname "*network*"

Cette commande affiche les services avec un nom d’affichage qui inclut le réseau word. La recherche du nom complet recherche des services liés au réseau même si le nom du service n’inclut pas « Net », tel que xmlprov, le service d’approvisionnement réseau.

Exemple 4 : Obtenir des services qui commencent par une chaîne de recherche et une exclusion

Get-Service -Name "win*" -Exclude "WinRM"

Ces commandes obtiennent uniquement les services dont les noms de service commencent par win, à l’exception du service WinRM.

Exemple 5 : Afficher les services actuellement actifs

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

Cette commande affiche uniquement les services actuellement actifs. Il utilise l’applet de commande Get-Service pour obtenir tous les services sur l’ordinateur. L’opérateur de pipeline (|) transmet les résultats à l’applet de commande Where-Object, qui sélectionne uniquement les services avec une propriété Status qui est en cours d’exécution.

L’état n’est qu’une propriété d’objets de 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

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

La première commande utilise l’applet de commande Get-Service pour obtenir les services sur l’ordinateur. Un opérateur de pipeline (|) envoie les services à l’applet de commande Where-Object , qui sélectionne les services dont la propriété DependentServices n’est pas null.

Un autre opérateur de pipeline envoie les résultats à l’applet de commande Format-List. La commande utilise son paramètre Property pour afficher le nom du service, le nom des services dépendants et une propriété calculée qui affiche le nombre de services dépendants dont chaque service a.

Exemple 8 : Trier les services par valeur de propriété

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

Cette commande indique 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 d’exécuter des services. Cela se produit parce que la valeur de Status est une énumération, dans laquelle Stopped a la valeur 1, et Running a la valeur 4.

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.

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 Winrm Get-Service 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 le tableau, y compris la propriété MachineName.

Exemple 10 : Obtenir les services dépendants d’un service

Get-Service "WinRM" -RequiredServices

Cette commande obtient les services requis par le service WinRM.

La commande retourne la valeur de la propriété ServicesDependedOn du service.

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

"WinRM" | Get-Service

Cette commande obtient le service WinRM sur l’ordinateur local. Cet exemple montre que vous pouvez diriger une chaîne de nom de service (entre guillemets) vers 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.

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

-DependentServices

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

Par défaut, cette applet de commande obtient tous les services.

Type:SwitchParameter
Alias:DS
Position:Named
Valeur par défaut:None
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. Par défaut, cette applet de commande obtient tous les services sur l’ordinateur.

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 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 également 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 de service des services à récupérer. Les caractères génériques sont autorisés. Par défaut, cette applet de commande obtient tous les services sur l’ordinateur.

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. Par défaut, cette applet de commande obtient tous les services.

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

Entrées

System.ServiceProcess.ServiceController, System.String

Vous pouvez diriger un objet de service ou 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

Vous pouvez également faire référence à Get-Service par son alias intégré , « gsv ». Pour plus d’informations, consultez about_Aliases.

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.

Lorsque vous triez dans l’ordre croissant par valeur d’état, les services « Arrêtés » apparaissent avant les services « En cours d’exécution ». 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 est basé sur la valeur entière, et non sur le nom. « En cours d’exécution » apparaît avant « Arrêté », car « Arrêté » a la valeur « 1 » et « Running » a la valeur « 4 ».