ServiceController.GetServices Méthode

Définition

Espace de noms:

System.ServiceProcess

Assembly:

System.ServiceProcess.ServiceController.dll

Assembly:

System.ServiceProcess.dll

Récupère les services de pilotes autres que de périphériques sur un ordinateur et ceux qui ne sont pas des pilotes.

Surcharges

GetServices(String)	Récupère tous les services sur l'ordinateur spécifié, sauf les services de pilotes de périphériques.
GetServices()	Récupère tous les services sur l'ordinateur local, sauf les services de pilotes de périphériques.

GetServices(String)

Récupère tous les services sur l'ordinateur spécifié, sauf les services de pilotes de périphériques.

public:
 static cli::array <System::ServiceProcess::ServiceController ^> ^ GetServices(System::String ^ machineName);

public static System.ServiceProcess.ServiceController[] GetServices (string machineName);

static member GetServices : string -> System.ServiceProcess.ServiceController[]

Public Shared Function GetServices (machineName As String) As ServiceController()

Paramètres

machineName

String

Ordinateur à partir duquel les services doivent être récupérés.

Retours

ServiceController[]

Tableau de type ServiceController, dans lequel chaque élément est associé à un service sur l'ordinateur spécifié.

Exceptions

Win32Exception

Une erreur s'est produite lors de l'accès à une API système.

ArgumentException

La syntaxe du paramètre machineName n'est pas valide.

Remarques

GetServices retourne uniquement les services de pilotes non-périphériques et les services qui ne sont pas des pilotes de l’ordinateur spécifié. Pour récupérer les services de pilote d’appareil, appelez la GetDevices méthode. Ensemble, les deux méthodes fournissent l’accès à tous les services sur un ordinateur.

Voir aussi

• GetDevices()

GetServices()

Récupère tous les services sur l'ordinateur local, sauf les services de pilotes de périphériques.

public:
 static cli::array <System::ServiceProcess::ServiceController ^> ^ GetServices();

public static System.ServiceProcess.ServiceController[] GetServices ();

static member GetServices : unit -> System.ServiceProcess.ServiceController[]

Public Shared Function GetServices () As ServiceController()

Retours

ServiceController[]

Tableau de type ServiceController, dans lequel chaque élément est associé à un service sur l'ordinateur local.

Exceptions

Win32Exception

Une erreur s'est produite lors de l'accès à une API système.

Exemples

L’exemple suivant utilise la ServiceController classe pour afficher les services qui s’exécutent sur l’ordinateur local.

array<ServiceController^>^scServices = ServiceController::GetServices();

// Display the list of services currently running on this computer.
Console::WriteLine(  "Services running on the local computer:" );
for each (ServiceController^ scTemp in scServices)
{
   if ( scTemp->Status == ServiceControllerStatus::Running )
   {
      // Write the service name and the display name
      // for each running service.
      Console::WriteLine();
      Console::WriteLine(  "  Service :        {0}", scTemp->ServiceName );
      Console::WriteLine(  "    Display name:    {0}", scTemp->DisplayName );

      // Query WMI for additional information about this service.
      // Display the start name (LocalSystem, etc) and the service
      // description.
      ManagementObject^ wmiService;
      String^ objPath;
      objPath = String::Format( "Win32_Service.Name='{0}'", scTemp->ServiceName );
      wmiService = gcnew ManagementObject( objPath );
      if ( wmiService )
      {
         wmiService->Get();
         Object^ objStartName = wmiService["StartName"];
         Object^ objDescription = wmiService["Description"];
         if ( objStartName )
         {
            Console::WriteLine(  "    Start name:      {0}", objStartName->ToString() );
         }
         if ( objDescription )
         {
            Console::WriteLine(  "    Description:     {0}", objDescription->ToString() );
         }
      }
   }
}

ServiceController[] scServices;
scServices = ServiceController.GetServices();

// Display the list of services currently running on this computer.

Console.WriteLine("Services running on the local computer:");
foreach (ServiceController scTemp in scServices)
{
   if (scTemp.Status == ServiceControllerStatus.Running)
   {
      // Write the service name and the display name
      // for each running service.
      Console.WriteLine();
      Console.WriteLine("  Service :        {0}", scTemp.ServiceName);
      Console.WriteLine("    Display name:    {0}", scTemp.DisplayName);

      // Query WMI for additional information about this service.
      // Display the start name (LocalSystem, etc) and the service
      // description.
      ManagementObject wmiService;
      wmiService = new ManagementObject("Win32_Service.Name='" + scTemp.ServiceName + "'");
      wmiService.Get();
      Console.WriteLine("    Start name:      {0}", wmiService["StartName"]);
      Console.WriteLine("    Description:     {0}", wmiService["Description"]);
   }
}

   Dim scServices() As ServiceController
   scServices = ServiceController.GetServices()
 
   ' Display the list of services currently running on this computer.
   Console.WriteLine("Services running on the local computer:")

   Dim scTemp As ServiceController
   For Each scTemp In  scServices

      If scTemp.Status = ServiceControllerStatus.Running Then
         ' Write the service name and the display name
         ' for each running service.
         Console.WriteLine()
         Console.WriteLine("  Service :        {0}", scTemp.ServiceName)
         Console.WriteLine("    Display name:    {0}", scTemp.DisplayName)
         
         ' Query WMI for additional information about this service.
         ' Display the start name (LocalSystem, etc) and the service
         ' description.
         Dim wmiService As ManagementObject
         wmiService = New ManagementObject("Win32_Service.Name='" + scTemp.ServiceName + "'")
         wmiService.Get()
         Console.WriteLine("    Start name:      {0}", wmiService("StartName"))
         Console.WriteLine("    Description:     {0}", wmiService("Description"))
      End If

   Next scTemp

Remarques

GetServices retourne uniquement les services de pilotes non-périphériques et les services qui ne sont pas des pilotes de l’ordinateur local. Pour récupérer les services de pilote d’appareil, appelez la GetDevices méthode. Ensemble, les deux méthodes fournissent l’accès à tous les services sur un ordinateur.

Voir aussi

• GetDevices()