Menyiapkan Klien Pull 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 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 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 Jalur diatur ke lokasi file MOF metakonfigurasi. Contohnya:

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

Nama konfigurasi

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

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.

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

  • Dalam skrip, blok ConfigurationRepositoryWeb menentukan server penarikan. Properti ServerURL menentukan titik akhir untuk server penarikan.

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

    Catatan

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

  • Properti ConfigurationNames adalah array yang menentukan nama konfigurasi yang ditujukan untuk simpul klien. >Catatan: Jika Anda menentukan lebih dari satu nilai di 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 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 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 ResourceRepositoryWeb (untuk server penarikan web) atau blok ResourceRepositoryShare (untuk server penarikan SMB).

Contoh berikut menunjukkan metakonfigurasi yang menyiapkan klien untuk mengunduh konfigurasi dari Pull Server, 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 Klien Penarikan untuk melaporkan status

Anda dapat menggunakan satu server penarikan 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 penarikan.

Catatan

Server laporan tidak dapat menjadi 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