Set-Service
サービスを開始、停止、中断し、そのプロパティを変更します。
構文
Name (既定)
Set-Service
[-Name] <String>
[-ComputerName <String[]>]
[-DisplayName <String>]
[-Description <String>]
[-StartupType <ServiceStartMode>]
[-Status <String>]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
InputObject
Set-Service
[-ComputerName <String[]>]
[-DisplayName <String>]
[-Description <String>]
[-StartupType <ServiceStartMode>]
[-Status <String>]
[-InputObject <ServiceController>]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Set-Service コマンドレットは、Status、Description、DisplayName 、StartupTypeなどのサービスのプロパティ変更します。
Set-Service は、サービスを開始、停止、中断、または一時停止できます。 サービスを識別するには、サービス名を入力するか、サービス オブジェクトを送信します。 または、サービス名またはサービス オブジェクトをパイプラインの下に送信して Set-Serviceします。
例
例 1: 表示名を変更する
この例では、サービスの表示名が変更されています。 元の表示名を表示するには、Get-Serviceを使用します。
Set-Service -Name LanmanWorkstation -DisplayName "LanMan Workstation"
Set-Service では、Name パラメーターを使用して、サービスの名前 (LanmanWorkstation ) を指定します。
DisplayName パラメーターは、LanMan Workstation 新しい表示名を指定します。
例 2: サービスのスタートアップの種類を変更する
この例では、サービスのスタートアップの種類を変更する方法を示します。
Set-Service -Name BITS -StartupType Automatic
Get-Service BITS | Select-Object -Property Name, StartType, Status
Name StartType Status
---- --------- ------
BITS Automatic Running
Set-Service は、Name パラメーターを使用して、サービス名、BITSを指定します。
StartupType パラメーターは、サービスを 自動に設定します。
Get-Service は、Name パラメーターを使用して、BITS サービスを指定し、パイプラインにオブジェクトを送信します。
Select-Object は、Property パラメーターを使用して、BITS サービスの状態を表示します。
例 3: サービスの説明を変更する
次の使用例は、BITS サービスの説明を変更し、結果を表示します。
Get-CimInstance コマンドレットは、サービスの Descriptionを含む Win32_Service オブジェクトを返すので使用されます。
Get-CimInstance Win32_Service -Filter 'Name = "BITS"' | Format-List Name, Description
Name : BITS
Description : Transfers files in the background using idle network bandwidth. If the service is
disabled, then any applications that depend on BITS, such as Windows Update or MSN
Explorer, will be unable to automatically download programs and other information.
Set-Service -Name BITS -Description "Transfers files in the background using idle network bandwidth."
Get-CimInstance Win32_Service -Filter 'Name = "BITS"' | Format-List Name, Description
Name : BITS
Description : Transfers files in the background using idle network bandwidth.
Get-CimInstance はオブジェクトをパイプラインに沿って Format-List に送り、サービスの名前と説明を表示します。 比較のために、コマンドは説明が更新される前と後に実行されます。
Set-Service では、Name パラメーターを使用して、BITS サービスを指定します。
Description パラメーターは、サービスの説明の更新されたテキストを指定します。
例 4: サービスを開始する
この例では、サービスが開始されます。
Set-Service -Name WinRM -Status Running -PassThru
Status Name DisplayName
------ ---- -----------
Running WinRM Windows Remote Management (WS-Manag...
Set-Service は、Name パラメーターを使用して、サービス、WinRMを指定します。
Status パラメーターは、値 Running を使用してサービスを開始します。
PassThru パラメーターは、結果を表示する ServiceController オブジェクトを出力します。
例 5: サービスを中断する
この例では、パイプラインを使用してサービスを一時停止します。
Get-Service -Name Schedule | Set-Service -Status Paused
Get-Service では、Name パラメーターを使用して、Schedule サービスを指定し、パイプラインにオブジェクトを送信します。
Set-Service は、Status パラメーターを使用して、サービスを Pausedに設定します。
例 6: サービスを停止する
この例では、変数を使用してサービスを停止します。
$S = Get-Service -Name Schedule
Set-Service -InputObject $S -Status Stopped
Get-Service は、Name パラメーターを使用して、サービス、Scheduleを指定します。 オブジェクトは変数 $Sに格納されます。
Set-Service は、InputObject パラメーターを使用し、$S格納されているオブジェクトを指定します。
Status パラメーターは、サービスを停止に設定します。
例 7: 複数のサービスのスタートアップの種類を設定する
Set-Service コマンドレットは、一度に 1 つのサービス名のみを受け入れます。 ただし、Set-Service を用いて複数のサービスをパイプ処理することで、複数のサービスの構成を変更することができます。
Get-Service SQLWriter,spooler |
Set-Service -StartupType Automatic -PassThru |
Select-Object Name, StartType
Name StartType
---- ---------
spooler Automatic
SQLWriter Automatic
パラメーター
-ComputerName
1 台以上のコンピューターを指定します。 リモート コンピューターの場合は、NetBIOS 名、IP アドレス、または完全修飾ドメイン名を入力します。 ComputerName パラメーターが指定されていない場合、コマンドはローカル コンピューターで実行されます。
このパラメーターは、PowerShell リモート処理には依存しません。 コンピューターがリモート コマンドを実行するように構成されていない場合でも、ComputerName パラメーターを使用できます。
パラメーターのプロパティ
| 型: | String[] |
| 規定値: | Local computer |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | cn |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Confirm
Set-Serviceを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Description
サービスの新しい説明を指定します。
サービスの説明は、コンピューター管理、サービスに表示されます。
Description は、Get-ServiceServiceController オブジェクトのプロパティではありません。 サービスの説明を表示するには、サービスを表す Get-CimInstance オブジェクトを返す を使用します。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DisplayName
サービスの新しい表示名を指定します。
注
通常、Set-Service は Windows サービスでのみ動作し、ドライバーでは動作しません。 ただし、ドライバーの名前を指定した場合、Set-Service はドライバーを対象にすることができます。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | DN |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-InputObject
変更するサービスを表す ServiceController オブジェクトを指定します。 オブジェクトを含む変数を入力するか、オブジェクトを取得するコマンドまたは式 (Get-Service コマンドなど) を入力します。 パイプラインを使用して、サービス オブジェクトを Set-Serviceに送信できます。
パラメーターのプロパティ
| 型: | ServiceController |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
InputObject
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Name
変更するサービスのサービス名を指定します。 ワイルドカード文字は使用できません。 パイプラインを使用して、サービス名を Set-Serviceに送信できます。
注
通常、Set-Service は Windows サービスでのみ動作し、ドライバーでは動作しません。 ただし、ドライバーの名前を指定した場合、Set-Service はドライバーを対象にすることができます。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | サービス名, SN |
パラメーター セット
Name
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-PassThru
変更されたサービスを表す ServiceController オブジェクトを返します。 既定では、Set-Service は出力を生成しません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-StartupType
サービスのスタートアップの種類を設定します。 このパラメーターに使用できる値は次のとおりです。
- 自動 - サービスは、オペレーティング システムの起動時に開始されるか、オペレーティング システムによって開始されました。 自動開始サービスが手動で開始されたサービスに依存している場合、手動で開始されたサービスもシステムの起動時に自動的に開始されます。
- 無効 - サービスは無効になっており、ユーザーまたはアプリケーションが開始することはできません。
- 手動 - サービスの開始は、ユーザーによる手動操作、Service Control Manager、またはアプリケーションによってのみ行われます。
- ブート - サービスがシステム ローダーによって起動されたデバイス ドライバーであることを示します。 この値は、デバイス ドライバーに対してのみ有効です。
- システム - サービスが 'IOInitSystem()' 関数によって開始されたデバイス ドライバーであることを示します。 この値は、デバイス ドライバーに対してのみ有効です。
既定値は自動 です。
パラメーターのプロパティ
| 型: | ServiceStartMode |
| 規定値: | Automatic |
| 指定可能な値: | Boot, System, Automatic, Manual, Disabled |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | StartMode, SM, ST |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Status
サービスの状態を指定します。
このパラメーターに使用できる値は次のとおりです。
- Paused サービスを中断します。
- Running サービスを開始します。
- Stopped サービスを停止します。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| 指定可能な値: | Paused, Running, Stopped |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WhatIf
Set-Service が実行された場合の動作を示します。 コマンドレットは実行されません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ウィスコンシン |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
入力
ServiceController
サービス オブジェクトをこのコマンドレットにパイプできます。
String
サービス名を含む文字列をこのコマンドレットにパイプできます。
出力
None
既定では、このコマンドレットは出力を返しません。
ServiceController
PassThru パラメーターを使用すると、このコマンドレットは serviceController オブジェクト 返します。
メモ
Set-Service には、昇格されたアクセス許可が必要です。
Run as administrator オプションを使用します。
Set-Service は、現在のユーザーがサービスを管理するアクセス許可を持っている場合にのみ、サービスを制御できます。 コマンドが正しく機能しない場合は、必要なアクセス許可がない可能性があります。
サービスのサービス名または表示名を検索するには、Get-Serviceを使用します。 サービス名は Name 列にあり、表示名は DisplayName 列にあります。
