Menyiapkan Pull Client menggunakan Nama 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 bernama konfigurasi tamu. Layanan konfigurasi tamu menggabungkan fitur Ekstensi DSC, Konfigurasi Status Azure Automation, dan fitur yang paling umum diminta dari umpan balik pelanggan. Konfigurasi tamu juga mencakup dukungan mesin hibrid melalui server yang mendukung Arc.

Sebelum menyiapkan klien pull, Anda harus menyiapkan server pull. Meskipun pesanan ini tidak diperlukan, ini membantu pemecahan masalah, dan membantu Anda memastikan bahwa pendaftaran berhasil. Untuk menyiapkan server tarik, Anda dapat menggunakan panduan berikut:

Setiap simpul target dapat dikonfigurasi untuk mengunduh konfigurasi, sumber daya, dan bahkan melaporkan statusnya. Bagian di bawah ini menunjukkan cara mengonfigurasi klien tarik dengan berbagi SMB atau HTTP DSC Pull Server. Saat KPK Node disegarkan, itu akan menjangkau lokasi yang dikonfigurasi untuk mengunduh konfigurasi yang ditetapkan. Jika ada sumber daya yang diperlukan tidak ada di Node, itu akan secara otomatis mengunduhnya dari lokasi yang dikonfigurasi. Jika Node dikonfigurasi dengan Server Laporan, itu kemudian akan melaporkan status operasi.

Nota

Topik ini berlaku untuk PowerShell 5.0. Untuk informasi tentang menyiapkan klien pull di PowerShell 4.0, lihat Menyiapkan klien pull menggunakan ID konfigurasi di PowerShell 4.0.

Mengonfigurasi LCM klien tarik

Menjalankan salah satu contoh di bawah ini akan membuat folder output baru bernama PullClientConfigName 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 Path diatur ke lokasi file MOF metakonfigurasi. Contohnya:

Set-DSCLocalConfigurationManager –ComputerName localhost –Path .\PullClientConfigName –Verbose.

Nama Konfigurasi

Contoh di bawah ini mengatur properti ConfigurationName LCM ke nama Konfigurasi yang dikompilasi sebelumnya, yang dibuat untuk tujuan ini. ConfigurationName adalah apa yang digunakan LCM untuk menemukan konfigurasi yang sesuai pada server tarik. File MOF konfigurasi pada server tarik harus diberi nama <ConfigurationName>.mof, dalam hal ini, "ClientConfig.mof". Untuk informasi selengkapnya, lihat Menerbitkan Konfigurasi ke Server Tarik (v4/v5).

Menyiapkan Pull Client untuk mengunduh Konfigurasi

Setiap klien harus dikonfigurasi dalam mode Pull dan diberikan url server tarik tempat konfigurasinya disimpan. Untuk melakukan ini, Anda harus mengonfigurasi Local Configuration Manager (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 Manajer Konfigurasi Lokal.

Skrip berikut mengonfigurasi LCM untuk menarik konfigurasi dari server bernama "CONTOSO-PullSrv".

  • Dalam skrip, blok ConfigurationRepositoryWeb mendefinisikan server pull. Properti ServerURL menentukan titik akhir untuk server tarik.

  • Properti RegistrationKey adalah kunci bersama antara semua simpul klien untuk server tarik dan server tarik tersebut. Nilai yang sama disimpan dalam file di server tarik.

    Nota

    Kunci pendaftaran hanya berfungsi dengan server tarik web . Anda masih harus menggunakan ConfigurationID dengan server pull SMB . > Untuk informasi tentang mengonfigurasi server pull dengan menggunakan ConfigurationID, lihat Menyiapkan klien pull menggunakan ID konfigurasi

  • Properti ConfigurationNames adalah array yang menentukan nama konfigurasi yang ditujukan untuk simpul klien. > Nota: Jika Anda menentukan lebih dari satu nilai dalam ConfigurationNames, Anda juga harus menentukan blok PartialConfiguration dalam konfigurasi Anda. >Untuk informasi tentang konfigurasi parsial, lihat Konfigurasi Status yang Diinginkan PowerShell konfigurasi parsial.

[DSCLocalConfigurationManager()]
configuration PullClientConfigNames
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Pull'
            RefreshFrequencyMins = 30
            RebootNodeIfNeeded = $true
        }
        ConfigurationRepositoryWeb CONTOSO-PullSrv
        {
            ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'
            RegistrationKey = '140a952b-b9d6-406b-b416-e0f759c9c0e4'
            ConfigurationNames = @('ClientConfig')
        }
    }
}
PullClientConfigNames

Menyiapkan Pull Client untuk mengunduh Sumber Daya

Jika Anda hanya menentukan blok ConfigurationRepositoryWeb atau ConfigurationRepositoryShare dalam konfigurasi LCM Anda (seperti pada contoh sebelumnya), klien pull akan menarik sumber daya dari lokasi yang sama tempat file ".mof" Anda disimpan. Anda juga dapat menentukan lokasi yang berbeda tempat klien dapat mengunduh sumber daya. Untuk menentukan server sumber daya, Anda menggunakan blok ResourceRepositoryWeb (untuk server tarik web) atau blok ResourceRepositoryShare (untuk server tarik SMB).

Contoh berikut menunjukkan metakonfigurasi yang menyiapkan klien untuk mengunduh konfigurasi dari Server Tarik, dan sumber daya dari berbagi SMB.

[DSCLocalConfigurationManager()]
configuration PullClientConfigNames
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Pull'
            RefreshFrequencyMins = 30
            RebootNodeIfNeeded = $true
        }

        ConfigurationRepositoryWeb CONTOSO-PullSrv
        {
            ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'
            RegistrationKey = 'fbc6ef09-ad98-4aad-a062-92b0e0327562'
        }

        ResourceRepositoryShare SMBResources
        {
            SourcePath = '\\SMBPullServer\Resources'
        }
    }
}
PullClientConfigNames

Menyiapkan Pull Client untuk melaporkan status

Anda dapat menggunakan server tarik tunggal untuk konfigurasi, sumber daya, dan pelaporan. Pelaporan tidak dikonfigurasi untuk klien secara default. Untuk mengonfigurasi klien untuk melaporkan status, Anda harus membuat blok ReportRepositoryWeb . Contoh berikut menunjukkan metakonfigurasi yang menyiapkan klien untuk menarik konfigurasi dan sumber daya, dan mengirim data pelaporan, ke satu server tarik.

Nota

Server laporan tidak boleh berupa berbagi SMB.

[DSCLocalConfigurationManager()]
configuration PullClientConfigNames
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Pull'
            RefreshFrequencyMins = 30
            RebootNodeIfNeeded = $true
        }

        ConfigurationRepositoryWeb CONTOSO-PullSrv
        {
            ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'
            RegistrationKey = 'fbc6ef09-ad98-4aad-a062-92b0e0327562'
        }

        ReportServerWeb CONTOSO-PullSrv
        {
            ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'
            RegistrationKey = 'fbc6ef09-ad98-4aad-a062-92b0e0327562'
        }
    }
}
PullClientConfigNames

Lihat Juga