次の方法で共有


Stop-Service

実行中の 1 つ以上のサービスを停止します。

構文

Stop-Service
    [-Force]
    [-NoWait]
    [-InputObject] <ServiceController[]>
    [-PassThru]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Stop-Service
    [-Force]
    [-NoWait]
    [-Name] <String[]>
    [-PassThru]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Stop-Service
    [-Force]
    [-NoWait]
    [-PassThru]
    -DisplayName <String[]>
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

説明

Stop-Service コマンドレットは、指定された各サービスの停止メッセージを Windows サービス コントローラーに送信します。 サービス名または表示名でサービスを指定することも、InputObject パラメーターを使用して、停止するサービスを表すサービス オブジェクトを渡すことができます。

例 1: ローカル コンピューターでサービスを停止する

PS C:\> Stop-Service -Name "sysmonlog"

このコマンドは、ローカル コンピューター上のパフォーマンス ログとアラート (SysmonLog) サービスを停止します。

例 2: 表示名を使用してサービスを停止する

PS C:\> Get-Service -DisplayName "telnet" | Stop-Service

このコマンドは、ローカル コンピューター上の Telnet サービスを停止します。 このコマンドは、Get-Service を使用して、Telnet サービスを表すオブジェクトを取得します。 パイプライン演算子 (|) は、サービスを停止する Stop-Serviceにオブジェクトをパイプ処理します。

例 3: 依存サービスを持つサービスを停止する

PS C:\> Get-Service -Name "iisadmin" | Format-List -Property Name, DependentServices
PS C:\> Stop-Service -Name "iisadmin" -Force -Confirm

次の使用例は、ローカル コンピューターの IISAdmin サービスを停止します。 このサービスを停止すると、IISAdmin サービスに依存するサービスも停止するため、Stop-Service の前に IISAdmin サービスに依存するサービスを一覧表示するコマンドを使用することをお勧めします。

最初のコマンドは、IISAdmin に依存するサービスを一覧表示します。 Get-Service を使用して、IISAdmin サービスを表すオブジェクトを取得します。 パイプライン演算子 (|) は、結果を Format-List コマンドレットに渡します。 このコマンドでは、Format-ListProperty パラメーターを使用して、サービスの Name プロパティと DependentServices プロパティのみを一覧表示します。

2 番目のコマンドは IISAdmin サービスを停止します。 依存サービスを持つサービスを停止するには、Force パラメーターが必要です。 コマンドは、Confirm パラメーターを使用して、各サービスを停止する前にユーザーに確認を要求します。

パラメーター

-Confirm

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

型:SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DisplayName

停止するサービスの表示名を指定します。 ワイルドカード文字を使用できます。

型:String[]
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:True

-Exclude

このコマンドレットが省略するサービスを指定します。 このパラメーターの値は、Name パラメーターを修飾します。 名前要素またはパターン (s* など) を入力します。 ワイルドカード文字を使用できます。

型:String[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:True

-Force

そのサービスに依存するサービスがある場合でも、コマンドレットにサービスの停止を強制します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Include

このコマンドレットが停止するサービスを指定します。 このパラメーターの値は、Name パラメーターを修飾します。 名前要素またはパターン (s* など) を入力します。 ワイルドカード文字を使用できます。

型:String[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:True

-InputObject

停止するサービス 表す ServiceController オブジェクトを指定します。 オブジェクトを含む変数を入力するか、オブジェクトを取得するコマンドまたは式を入力します。

型:ServiceController[]
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Name

停止するサービスのサービス名を指定します。 ワイルドカード文字を使用できます。

型:String[]
Aliases:ServiceName
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:True

-NoWait

このコマンドレットが no wait オプションを使用することを示します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PassThru

サービスを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

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

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

ServiceController

サービス オブジェクトをこのコマンドレットにパイプできます。

String

サービスの名前を含む文字列をこのコマンドレットにパイプできます。

出力

None

既定では、このコマンドレットは出力を返しません。

ServiceController

PassThru パラメーターを使用すると、このコマンドレットはサービスを表す ServiceController オブジェクトを返します。

メモ

Windows PowerShell には、Stop-Serviceの次のエイリアスが含まれています。

  • spsv

Stop-Service は、現在のユーザーがこれを行うアクセス許可を持っている場合にのみサービスを制御できます。 コマンドが正しく機能しない場合は、必要なアクセス許可がない可能性があります。

システム上のサービス名と表示名を検索するには、「Get-Service」と入力します。 サービス名は Name 列に表示され、表示名は DisplayName 列に表示されます。