Obtient les services présents sur un ordinateur local ou distant.
Syntaxe
Get-Service [[-Name] <string[]>] [-ComputerName <string[]>] [-DependentServices] [-Exclude <string[]>] [-Include <string[]>] [-RequiredServices] [<CommonParameters>] Get-Service -DisplayName <string[]> [-ComputerName <string[]>] [-DependentServices] [-Exclude <string[]>] [-Include <string[]>] [-RequiredServices] [<CommonParameters>] Get-Service [-InputObject <ServiceController[]>] [-ComputerName <string[]>] [-DependentServices] [-Exclude <string[]>] [-Include <string[]>] [-RequiredServices] [<CommonParameters>]
Description
L'applet de commande Get-Service obtient les objets qui représentent les services présents sur un ordinateur local ou un ordinateur distant, y compris les services en cours d'exécution et les services arrêtés.
Vous pouvez diriger Get-Service de manière à obtenir uniquement des services particuliers en spécifiant le nom ou le nom d'affichage de ces services ou vous pouvez diriger des objets service vers Get-Service.
Paramètres
-ComputerName <string[]>
Obtient les services qui s'exécutent 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 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.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
Localhost |
Accepter l'entrée de pipeline ? |
true (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-DependentServices
Obtient uniquement les services qui dépendent du service spécifié.
Par défaut, Get-Service obtient tous les services.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
False |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-DisplayName <string[]>
Spécifie les noms d'affichage des services à récupérer. Les caractères génériques sont autorisés. Par défaut, Get-Service obtient tous les services présents sur l'ordinateur.
Obligatoire ? |
true |
Position ? |
named |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-Exclude <string[]>
Omet les services spécifiés. La valeur de ce paramètre qualifie le paramètre Name. Entrez un élément ou un modèle de nom, tel que « s* ». Les caractères génériques sont autorisés.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-Include <string[]>
Récupère uniquement les services spécifiés. La valeur de ce paramètre qualifie le paramètre Name. Entrez un élément ou un modèle de nom, tel que « s* ». Les caractères génériques sont autorisés.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-InputObject <ServiceController[]>
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 permettant d'obtenir ces objets. Vous pouvez également diriger un objet service vers Get-Service.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
true (ByValue) |
Accepter les caractères génériques ? |
false |
-Name <string[]>
Spécifie les noms des services à récupérer. Les caractères génériques sont autorisés. Par défaut, Get-Service obtient tous les services présents sur l'ordinateur.
Obligatoire ? |
false |
Position ? |
1 |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
true (ByValue, ByPropertyName) |
Accepter les caractères génériques ? |
true |
-RequiredServices
Obtient uniquement les services que ce service requiert.
Ce paramètre obtient la valeur de la propriété ServicesDependedOn du service. Par défaut, Get-Service obtient tous les services.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
False |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.
Entrées et sorties
Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.
Entrées |
System.ServiceProcess.ServiceController, System.String Vous pouvez diriger un objet service ou un nom de service vers Get-Service. |
Sorties |
System.ServiceProcess.ServiceController Get-Service retourne des objets qui représentent les services sur l'ordinateur. |
Remarques
Vous pouvez également faire référence à Get-Service par son alias intégré, « gsv ». Pour plus d'informations, consultez about_Aliases.
Pour que Get-Service soit en mesure d'afficher les services, l'utilisateur actuel doit être autorisé à les afficher. Si Get-Service n'affiche pas les services, cela signifie peut-être que vous n'êtes pas autorisé à le faire.
Pour rechercher les noms de services et les noms d'affichage des services sur votre système, tapez « get-service ». Les noms de services figurent dans la colonne Name et les noms d'affichage apparaissent dans la colonne DisplayName.
Lorsque vous procédez à un tri dans l'ordre croissant en fonction de la valeur d'état, les services arrêtés (Stopped) apparaissent avant les services en cours d'exécution (Running). La propriété Status d'un service est une valeur énumérée dans laquelle le nom des états représente 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 la valeur « 1 » et « Running » a la valeur « 4 ».
Exemple 1
C:\PS>get-service Description ----------- Cette commande récupère tous les services sur le système. Elle s'exécute comme si vous aviez tapé « get-service * ». L'affichage par défaut répertorie l'état, le nom et le nom d'affichage de chaque service.
Exemple 2
C:\PS>get-service wmi* Description ----------- Cette commande récupère des services dont les noms commencent par « WMI » (acronyme pour Windows Management Instrumentation).
Exemple 3
C:\PS>get-service -displayname *network* Description ----------- Cette commande affiche les services dont le nom d'affichage inclut le mot « network ». La recherche du nom d'affichage permet de rechercher des services associés au réseau, y compris lorsque leur nom n'inclut pas le mot « Net » (xmlprov, le service d'approvisionnement réseau, par exemple).
Exemple 4
C:\PS>get-service -name win* -exclude winrm Description ----------- Ces commandes obtiennent uniquement les services dont le nom de service commence par « win », à l'exception du service WinRM.
Exemple 5
C:\PS>get-service | where-object {$_.Status -eq "Running"} Description ----------- Cette commande affiche uniquement les services actuellement en cours d'exécution. Elle utilise l'applet de commande Get-Service pour obtenir tous les services présents sur l'ordinateur. L'opérateur de pipeline (|) passe les résultats à l'applet de commande Where-Object qui sélectionne uniquement les services dont la propriété Status a la valeur « Running ». Status n'est qu'une des propriétés des objets Service. Pour voir toutes les propriétés, tapez « get-service | get-member »:
Exemple 6
C:\PS>get-service -computername Server02 Description ----------- Cette commande obtient les services présents sur l'ordinateur distant Server02. Comme 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
C:\PS>get-service | where-object {$_.DependentServices} | format-list -property Name, DependentServices, @{Label="NoOfDependentS ervices"; Expression={$_.dependentservices.count}} Name : AudioEndpointBuilder DependentServices : {AudioSrv} NoOfDependentServices : 1 Name : Dhcp DependentServices : {WinHttpAutoProxySvc} NoOfDependentServices : 1 ... Description ----------- Ces commandes répertorient les services présents sur l'ordinateur qui possèdent des services dépendants. La première commande utilise l'applet de commande Get-Service pour obtenir les services présents 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'a pas la valeur 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, ainsi qu'une propriété calculée qui indique le nombre de services dépendants appartenant à chaque service.
Exemple 8
C:\PS>C:\PS> 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 C:\PS> get-service s* | sort-object status -descending Status Name DisplayName ------ ---- ----------- Running ShellHWDetection Shell Hardware Detection Running SharedAccess Windows Firewall/Internet Connectio... Running Spooler Print Spooler Running SSDPSRV SSDP Discovery Service Running srservice System Restore Service Running SCardSvr Smart Card Running SamSs Security Accounts Manager Running Schedule Task Scheduler Running SENS System Event Notification Running seclogon Secondary Logon Stopped SysmonLog Performance Logs and Alerts Stopped SwPrv MS Software Shadow Copy Provider Stopped stisvc Windows Image Acquisition (WIA) Description ----------- Cette commande montre que lorsque vous triez des services dans l'ordre croissant en fonction de la valeur de leur propriété Status, les services arrêtés (Stopped) apparaissent avant les services en cours d'exécution (Running). Cela est dû au fait 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 les services en cours d'exécution en premier, utilisez le paramètre Descending de l'applet de commande Sort-Object.
Exemple 9
C:\PS>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) Description ----------- 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 Get-Service 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 présente les services sous forme de tableau. La commande Format-Table utilise le paramètre Property pour spécifier les propriétés affichées dans le tableau, notamment la propriété MachineName.
Exemple 10
C:\PS>get-service winrm -requiredServices Description ----------- Cette commande obtient les services requis par le service WinRM. La commande retourne la valeur de la nouvelle propriété ServicesDependedOn du service.
Exemple 11
C:\PS>"winrm" | get-service Description ----------- Cette commande obtient le service WinRM présent sur l'ordinateur local. Cet exemple montre que vous pouvez diriger une chaîne de nom de service (placée entre guillemets) vers Get-Service.
Voir aussi