Mengonfigurasi LCM di PowerShell 4.0

Berlaku Untuk: Windows PowerShell 4.0

Untuk informasi terkait Windows PowerShell 5.0 dan yang lebih baru, lihat Mengonfigurasi Configuration Manager Lokal.

Configuration Manager lokal adalah mesin Windows PowerShell Desired State Configuration (DSC). Ini berjalan pada semua simpul target, dan bertanggung jawab untuk memanggil sumber daya konfigurasi yang disertakan dalam skrip konfigurasi DSC. Topik ini mencantumkan properti Configuration Manager Lokal dan menjelaskan cara mengubah pengaturan Configuration Manager Lokal pada simpul target.

Properti Configuration Manager lokal

Berikut ini mencantumkan properti Configuration Manager lokal yang bisa Anda atur atau ambil.

• AllowModuleOverwrite: Mengontrol apakah konfigurasi baru yang diunduh dari layanan konfigurasi diizinkan untuk menimpa yang lama pada simpul target. Nilai yang mungkin adalah True dan False.
• CertificateID: Thumbprint sertifikat yang digunakan untuk mengamankan kredensial yang diteruskan dalam konfigurasi. Untuk informasi selengkapnya lihat Ingin mengamankan kredensial di Windows PowerShell Desired State Configuration?.
• ConfigurationID: Menunjukkan GUID yang digunakan untuk mendapatkan file konfigurasi tertentu dari layanan penarikan. GUID memastikan bahwa file konfigurasi yang benar diakses.
• ConfigurationMode: Menentukan bagaimana Configuration Manager Lokal benar-benar menerapkan konfigurasi ke simpul target. Ini bisa mengambil nilai berikut:
  • ApplyOnly: Dengan opsi ini, DSC menerapkan konfigurasi dan tidak melakukan apa pun lebih lanjut kecuali konfigurasi baru terdeteksi, baik dengan Anda mengirim konfigurasi baru langsung ke simpul target atau jika Anda terhubung ke layanan penarikan dan DSC menemukan konfigurasi baru saat memeriksa dengan layanan penarikan. Jika konfigurasi simpul target menyimpang, tidak ada tindakan yang diambil.
  • ApplyAndMonitor: Dengan opsi ini (yang merupakan default), DSC menerapkan konfigurasi baru apa pun, baik yang dikirim oleh Anda langsung ke simpul target atau ditemukan pada layanan penarikan. Setelah itu, jika konfigurasi simpul target menyimpang dari file konfigurasi, DSC melaporkan perbedaan dalam log. Untuk informasi selengkapnya tentang pengelogan DSC, lihat Menggunakan Log Peristiwa untuk Mendiagnosis Kesalahan dalam Konfigurasi Status yang Diinginkan.
  • ApplyAndAutoCorrect: Dengan opsi ini, DSC menerapkan konfigurasi baru apa pun, baik yang dikirim oleh Anda langsung ke simpul target atau ditemukan di layanan penarikan. Setelah itu, jika konfigurasi simpul target menyimpang dari file konfigurasi, DSC melaporkan perbedaan dalam log, dan kemudian mencoba menyesuaikan konfigurasi simpul target untuk mematuhi file konfigurasi.
