Stop-Service

モジュール:

Microsoft.PowerShell.Management

実行中のサービスを 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

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

最初のコマンドを実行すると、IISAdmin に依存するサービスの一覧が表示されます。 IISAdmin サービスを表すオブジェクトを取得するために使用 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

入力

System.ServiceProcess.ServiceController, System.String

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

出力

None, System.ServiceProcess.ServiceController

このコマンドレットは、PassThru パラメーターを使用すると、サービスを表す System.ServiceProcess.ServiceController オブジェクトを生成します。 それ以外の場合、このコマンドレットによる出力はありません。

メモ

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

組み込みのエイリアス spsv で参照Stop-Serviceすることもできます。 詳細については、「about_Aliases」を参照してください。

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

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

関連リンク

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