Sumber Daya ServiceSet DSC
Berlaku Untuk: Windows PowerShell 4.0, Windows PowerShell 5.x
Sumber daya ServiceSet di Windows PowerShell Desired State Configuration (DSC) menyediakan mekanisme untuk mengelola layanan pada simpul target. Sumber daya ini adalah sumber daya komposit yang memanggil sumber daya Layanan untuk setiap layanan yang ditentukan dalam properti Nama .
Gunakan sumber daya ini saat Anda ingin mengonfigurasi sejumlah layanan ke status yang sama.
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
ServiceSet [string] #ResourceName
{
Name = [string[]]
[ StartupType = [string] { Automatic | Disabled | Manual } ]
[ BuiltInAccount = [string] { LocalService | LocalSystem | NetworkService } ]
[ State = [string] { Running | Stopped } ]
[ Credential = [PSCredential] ]
[ 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 . |
StartupType | Menunjukkan jenis startup untuk layanan. Nilai yang diizinkan untuk properti ini adalah: Otomatis, Dinonaktifkan, dan Manual. |
BuiltInAccount | Menunjukkan akun masuk yang akan digunakan untuk layanan. Nilai yang diizinkan untuk properti ini adalah: LocalService, LocalSystem, dan NetworkService. |
Provinsi | Menunjukkan status yang ingin Anda pastikan untuk layanan: Dihentikan atau Berjalan. |
Kredensial | Menunjukkan kredensial untuk akun tempat sumber daya layanan akan berjalan. Properti ini dan properti BuiltinAccount tidak dapat digunakan bersama-sama. |
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 ada pada sistem. Atur properti ini ke Tidak Ada untuk memastikan bahwa layanan 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
Konfigurasi berikut memulai layanan "Windows Audio" dan "Layanan Desktop Jarak Jauh".
configuration ServiceSetTest
{
Import-DscResource -ModuleName PSDesiredStateConfiguration
Node localhost
{
ServiceSet ServiceSetExample
{
Name = @("TermService", "Audiosrv")
StartupType = "Manual"
State = "Running"
}
}
}
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk