ServiceSet

發行項
05/05/2023

概要

使用一般設定管理多個服務。

語法

ServiceSet [String] #ResourceName
{
    [DependsOn = [String[]]]
    [PsDscRunAsCredential = [PSCredential]]
    Name = [String[]]
    [Ensure = [String]]
    [StartupType = [String]]
    [BuiltInAccount = [String]]
    [State = [String]]
    [Credential = [PSCredential]]
}

描述

ServiceSet 是複合資源，可讓您更輕鬆地一次使用共用但有限的組態來管理多個服務。此資源只能更新或移除現有的服務。它無法建立服務。如需服務組態的更多控制權，請參閱服務資源。

重要

複合資源不適用於 Invoke-DscResource 。此資源只能在定義內 Configuration 使用。

規格需求

無。

屬性

金鑰屬性

名稱

將服務的名稱指定為字串陣列。

這可能與服務的顯示名稱不同。若要擷取具有其名稱和目前狀態的所有服務清單，請使用 Get-Service Cmdlet。

Type: System.String[]
Behavior: Key

選擇性屬性

BuiltInAccount

指定要執行服務的電腦帳戶名稱。帳戶必須能夠存取每個服務的可執行檔，才能啟動服務。

請勿使用 Credential 屬性指定這個屬性。

Type: System.String
Accepted Values:
  - LocalService
  - LocalSystem
  - NetworkService
Default Value: Null

認證

指定要執行服務之帳戶的認證。帳戶必須能夠存取每個服務的可執行檔，才能啟動該服務。資源會自動授與此帳戶「以服務登入」許可權。

請勿使用 BuiltInAccount 屬性指定此屬性。

Type: System.Management.Automation.PSCredential
Default Value: None

Ensure

指定服務是否應該存在。若要新增或更新服務，請將此屬性設定為 Present 。若要移除服務，請將此屬性設定為 Absent 。

預設值是 Present。

Type: System.String
Accepted Values:
  - Absent
  - Present
Default Value: Present

StartupType

指定服務在系統啟動上的行為。此值必須是下列其中之一：

Automatic - 服務會在系統啟動時由作業系統啟動。如果自動啟動的服務取決於手動啟動的服務，則手動啟動的服務也會在系統啟動時自動啟動。
Disabled - 服務已停用，且無法由使用者或應用程式啟動。
Manual - 服務只會由使用者使用服務控制管理員或應用程式手動啟動。

如果服務不存在，則預設值為 Automatic 。

Type: System.String
Behavior: Write
Accepted Values:
  - Automatic
  - Disabled
  - Manual
Default Value: None

State

指定服務是否應該執行。此值必須是下列其中之一：

Running - 如果資源尚未啟動，資源就會啟動服務。
Stopped - 如果資源正在執行，資源就會停止服務。
Ignore - 資源不會啟動或停止服務。

預設值是 Running。

Type: System.String
Accepted Values:
  - Running
  - Stopped
  - Ignore
Default Value: Running

共用方式為