次の方法で共有

New-Service

モジュール:
Microsoft.PowerShell.Management Module

新しい Windows サービスを作成します。

構文

Default (既定) 

New-Service
    [-Name] <String>
    [-BinaryPathName] <String>
    [-DisplayName <String>]
    [-Description <String>]
    [-StartupType <ServiceStartMode>]
    [-Credential <PSCredential>]
    [-DependsOn <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

説明

New-Service コマンドレットは、レジストリとサービス データベースに Windows サービスの新しいエントリを作成します。 新しいサービスには、サービス中に実行される実行可能ファイルが必要です。

このコマンドレットのパラメーターを使用すると、サービスの表示名、説明、スタートアップの種類、依存関係を設定できます。

例

例 1: サービスを作成する

New-Service -Name "TestService" -BinaryPathName 'C:\WINDOWS\System32\svchost.exe -k netsvcs'

このコマンドは、TestService という名前のサービスを作成します。

例 2: 説明、スタートアップの種類、表示名を含むサービスを作成する

$params = @{
  Name = "TestService"
  BinaryPathName = 'C:\WINDOWS\System32\svchost.exe -k netsvcs'
  DependsOn = "NetLogon"
  DisplayName = "Test Service"
  StartupType = "Manual"
  Description = "This is a test service."
}
New-Service @params

このコマンドは、TestService という名前のサービスを作成します。 New-Service のパラメーターを使用して、新しいサービスの説明、スタートアップの種類、表示名を指定します。

例 3: 新しいサービスを表示する

Get-CimInstance -ClassName Win32_Service -Filter "Name='testservice'"

ExitCode  : 0
Name      : testservice
ProcessId : 0
StartMode : Auto
State     : Stopped
Status    : OK

このコマンドでは、Get-CimInstance を使用して、新しいサービスの Win32_Service オブジェクトを取得します。 このオブジェクトには、開始モードとサービスの説明が含まれます。

例 4: サービスを削除する

sc.exe delete TestService
# - or -
(Get-CimInstance -Class Win32_Service -Filter "name='TestService'").Delete()

この例では、TestService サービスを削除する 2 つの方法を示します。 最初のコマンドでは、Sc.exeの削除オプションを使用します。 2 番目のコマンドでは、 返される Win32_Service オブジェクトの Get-CimInstance メソッドを使用します。

パラメーター

-BinaryPathName

サービスの実行可能ファイルのパスを指定します。 このパラメーターは必須です。

サービス バイナリ ファイルへの完全修飾パス。 パスにスペースが含まれている場合は、正しく解釈されるように引用符で囲む必要があります。 たとえば、D:\my share\myservice.exe は '"D:\my share\myservice.exe"'として指定する必要があります。

パスには、自動開始サービスの引数を含めることもできます。 たとえば、'"D:\my share\myservice.exe" arg1 arg2' のようにします。 これらの引数は、サービス エントリ ポイントに渡されます。

詳細については、CreateServiceW API の lpBinaryPathName パラメーター 参照してください。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:1
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Confirm

コマンドレットを実行する前に確認を求めるメッセージが表示されます。

パラメーターのプロパティ

型:SwitchParameter
規定値:False
ワイルドカードのサポート:False
DontShow:False
Aliases:cf

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Credential

サービス ログオン アカウントとしてサービスによって使用されるアカウントを指定します。

User01 や Domain01\User01などのユーザー名を入力するか、 コマンドレットによって生成された Get-Credential オブジェクトを入力します。 ユーザー名を入力すると、このコマンドレットによってパスワードの入力が求められます。

資格情報は PSCredential オブジェクトに格納され、パスワードは SecureStringとして格納されます。

注

SecureString データ保護についての詳細は、「SecureString はどのくらい安全ですか？ 」を参照してください。.

パラメーターのプロパティ

型:PSCredential
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-DependsOn

新しいサービスが依存する他のサービスの名前を指定します。 複数のサービス名を入力するには、コンマを使用して名前を区切ります。

パラメーターのプロパティ

型:

String[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Description

サービスの説明を指定します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-DisplayName

サービスの表示名を指定します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Name

サービスの名前を指定します。 このパラメーターは必須です。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:サービス名

パラメーター セット

(All)
配置:0
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-StartupType

サービスのスタートアップの種類を設定します。 このパラメーターに使用できる値は次のとおりです。

  • 自動 - サービスは、オペレーティング システムの起動時に開始されるか、オペレーティング システムによって開始されました。 自動開始サービスが手動で開始されたサービスに依存している場合、手動で開始されたサービスもシステムの起動時に自動的に開始されます。
  • 無効 - サービスは無効になっており、ユーザーまたはアプリケーションが開始することはできません。
  • 手動 - サービスの開始は、ユーザーによる手動操作、Service Control Manager、またはアプリケーションによってのみ行われます。
  • ブート - サービスがシステム ローダーによって起動されたデバイス ドライバーであることを示します。 この値は、デバイス ドライバーに対してのみ有効です。
  • システム - サービスが 'IOInitSystem()' 関数によって開始されたデバイス ドライバーであることを示します。 この値は、デバイス ドライバーに対してのみ有効です。

既定値は自動 です。

パラメーターのプロパティ

型:ServiceStartMode
規定値:Automatic
指定可能な値:Boot, System, Automatic, Manual, Disabled
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

パラメーターのプロパティ

型:SwitchParameter
規定値:False
ワイルドカードのサポート:False
DontShow:False
Aliases:ウィスコンシン

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

入力

None

このコマンドレットにオブジェクトをパイプすることはできません。

出力

ServiceController

このコマンドレットは、新しいサービスを表すオブジェクトを返します。

メモ

このコマンドレットを実行するには、[管理者として実行] オプションを使用して PowerShell を起動します。

サービスを削除するには、Sc.exeを使用するか、Get-CimInstance コマンドレットを使用してサービスを表す Win32_Service オブジェクトを取得し、Delete メソッドを使用してサービスを削除します。 Get-Service 返されるオブジェクトには delete メソッドがありません。