Stop-Service

構文

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>]

説明

このコマンドレットは、Windows プラットフォームでのみ使用できます。

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 サービスに依存するサービスも停止するため、の前に、IISAdmin サービスに依存するサービスを一覧表示するコマンドを使用することをお勧めします。

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

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

パラメーター

-Confirm

-DisplayName

-Exclude

-Force

-Include

-InputObject

-Name

-NoWait

-PassThru

-WhatIf

入力

ServiceController

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

String

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

出力

None

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

ServiceController

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

メモ

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

• Windows:
  • spsv

このコマンドレットは、Windows プラットフォームでのみ使用できます。

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

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

関連リンク

• Get-Service
• New-Service
• Restart-Service
• Resume-Service
• Set-Service
• Start-Service
• Suspend-Service
• Remove-Service