• ConfigurationModeFrequencyMins: Mewakili frekuensi (dalam menit) di mana aplikasi latar belakang DSC mencoba menerapkan konfigurasi saat ini pada simpul target. Nilai default-nya adalah 15. Nilai ini dapat diatur bersama dengan RefreshMode. Ketika RefreshMode diatur ke PULL, simpul target menghubungi layanan konfigurasi pada interval yang ditetapkan oleh RefreshFrequencyMins dan mengunduh konfigurasi saat ini. Terlepas dari nilai RefreshMode, pada interval yang ditetapkan oleh ConfigurationModeFrequencyMins, mesin konsistensi menerapkan konfigurasi terbaru yang diunduh ke simpul target. RefreshFrequencyMins harus diatur ke kelipatan bilangan bulat ConfigurationModeFrequencyMins.
• Kredensial: Menunjukkan kredensial (seperti halnya Get-Credential) yang diperlukan untuk mengakses sumber daya jarak jauh, seperti untuk menghubungi layanan konfigurasi.
• DownloadManagerCustomData: Mewakili array yang berisi data kustom khusus untuk manajer unduhan.
• DownloadManagerName: Menunjukkan nama konfigurasi dan pengelola pengunduhan modul.
• RebootNodeIfNeeded: Atur ini ke $true untuk memungkinkan sumber daya me-reboot Node menggunakan $global:DSCMachineStatus bendera . Jika tidak, Anda harus me-reboot simpul secara manual untuk konfigurasi apa pun yang memerlukannya. Nilai defaultnya adalah $false. Untuk menggunakan pengaturan ini ketika kondisi reboot diberlakukan oleh sesuatu selain DSC (seperti Pemasang Windows), gabungkan pengaturan ini dengan modul xPendingReboot .
• RefreshFrequencyMins: Digunakan saat Anda telah menyiapkan layanan penarikan. Mewakili frekuensi (dalam menit) di mana Configuration Manager Lokal menghubungi layanan penarikan untuk mengunduh konfigurasi saat ini. Nilai ini dapat diatur bersama dengan ConfigurationModeFrequencyMins. Ketika RefreshMode diatur ke PULL, simpul target menghubungi layanan penarikan pada interval yang ditetapkan oleh RefreshFrequencyMins dan mengunduh konfigurasi saat ini. Pada interval yang ditetapkan oleh ConfigurationModeFrequencyMins, mesin konsistensi kemudian menerapkan konfigurasi terbaru yang diunduh ke simpul target. Jika RefreshFrequencyMins tidak diatur ke kelipatan bilangan bulat ConfigurationModeFrequencyMins, sistem akan membulatkannya. Nilai default adalah 30.
• RefreshMode: Nilai yang mungkin adalah Push (default) dan Pull. Dalam konfigurasi "dorong", Anda harus menempatkan file konfigurasi pada setiap simpul target, menggunakan komputer klien apa pun. Dalam mode "tarik", Anda harus menyiapkan layanan penarikan untuk Configuration Manager Lokal untuk menghubungi dan mengakses file konfigurasi.

Catatan

LCM memulai siklus ConfigurationModeFrequencyMins berdasarkan:

• Metaconfig baru diterapkan menggunakan Set-DscLocalConfigurationManager
• Menghidupkan ulang komputer

Untuk kondisi apa pun di mana proses timer mengalami crash, yang akan terdeteksi dalam waktu 30 detik dan siklus akan dimulai ulang. Operasi bersamaan dapat menunda siklus dimulai, jika durasi operasi ini melebihi frekuensi siklus yang dikonfigurasi, timer berikutnya tidak akan dimulai.

Misalnya, metaconfig dikonfigurasi pada frekuensi penarikan 15 menit dan penarikan terjadi pada T1. Simpul tidak selesai bekerja selama 16 menit. Siklus 15 menit pertama diabaikan, dan penarikan berikutnya akan terjadi pada T1+15+15.

Contoh memperbarui pengaturan Configuration Manager Lokal

Anda dapat memperbarui pengaturan Configuration Manager Lokal dari simpul target dengan menyertakan blok LocalConfigurationManager di dalam blok simpul dalam skrip konfigurasi, seperti yang ditunjukkan dalam contoh berikut.

Configuration ExampleConfig
{
    Node "Server001"
    {
        LocalConfigurationManager
        {
            ConfigurationID = "646e48cb-3082-4a12-9fd9-f71b9a562d4e"
            ConfigurationModeFrequencyMins = 45
            ConfigurationMode = "ApplyAndAutocorrect"
            RefreshMode = "Pull"
            RefreshFrequencyMins = 90
            DownloadManagerName = "WebDownloadManager"
            DownloadManagerCustomData = (@{ServerUrl="https://$PullService/psdscpullserver.svc"})
            CertificateID = "71AA68562316FE3F73536F1096B85D66289ED60E"
            Credential = $cred
            RebootNodeIfNeeded = $true
            AllowModuleOverwrite = $false
        }
# One or more resource blocks can be added here
    }
}

# The following line invokes the configuration and creates a file called
# Server001.meta.mof at the specified path
ExampleConfig -OutputPath "c:\users\public\dsc"

Menjalankan skrip dalam contoh sebelumnya menghasilkan file MOF yang menentukan dan menyimpan pengaturan yang diinginkan. Untuk menerapkan pengaturan, Anda dapat menggunakan cmdlet Set-DscLocalConfigurationManager , seperti yang ditunjukkan dalam contoh berikut.

Set-DscLocalConfigurationManager -Path "c:\users\public\dsc"

Catatan

Untuk parameter Jalur , Anda harus menentukan jalur yang sama dengan yang Anda tentukan untuk parameter OutputPath saat Anda memanggil konfigurasi dalam contoh sebelumnya.

Untuk melihat pengaturan Configuration Manager Lokal saat ini, Anda dapat menggunakan cmdlet Get-DscLocalConfigurationManager. Jika Anda memanggil cmdlet ini tanpa parameter, secara default cmdlet ini akan mendapatkan pengaturan Configuration Manager Lokal untuk simpul tempat Anda menjalankannya. Untuk menentukan simpul lain, gunakan parameter CimSession dengan cmdlet ini.