ServiceControllerとは何？わかりやすく解説 Weblio辞書

パブリックイベントパブリックイベント

	名前	説明
	Disposed	コンポーネントの Disposed イベントを待機するイベントハンドラを追加します。 ( Component から継承されます。)

参照

関連項目

ServiceController クラス
System.ServiceProcess 名前空間
ServiceBase クラス
ServiceControllerStatus
ServiceType

Windows サービスを表し、実行中のサービスまたは停止したサービスへの接続、サービスの操作、またはサービスに関する情報の取得を実現します。

名前空間: System.ServiceProcess
アセンブリ: System.ServiceProcess (system.serviceprocess.dll 内)
構文

Visual Basic (宣言)

Public Class ServiceController
    Inherits Component

Visual Basic (使用法)

Dim instance As ServiceController

C#

public class ServiceController : Component

C++

public ref class ServiceController : public
 Component

J#

public class ServiceController extends Component

JScript

public class ServiceController extends
 Component

解説

ServiceController クラスを使用すると、既存のサービスに接続して、動作を制御できます。ServiceController クラスのインスタンスを作成すると、特定の Windows サービスと対話できるようにプロパティを設定します。この設定後、クラスを使用してサービスの開始、停止、およびその他の操作を実行できます。

ほとんどの場合、ServiceController コンポーネントは管理機能として使用します。たとえば、ServiceController インスタンスを通じてサービスにカスタムコマンドを送信する Windows アプリケーションまたは Web アプリケーションを作成できます。サービスコントロールマネージャ (SCM: Service Control Manager) Microsoft 管理コンソールスナップインではカスタムコマンドがサポートされていないため、このような機能は便利です。

ServiceController のインスタンスを作成した後で、対話の対象となるサービスを識別する 2 つのプロパティとして、制御するコンピュータ名およびサービス名を設定する必要があります。

メモ
既定では、MachineName はローカルコンピュータに設定されているため、別のコンピュータを指定するインスタンスを設定しない限り、この設定を変更する必要はありません。

通常、サービスの作成者は、特定のコマンドに関連付けられているアクションをカスタマイズするコードを書き込みます。たとえば、ServiceBase.OnPause コマンドに応答するコードをサービスに含むことができます。この場合、Pause タスクのカスタムプロセスは、システムがサービスを一時中断する前に実行されます。

サービスが処理できる一連のコマンドは、そのサービスのプロパティによって決まります。たとえば、あるサービスの CanStop プロパティを false に設定するとします。この設定により、そのサービスでは Stop コマンドが使用できなくなります。必要なボタンを無効にすると、SCM でサービスを停止できなくなります。コードでサービスを停止しようとすると、エラーが発生し、" servicename を停止できませんでした。" というエラーメッセージが表示されます。

継承階層

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
      System.ServiceProcess.ServiceController

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ServiceController メンバ
System.ServiceProcess 名前空間
ServiceBase クラス
ServiceControllerStatus
ServiceType

