Sumber Daya Layanan DSC

Berlaku Untuk: Windows PowerShell 4.0, Windows PowerShell 5.x

Sumber daya Layanan di Windows PowerShell Desired State Configuration (DSC) menyediakan mekanisme untuk mengelola layanan pada simpul target.

Catatan

Dokumentasi sumber daya DSC ini mencakup versi yang disertakan dengan PowerShell sebelum versi 7.2. Modul PSDscResources berisi Sumber Daya DSC baru dan yang diperbarui yang secara resmi didukung oleh Microsoft. Modul PSDscResources tersedia dari Galeri PowerShell.

Untuk informasi selengkapnya dan dokumentasi yang diperbarui, lihat dokumentasi referensi PSDscResources.

Sintaks

Service [string] #ResourceName
{
    Name = [string]
    [ BuiltInAccount = [string] { LocalService | LocalSystem | NetworkService }  ]
    [ Credential = [PSCredential] ]
    [ StartupType = [string] { Automatic | Disabled | Manual }  ]
    [ State = [string] { Running | Stopped }  ]
    [ Dependencies = [string[]] ]
    [ Description = [string] ]
    [ DisplayName = [string] ]
    [ Path = [string] ]
    [ DependsOn = [string[]] ]
    [ Ensure = [string] { Absent | Present } ]
    [ PsDscRunAsCredential = [PSCredential] ]
}

Properti

Properti	Deskripsi
Nama	Menunjukkan nama layanan. Perhatikan bahwa terkadang ini berbeda dari nama tampilan. Anda bisa mendapatkan daftar layanan dan statusnya saat ini dengan Get-Service cmdlet .
BuiltInAccount	Menunjukkan akun masuk yang akan digunakan untuk layanan. Nilai yang diizinkan untuk properti ini adalah: LocalService, LocalSystem, dan NetworkService.
Kredensial	Menunjukkan kredensial untuk akun tempat layanan akan berjalan. Properti ini dan properti BuiltinAccount tidak dapat digunakan bersama-sama.
StartupType	Menunjukkan jenis startup untuk layanan. Nilai yang diizinkan untuk properti ini adalah: Otomatis, Dinonaktifkan, dan Manual.
Provinsi	Menunjukkan status yang ingin Anda pastikan untuk layanan. Nilainya adalah: Berjalan atau Dihentikan.
Dependensi	Array nama dependensi yang harus dimiliki layanan.
Deskripsi	Menunjukkan deskripsi layanan target.
DisplayName	Menunjukkan nama tampilan layanan target.
Jalur	Menunjukkan jalur ke file biner untuk layanan baru.

Properti umum

Properti	Deskripsi
DependsOn	Menunjukkan bahwa konfigurasi sumber daya lain harus berjalan sebelum sumber daya ini dikonfigurasi. Misalnya, jika ID blok skrip konfigurasi sumber daya yang ingin Anda jalankan terlebih dahulu adalah ResourceName dan jenisnya adalah ResourceType, sintaks untuk menggunakan properti ini adalah DependsOn = "[ResourceType]ResourceName".
Pastikan	Menunjukkan apakah layanan target ada pada sistem. Atur properti ini ke Tidak Ada untuk memastikan bahwa layanan target tidak ada. Mengaturnya ke Sajikan memastikan bahwa layanan target ada. Nilai defaultnya adalah Ada.
PsDscRunAsCredential	Mengatur kredensial untuk menjalankan seluruh sumber daya sebagai.

Catatan

Properti umum PsDscRunAsCredential ditambahkan dalam WMF 5.0 untuk memungkinkan menjalankan sumber daya DSC apa pun dalam konteks info masuk lainnya. Untuk informasi selengkapnya, lihat Menggunakan Kredensial dengan Sumber Daya DSC.

Contoh

configuration ServiceTest
{
    Import-DscResource -ModuleName PSDesiredStateConfiguration

    Node localhost
    {

        Service ServiceExample
        {
            Name        = "TermService"
            StartupType = "Manual"
            State       = "Running"
        }
    }
}