Menyiapkan Klien Pull menggunakan ID Konfigurasi di PowerShell 5.0 dan yang lebih baru
Berlaku Untuk: Windows PowerShell 5.0
Penting
Pull Server (Windows Feature DSC-Service) adalah komponen Windows Server yang didukung namun tidak ada rencana untuk menawarkan fitur atau kemampuan baru. kami ingin Anda tahu bahwa versi DSC yang lebih baru sekarang tersedia secara umum, dikelola oleh fitur Azure Policy konfigurasi tamu bernama. Layanan konfigurasi tamu menggabungkan fitur Ekstensi DSC, Konfigurasi Status Azure Automation, dan fitur yang paling sering diminta dari umpan balik pelanggan. Konfigurasi tamu juga mencakup dukungan komputer hibrid melalui server berkemampuan Arc.
Sebelum menyiapkan klien penarikan, Anda harus menyiapkan server penarikan. Meskipun pesanan ini tidak diperlukan, ini membantu pemecahan masalah, dan membantu Anda memastikan bahwa pendaftaran berhasil. Untuk menyiapkan server penarikan, Anda bisa menggunakan panduan berikut:
Setiap simpul target dapat dikonfigurasi untuk mengunduh konfigurasi, sumber daya, dan bahkan melaporkan statusnya. Bagian di bawah ini menunjukkan kepada Anda cara mengonfigurasi klien penarikan dengan berbagi SMB atau HTTP DSC Pull Server. Ketika LCM Simpul di-refresh, ia akan menjangkau lokasi yang dikonfigurasi untuk mengunduh konfigurasi yang ditetapkan. Jika sumber daya yang diperlukan tidak ada di Node, sumber daya tersebut akan secara otomatis mengunduhnya dari lokasi yang dikonfigurasi. Jika Simpul dikonfigurasi dengan Server Laporan, simpul kemudian akan melaporkan status operasi.
Catatan
Topik ini berlaku untuk PowerShell 5.0. Untuk informasi tentang menyiapkan klien penarikan di PowerShell 4.0, lihat Menyiapkan klien penarikan menggunakan ID konfigurasi di PowerShell 4.0
Mengonfigurasi LCM klien penarikan
Menjalankan salah satu contoh di bawah ini membuat folder output baru bernama PullClientConfigID dan menempatkan file MOF metakonfigurasi di sana. Dalam hal ini, file MOF metakonfigurasi akan diberi nama localhost.meta.mof.
Untuk menerapkan konfigurasi, panggil cmdlet Set-DscLocalConfigurationManager , dengan Jalur diatur ke lokasi file MOF metakonfigurasi. Contohnya:
Set-DSCLocalConfigurationManager –ComputerName localhost –Path .\PullClientConfigId –Verbose.
ID Konfigurasi
Contoh di bawah ini mengatur properti ConfigurationID dari LCM ke Guid yang sebelumnya dibuat untuk tujuan ini. ConfigurationID adalah apa yang digunakan LCM untuk menemukan konfigurasi yang sesuai di server penarikan. File MOF konfigurasi pada server penarikan harus diberi nama ConfigurationID.mof, di mana ConfigurationID adalah nilai properti ConfigurationID dari LCM simpul target. Untuk informasi selengkapnya, lihat Menerbitkan Konfigurasi ke Server Penarikan (v4/v5).
Anda dapat membuat Guid acak menggunakan contoh di bawah ini, atau dengan menggunakan cmdlet New-Guid .
[System.Guid]::NewGuid()
Untuk informasi selengkapnya tentang menggunakan Guid di lingkungan Anda, lihat Merencanakan Guid.
Menyiapkan Klien Pull untuk mengunduh Konfigurasi
Setiap klien harus dikonfigurasi dalam mode Pull dan diberikan url server penarikan tempat konfigurasinya disimpan. Untuk melakukan ini, Anda harus mengonfigurasi Configuration Manager Lokal (LCM) dengan informasi yang diperlukan. Untuk mengonfigurasi LCM, Anda membuat jenis konfigurasi khusus, dihiasi dengan atribut DSCLocalConfigurationManager . Untuk informasi selengkapnya tentang mengonfigurasi LCM, lihat Mengonfigurasi Configuration Manager Lokal.
Server Penarikan HTTP DSC
Skrip berikut mengonfigurasi LCM untuk menarik konfigurasi dari server bernama "CONTOSO-PullSrv".
[DSCLocalConfigurationManager()]
configuration PullClientConfigID
{
Node localhost
{
Settings
{
RefreshMode = 'Pull'
ConfigurationID = '1d545e3b-60c3-47a0-bf65-5afc05182fd0'
RefreshFrequencyMins = 30
RebootNodeIfNeeded = $true
}
ConfigurationRepositoryWeb CONTOSO-PullSrv
{
ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'
}
}
}
PullClientConfigID
Dalam skrip, blok ConfigurationRepositoryWeb menentukan server penarikan. ServerUrl menentukan url Penarikan DSC
Berbagi SMB
Skrip berikut mengonfigurasi LCM untuk menarik konfigurasi dari Berbagi \\SMBPullServer\PullSMB .
[DSCLocalConfigurationManager()]
configuration PullClientConfigID
{
Node localhost
{
Settings
{
RefreshMode = 'Pull'
ConfigurationID = '1d545e3b-60c3-47a0-bf65-5afc05182fd0'
RefreshFrequencyMins = 30
RebootNodeIfNeeded = $true
}
ConfigurationRepositoryShare SMBPullServer
{
SourcePath = '\\SMBPullServer\Pull'
}
}
}
PullClientConfigID
Dalam skrip, blok ConfigurationRepositoryShare mendefinisikan server penarikan, yang dalam hal ini, hanyalah berbagi SMB.
Menyiapkan Klien Pull untuk mengunduh Sumber Daya
Jika Anda hanya menentukan blok ConfigurationRepositoryWeb atau ConfigurationRepositoryShare dalam konfigurasi LCM Anda (seperti pada contoh sebelumnya), klien penarikan akan menarik sumber daya dari lokasi yang sama dengan mengambil konfigurasinya. Anda juga dapat menentukan lokasi terpisah untuk sumber daya. Untuk menentukan lokasi sumber daya sebagai server terpisah, gunakan blok ResourceRepositoryWeb . Untuk menentukan lokasi sumber daya sebagai berbagi SMB, gunakan blok ResourceRepositoryShare .
Catatan
Anda dapat menggabungkan ConfigurationRepositoryWeb dengan ResourceRepositoryShare atau ConfigurationRepositoryShare dengan ResourceRepositoryWeb. Contohnya tidak ditunjukkan di bawah ini.
Server Penarikan HTTP DSC
Metakonfigurasi berikut mengonfigurasi klien penarikan untuk mendapatkan konfigurasinya dari CONTOSO-PullSrv dan sumber dayanya dari CONTOSO-ResourceSrv.
[DSCLocalConfigurationManager()]
configuration PullClientConfigID
{
Node localhost
{
Settings
{
RefreshMode = 'Pull'
ConfigurationID = '1d545e3b-60c3-47a0-bf65-5afc05182fd0'
RefreshFrequencyMins = 30
RebootNodeIfNeeded = $true
}
ConfigurationRepositoryWeb CONTOSO-PullSrv
{
ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'
}
ResourceRepositoryWeb CONTOSO-ResourceSrv
{
ServerURL = 'https://CONTOSO-REsourceSrv:8080/PSDSCPullServer.svc'
}
}
}
PullClientConfigID
Berbagi SMB
Contoh berikut menunjukkan metakonfigurasi yang menyiapkan klien untuk menarik konfigurasi dari berbagi \\SMBPullServer\ConfigurationsSMB , dan sumber daya dari berbagi \\SMBPullServer\ResourcesSMB .
[DSCLocalConfigurationManager()]
configuration PullClientConfigID
{
Node localhost
{
Settings
{
RefreshMode = 'Pull'
ConfigurationID = '1d545e3b-60c3-47a0-bf65-5afc05182fd0'
RefreshFrequencyMins = 30
RebootNodeIfNeeded = $true
}
ConfigurationRepositoryShare SMBPullServer
{
SourcePath = '\\SMBPullServer\Configurations'
}
ResourceRepositoryShare SMBResourceServer
{
SourcePath = '\\SMBPullServer\Resources'
}
}
}
PullClientConfigID
Mengunduh Sumber Daya secara otomatis dalam Mode Pendorongan
Dimulai di PowerShell 5.0, klien penarikan Anda dapat mengunduh modul dari berbagi SMB, bahkan ketika dikonfigurasi untuk mode Push . Ini sangat berguna dalam skenario di mana Anda tidak ingin menyiapkan Pull Server. Blok ResourceRepositoryShare dapat digunakan tanpa menentukan ConfigurationRepositoryShare. Contoh berikut menunjukkan metakonfigurasi yang menyiapkan klien untuk menarik sumber daya dari Berbagi \\SMBPullServer\ResourcesSMB . Ketika Node DIDORONG konfigurasi, node akan secara otomatis mengunduh sumber daya yang diperlukan, dari berbagi yang ditentukan.
[DSCLocalConfigurationManager()]
configuration PullClientConfigID
{
Node localhost
{
Settings
{
RefreshMode = 'Push'
ConfigurationID = '1d545e3b-60c3-47a0-bf65-5afc05182fd0'
}
ResourceRepositoryShare SMBResourceServer
{
SourcePath = '\\SMBPullServer\Resources'
}
}
}
PullClientConfigID
Menyiapkan Klien Penarikan untuk melaporkan status
Secara default, Simpul tidak akan mengirim laporan ke Pull Server yang dikonfigurasi. Anda dapat menggunakan satu server penarikan untuk konfigurasi, sumber daya, dan pelaporan, tetapi Anda harus membuat blok ReportRepositoryWeb untuk menyiapkan pelaporan.
Server Penarikan HTTP DSC
Contoh berikut menunjukkan metakonfigurasi yang menyiapkan klien untuk menarik konfigurasi dan sumber daya, dan mengirim data pelaporan, ke satu server penarikan.
[DSCLocalConfigurationManager()]
configuration PullClientConfigID
{
Node localhost
{
Settings
{
RefreshMode = 'Pull'
ConfigurationID = '1d545e3b-60c3-47a0-bf65-5afc05182fd0'
RefreshFrequencyMins = 30
RebootNodeIfNeeded = $true
}
ConfigurationRepositoryWeb CONTOSO-PullSrv
{
ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'
}
ReportServerWeb CONTOSO-PullSrv
{
ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'
}
}
}
PullClientConfigID
Untuk menentukan server laporan, Anda menggunakan blok ReportRepositoryWeb . Server laporan tidak dapat menjadi server SMB. Metakonfigurasi berikut mengonfigurasi klien penarikan untuk mendapatkan konfigurasinya dari CONTOSO-PullSrv dan sumber dayanya dari CONTOSO-ResourceSrv, dan untuk mengirim laporan status ke CONTOSO-ReportSrv:
[DSCLocalConfigurationManager()]
configuration PullClientConfigID
{
Node localhost
{
Settings
{
RefreshMode = 'Pull'
ConfigurationID = '1d545e3b-60c3-47a0-bf65-5afc05182fd0'
RefreshFrequencyMins = 30
RebootNodeIfNeeded = $true
}
ConfigurationRepositoryWeb CONTOSO-PullSrv
{
ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'
}
ResourceRepositoryWeb CONTOSO-ResourceSrv
{
ServerURL = 'https://CONTOSO-REsourceSrv:8080/PSDSCPullServer.svc'
}
ReportServerWeb CONTOSO-ReportSrv
{
ServerURL = 'https://CONTOSO-REsourceSrv:8080/PSDSCPullServer.svc'
}
}
}
PullClientConfigID
Berbagi SMB
Server laporan tidak dapat menjadi berbagi SMB.
Langkah berikutnya
Setelah klien penarikan dikonfigurasi, Anda dapat menggunakan panduan berikut untuk melakukan langkah-langkah berikutnya:
- Menerbitkan Konfigurasi ke Server Penarikan (v4/v5)
- Mengemas dan Mengunggah Sumber Daya ke Server Penarikan (v4)