名前空間: System.ServiceProcess
アセンブリ: System.ServiceProcess (system.serviceprocess.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New ServiceController

C#

public ServiceController ()

C++

public:
ServiceController ()

J#

public ServiceController ()

JScript

public function ServiceController ()

使用例

ServiceController クラスを使用して Alerter サービスが停止しているかどうかを確認する例を次に示します。サービスが停止している場合、このコードはサービスを開始し、サービスステータスが Running に設定されるまで待機します。

Visual Basic

' Check whether the Alerter service is started.

Dim sc As New ServiceController()
sc.ServiceName = "Alerter"
Console.WriteLine("The Alerter service status is currently set
 to {0}", sc.Status)

If sc.Status = ServiceControllerStatus.Stopped Then
   ' Start the service if the current status is stopped.
   Console.WriteLine("Starting the Alerter service...")

   Try
      ' Start the service, and wait until its status is "Running".
      sc.Start()
      sc.WaitForStatus(ServiceControllerStatus.Running)
      
      ' Display the current service status.
      Console.WriteLine("The Alerter service status is now set
 to {0}.", sc.Status)
   Catch 
      Console.WriteLine("Could not start the Alerter service.")
   End Try
End If

C#

// Check whether the Alerter service is started.

ServiceController sc  = new ServiceController();
sc.ServiceName = "Alerter";
Console.WriteLine("The Alerter service status is currently set
 to {0}", 
                   sc.Status.ToString());

if (sc.Status == ServiceControllerStatus.Stopped)
{
   // Start the service if the current status is stopped.

   Console.WriteLine("Starting the Alerter service...");
   try 
   {
      // Start the service, and wait until its status is "Running".
      sc.Start();
      sc.WaitForStatus(ServiceControllerStatus.Running);
   
      // Display the current service status.
      Console.WriteLine("The Alerter service status is now set
 to {0}.", 
                         sc.Status.ToString());
   }
   catch (InvalidOperationException)
   {
      Console.WriteLine("Could not start the Alerter service.");
   }
}

C++

// Check whether the Alerter service is started.
ServiceController^ sc = gcnew ServiceController;
if ( sc )
{
   sc->ServiceName =  "Alerter";
   Console::WriteLine(  "The Alerter service status is currently set
 to {0}", sc->Status );
   if ( sc->Status == (ServiceControllerStatus::Stopped) )
   {
      // Start the service if the current status is stopped.
      Console::WriteLine(  "Starting the Alerter service..." );
      try
      {
         // Start the service, and wait until its status is "Running".
         sc->Start();
         sc->WaitForStatus( ServiceControllerStatus::Running );
         
         // Display the current service status.
         Console::WriteLine(  "The Alerter service status is now set
 to {0}.", sc->Status );
      }
      catch ( InvalidOperationException^ e ) 
      {
         Console::WriteLine(  "Could not start the Alerter service." );
      }
   }
}

J#

// Check whether the Alerter service is started.
ServiceController sc = new ServiceController();
sc.set_ServiceName("Alerter");
Console.WriteLine("The Alerter service status is currently set
 to {0}",
    sc.get_Status().ToString());

if (sc.get_Status().Equals(ServiceControllerStatus.Stopped)) {
    // Start the service if the current status is stopped.
    Console.WriteLine("Starting the Alerter service...");
    try {
        // Start the service, and wait until its status is 
        // "Running".
        sc.Start();
        sc.WaitForStatus(ServiceControllerStatus.Running);
        // Display the current service status.
        Console.WriteLine("The Alerter service status is now set
 to {0}.",
            sc.get_Status().ToString());
    }
    catch (InvalidOperationException exp) {
        Console.WriteLine("Could not start the Alerter service.");
    }
}

.NET Framework のセキュリティ

直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ServiceController クラス
ServiceController メンバ
System.ServiceProcess 名前空間

ローカルコンピュータの既存のサービスに関連付けられている ServiceController クラスの新しいインスタンスを初期化します。

名前空間: System.ServiceProcess
アセンブリ: System.ServiceProcess (system.serviceprocess.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    name As String _
)

Visual Basic (使用法)

Dim name As String

Dim instance As New ServiceController(name)

C#

public ServiceController (
    string name
)

C++

public:
ServiceController (
    String^ name
)

J#

public ServiceController (
    String name
)

JScript

public function ServiceController (
    name : String
)

パラメータ

name: システムでサービスを識別するための短い名前。

例外

例外の種類	条件
ArgumentException	name パラメータが null 参照 (Visual Basic では Nothing) か、長さが 0 です。

使用例

ServiceController クラスを使用して、Telnet サービスの現在のステータスを確認する例を次に示します。サービスが停止している場合、このコードはサービスを開始します。サービスが実行中である場合は、そのサービスを停止します。

Visual Basic

' Toggle the Telnet service - 
' If it is started (running, paused, etc), stop the service.
' If it is stopped, start the service.
Dim sc As New ServiceController("Telnet")
Console.WriteLine("The Telnet service status is currently set
 to {0}", sc.Status)

If sc.Status.Equals(ServiceControllerStatus.Stopped) Or
 sc.Status.Equals(ServiceControllerStatus.StopPending) Then
   ' Start the service if the current status is stopped.
   Console.WriteLine("Starting the Telnet service...")
   sc.Start()
Else
   ' Stop the service if its status is not set to "Stopped".
   Console.WriteLine("Stopping the Telnet service...")
   sc.Stop()
End If

' Refresh and display the current service status.
sc.Refresh()
Console.WriteLine("The Telnet service status is now set to {0}.",
 sc.Status)

C#

// Toggle the Telnet service - 
// If it is started (running, paused, etc), stop the service.
// If it is stopped, start the service.
ServiceController sc = new ServiceController("Telnet");
Console.WriteLine("The Telnet service status is currently set
 to {0}", 
                  sc.Status.ToString());

if  ((sc.Status.Equals(ServiceControllerStatus.Stopped)) ||
     (sc.Status.Equals(ServiceControllerStatus.StopPending)))
{
   // Start the service if the current status is stopped.

   Console.WriteLine("Starting the Telnet service...");
   sc.Start();
}  
else
{
   // Stop the service if its status is not set to "Stopped".

   Console.WriteLine("Stopping the Telnet service...");
   sc.Stop();
}  

// Refresh and display the current service status.
sc.Refresh();
Console.WriteLine("The Telnet service status is now set to
 {0}.", 
                   sc.Status.ToString());

C++

// Toggle the Telnet service - 
// If it is started (running, paused, etc), stop the service.
// If it is stopped, start the service.
ServiceController^ sc = gcnew ServiceController(  "Telnet" );
if ( sc )
{
   Console::WriteLine(  "The Telnet service status is currently set
 to {0}", sc->Status );
   if ( (sc->Status == (ServiceControllerStatus::Stopped) )
 || (sc->Status == (ServiceControllerStatus::StopPending) ) )
   {
      // Start the service if the current status is stopped.
      Console::WriteLine(  "Starting the Telnet service..." );
      sc->Start();
   }
   else
   {
      // Stop the service if its status is not set to "Stopped".
      Console::WriteLine(  "Stopping the Telnet service..." );
      sc->Stop();
   }

   // Refresh and display the current service status.
   sc->Refresh();
   Console::WriteLine(  "The Telnet service status is now set
 to {0}.", sc->Status );

J#

// Toggle the Telnet service - 
// If it is started (running, paused, etc), stop the service.
// If it is stopped, start the service.
ServiceController sc = new ServiceController("Telnet");
Console.WriteLine("The Telnet service status is currently set
 to {0}",
    sc.get_Status().ToString());

if (sc.get_Status().Equals(ServiceControllerStatus.Stopped) ||
 
    sc.get_Status().Equals(ServiceControllerStatus.StopPending)) {
    // Start the service if the current status is stopped.
    Console.WriteLine("Starting the Telnet service...");
    sc.Start();
}
else {
    // Stop the service if its status is not set to "Stopped".
    Console.WriteLine("Stopping the Telnet service...");
    sc.Stop();
}
// Refresh and display the current service status.
sc.Refresh();
Console.WriteLine("The Telnet service status is now set to
 {0}.", 
    sc.get_Status().ToString());

.NET Framework のセキュリティ

直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ServiceController クラス
ServiceController メンバ
System.ServiceProcess 名前空間

指定したコンピュータの既存のサービスに関連付けられている ServiceController クラスの新しいインスタンスを初期化します。

名前空間: System.ServiceProcess
アセンブリ: System.ServiceProcess (system.serviceprocess.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    name As String, _
    machineName As String _
)

Visual Basic (使用法)

Dim name As String
Dim machineName As String

Dim instance As New ServiceController(name,
 machineName)

C#

public ServiceController (
    string name,
    string machineName
)

C++

public:
ServiceController (
    String^ name, 
    String^ machineName
)

J#

public ServiceController (
    String name, 
    String machineName
)

JScript

public function ServiceController (
    name : String, 
    machineName : String
)

パラメータ

name: システムでサービスを識別するための短い名前。

machineName: サービスが常駐するコンピュータ。

例外

例外の種類	条件
ArgumentException	name パラメータが null 参照 (Visual Basic では Nothing) か、長さが 0 です。または machineName パラメータの構文が無効です。

例外の種類

条件

ArgumentException

name パラメータが null 参照 (Visual Basic では Nothing) か、長さが 0 です。

または

machineName パラメータの構文が無効です。

解説

machineName パラメータで "." を使用すると、ローカルコンピュータを表すことができます。

.NET Framework のセキュリティ

直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ServiceController クラス
ServiceController メンバ
System.ServiceProcess 名前空間

ServiceController クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
ServiceController ()	特定のサービスに関連付けられていない ServiceController クラスの新しいインスタンスを初期化します。
ServiceController (String)	ローカルコンピュータの既存のサービスに関連付けられている ServiceController クラスの新しいインスタンスを初期化します。
ServiceController (String, String)	指定したコンピュータの既存のサービスに関連付けられている ServiceController クラスの新しいインスタンスを初期化します。

参照

	名前	説明
	CanRaiseEvents	コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。 ( Component から継承されます。)
	DesignMode	Component が現在デザインモードかどうかを示す値を取得します。 ( Component から継承されます。)
	Events	Component に結び付けられているイベントハンドラのリストを取得します。 ( Component から継承されます。)

	名前	説明
	Close	対象となる ServiceController インスタンスをサービスから切断し、インスタンスが割り当てたすべてのリソースを解放します。
	Continue	サービスが一時中断された後に、続行します。
	CreateObjRef	リモートオブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 ( MarshalByRefObject から継承されます。)
	Dispose	オーバーロードされます。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	ExecuteCommand	サービスでカスタムコマンドを実行します。
	GetDevices	オーバーロードされます。コンピュータのデバイスドライバサービスを取得します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービスオブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
	GetServices	オーバーロードされます。コンピュータのデバイス以外のドライバサービス、およびドライバ以外のサービスを取得します。
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	InitializeLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、有効期間サービスオブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
	Pause	サービスの操作を中断します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	Refresh	すべてのプロパティ値を現在の値に設定して更新します。
	Start	オーバーロードされます。サービスを開始します。
	Stop	このサービスと、このサービスに依存しているすべてのサービスを停止します。
	ToString	Component の名前を格納している String を返します (存在する場合)。このメソッドはオーバーライドできません。 ( Component から継承されます。)
	WaitForStatus	オーバーロードされます。サービスが指定したステータスになるまで、待機します。

関連項目

ServiceController クラス
System.ServiceProcess 名前空間
ServiceBase クラス
ServiceControllerStatus
ServiceType

Windows サービスを表し、実行中のサービスまたは停止したサービスへの接続、サービスの操作、またはサービスに関する情報の取得を実現します。

ServiceController データ型で公開されるメンバを以下の表に示します。

パブリックコンストラクタ

	名前	説明
	ServiceController	オーバーロードされます。 ServiceController クラスの新しいインスタンスを初期化します。

パブリックプロパティ

( プロテクトプロパティも参照)

	名前	説明
	CanPauseAndContinue	サービスを一時中断および再開できるかどうかを示す値を取得します。
	CanShutdown	システムのシャットダウン時に、サービスにそれを通知する必要があるかどうかを示す値を取得します。
	CanStop	サービスをいったん開始してから停止できるかどうかを示す値を取得します。
	Container	Component を格納している IContainer を取得します。(Component から継承されます。)
	DependentServices	この ServiceController インスタンスに関連付けられたサービスに依存している一連のサービスを取得します。
	DisplayName	サービスの表示名を取得または設定します。
	MachineName	このサービスが常駐しているコンピュータの名前を取得または設定します。
	ServiceHandle	サービスのハンドルを取得します。
	ServiceName	このインスタンスが参照するサービスを識別する名前を取得または設定します。
	ServicesDependedOn	対象となるサービスが依存している一連のサービス。
	ServiceType	対象となるオブジェクトが参照するサービスの種類を取得します。
	Site	Component の ISite を取得または設定します。(Component から継承されます。)
	Status	対象となるインスタンスが参照するサービスのステータスを取得します。

プロテクトプロパティ

	名前	説明
	CanRaiseEvents	コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。(Component から継承されます。)
	DesignMode	Component が現在デザインモードかどうかを示す値を取得します。(Component から継承されます。)
	Events	Component に結び付けられているイベントハンドラのリストを取得します。(Component から継承されます。)

パブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	Close	対象となる ServiceController インスタンスをサービスから切断し、インスタンスが割り当てたすべてのリソースを解放します。
	Continue	サービスが一時中断された後に、続行します。
	CreateObjRef	リモートオブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (MarshalByRefObject から継承されます。)
	Dispose	オーバーロードされます。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	ExecuteCommand	サービスでカスタムコマンドを実行します。
	GetDevices	オーバーロードされます。コンピュータのデバイスドライバサービスを取得します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービスオブジェクトを取得します。 (MarshalByRefObject から継承されます。)
	GetServices	オーバーロードされます。コンピュータのデバイス以外のドライバサービス、およびドライバ以外のサービスを取得します。
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	InitializeLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、有効期間サービスオブジェクトを取得します。 (MarshalByRefObject から継承されます。)
	Pause	サービスの操作を中断します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	Refresh	すべてのプロパティ値を現在の値に設定して更新します。
	Start	オーバーロードされます。サービスを開始します。
	Stop	このサービスと、このサービスに依存しているすべてのサービスを停止します。
	ToString	Component の名前を格納している String を返します (存在する場合)。このメソッドはオーバーライドできません。 (Component から継承されます。)
	WaitForStatus	オーバーロードされます。サービスが指定したステータスになるまで、待機します。

プロテクトメソッド

	名前	説明
	Dispose	オーバーロードされます。オーバーライドされます。
	Finalize	Component がガベージコレクションによってクリアされる前に、アンマネージリソースを解放し、その他のクリーンアップ操作を実行します。 (Component から継承されます。)
	GetService	Component またはその Container で提供されるサービスを表すオブジェクトを返します。 (Component から継承されます。)
	MemberwiseClone	オーバーロードされます。 ( MarshalByRefObject から継承されます。)

パブリックイベント

	名前	説明
	Disposed	コンポーネントの Disposed イベントを待機するイベントハンドラを追加します。(Component から継承されます。)

参照

ServiceControllerとは？わかりやすく解説

ServiceController イベント

関連項目

ServiceController クラス

ServiceController コンストラクタ ()

ServiceController コンストラクタ (String)

ServiceController コンストラクタ (String, String)

ServiceController コンストラクタ

関連項目

ServiceController プロパティ

関連項目

ServiceController メソッド

関連項目

ServiceController メンバ

関連項目

英和和英テキスト翻訳

「ServiceController」の関連用語


	© 2026 Microsoft.All rights reserved.

ServiceControllerとは？ わかりやすく解説

ServiceController イベント

関連項目

ServiceController クラス

ServiceController コンストラクタ ()

ServiceController コンストラクタ (String)

ServiceController コンストラクタ (String, String)

ServiceController コンストラクタ

関連項目

ServiceController プロパティ

関連項目

ServiceController メソッド

関連項目

ServiceController メンバ

関連項目

英和和英テキスト翻訳

「ServiceController」の関連用語

ServiceControllerとは？わかりやすく解説