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>]説明
このコマンドレットは、Windows プラットフォームでのみ使用できます。
コマンドレットは Stop-Service 、指定された各サービスの停止メッセージを Windows サービス コントローラーに送信します。 サービス名または表示名でサービスを指定することも、InputObject パラメーターを使用して停止するサービスを表すサービス オブジェクトを渡すことができます。
例
例 1: ローカル コンピューターでサービスを停止する
PS C:\> Stop-Service -Name "sysmonlog"このコマンドを実行すると、ローカル コンピューター上のパフォーマンス ログと警告 (SysmonLog) サービスが停止されます。
例 2: 表示名を使用してサービスを停止する
PS C:\> Get-Service -DisplayName "telnet" | Stop-Serviceこのコマンドを実行すると、ローカル コンピューター上の Telnet サービスが停止されます。 このコマンドは、Telnet サービスを表すオブジェクトを取得するために使用 Get-Service します。 パイプライン演算子 (|) は、サービスを停止するオブジェクトを Stop-Serviceパイプ処理します。
例 3: 依存サービスを持つサービスを停止する
PS C:\> Get-Service -Name "iisadmin" | Format-List -Property Name, DependentServices
PS C:\> Stop-Service -Name "iisadmin" -Force -Confirm次の使用例は、ローカル コンピューターの IIS管理 サービスを停止します。 このサービスを停止すると、IIS管理 サービスに依存するサービスも停止するため、IIS管理 サービスに依存するサービスを一覧表示するコマンドを使用Stop-Serviceすることをお勧めします。
最初のコマンドを実行すると、IISAdmin に依存するサービスの一覧が表示されます。 IIS管理 サービスを表すオブジェクトを取得するために使用Get-Serviceします。 パイプライン演算子 (|) は、コマンドレットに結果を Format-List 渡します。 このコマンドでは、Property パラメーターFormat-Listを使用して、サービスの Name プロパティと DependentServices プロパティのみを一覧表示します。
2 番目のコマンドを実行すると、IISAdmin サービスが停止します。 Force パラメーターは、依存サービスを持つサービスを停止するために必要です。 このコマンドでは、Confirm パラメーターを使用して、各サービスを停止する前にユーザーに確認を要求します。
パラメーター
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisplayName
停止するサービスの表示名を指定します。 ワイルドカード文字を使用できます。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-Exclude
このコマンドレットが省略するサービスを指定します。 このパラメーターの値は、Name パラメーターを修飾します。 名前要素またはパターン (s* など) を入力します。 ワイルドカード文字を使用できます。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-Force
そのサービスに依存するサービスがある場合でも、コマンドレットにサービスの停止を強制します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Include
このコマンドレットが停止するサービスを指定します。 このパラメーターの値は、Name パラメーターを修飾します。 名前要素またはパターン (s* など) を入力します。 ワイルドカード文字を使用できます。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-InputObject
停止する サービスを表す ServiceController オブジェクトを指定します。 オブジェクトが格納されている変数を入力するか、オブジェクトを取得するコマンドまたは式を入力します。
| Type: | ServiceController[] |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
停止するサービスのサービス名を指定します。 ワイルドカード文字を使用できます。
| Type: | String[] |
| Aliases: | ServiceName |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | True |
-NoWait
このコマンドレットが no wait オプションを使用することを示します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
サービスを表すオブジェクトを返します。 既定では、このコマンドレットによる出力はありません。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
入力
サービス オブジェクトをこのコマンドレットにパイプできます。
サービスの名前を含む文字列をこのコマンドレットにパイプできます。
出力
None
既定では、このコマンドレットは出力を返しません。
PassThru パラメーターを使用すると、このコマンドレットはサービスを表す ServiceController オブジェクトを返します。
メモ
PowerShell には、次のエイリアスが Stop-Service含まれています。
- Windows:
spsv
このコマンドレットは、Windows プラットフォームでのみ使用できます。
Stop-Service は、現在のユーザーがこれを行うアクセス許可を持っている場合にのみ、サービスを制御できます。 コマンドが正常に機能しない場合は、必要なアクセス許可が与えられていない可能性があります。
サービス名を検索し、システム上のサービスの名前を表示するには、「.」と入力します Get-Service。 サービス名は [名前] 列に表示され、表示名は DisplayName 列に表示されます。
関連リンク
PowerShell
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示