Resume-Service

  • リファレンス
モジュール:
Microsoft.PowerShell.Management

中断 (一時停止) 中のサービスを 1 つ以上再開します。

構文

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

説明

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

コマンドレットは Resume-Service 、指定された各サービスの Windows サービス コントローラーに再開メッセージを送信します。 サービスが中断されると、再開されます。 現在実行中の場合、メッセージは無視されます。 サービス名または表示名でサービスを指定するか、InputObject パラメーターを使用して、再開するサービスを表すサービス オブジェクトを渡すことができます。

例

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

PS C:\> Resume-Service "sens"

このコマンドは、ローカル コンピューターでシステム イベント通知サービスを再開します。 サービス名は、コマンド内で sens によって表されます。 このコマンドは Name パラメーターを使用してサービスのサービス名を指定しますが、パラメーター名は省略可能であるため、パラメーター名は省略されます。

例 2: 中断されているすべてのサービスを再開する

PS C:\> Get-Service | Where-Object {$_.Status -eq "Paused"} | Resume-Service

このコマンドは、コンピューター上のすべての中断されたサービスを再開します。 コマンドレット コマンドは Get-Service 、コンピューター上のすべてのサービスを取得します。 パイプライン 演算子 (|) は結果をコマンドレットにWhere-Object渡し、Status プロパティが Paused のサービスを選択します。 次のパイプライン 演算子は、一時停止されたサービスを Resume-Service再開する結果を送信します。

実際には、WhatIf パラメーターを使用して、コマンドを実行する前に効果を判断します。

パラメーター

-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

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

入力

ServiceController

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

String

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

出力

None

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

ServiceController

PassThru パラメーターを使用すると、再開されたサービスを表す ServiceController オブジェクトが返されます。

メモ

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

  • 中断されたサービスの状態は一時停止されています。 サービスが再開されると、サービスの状態は [実行中] になります。
  • Resume-Service は、現在のユーザーがこれを行うアクセス許可を持っている場合にのみ、サービスを制御できます。 コマンドが正常に機能しない場合は、必要なアクセス許可が与えられていない可能性があります。
  • サービス名を検索し、システム上のサービスの名前を表示するには、「.」と入力します Get-Service。 サービス名は [名前] 列に表示され、表示名は DisplayName 列に表示されます。