ServiceSet
概要
使用一般設定管理多個服務。
語法
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
