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

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

ID Konfigurasi

Contoh di bawah ini mengatur properti ConfigurationID LCM ke Guid yang sebelumnya telah dibuat untuk tujuan ini. ConfigurationID adalah apa yang digunakan LCM untuk menemukan konfigurasi yang sesuai pada server pull. File MOF konfigurasi pada server tarik harus diberi nama ConfigurationID.mof, di mana ConfigurationID adalah nilai properti ConfigurationID dari KPK simpul target. Untuk informasi selengkapnya, lihat Menerbitkan Konfigurasi ke Server Tarik (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 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.

Server Tarik 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 mendefinisikan server pull. ServerUrl menentukan url DSC Pull

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 tarik, yang dalam hal ini, hanyalah berbagi SMB.

Menyiapkan Pull Client untuk mengunduh Sumber Daya

Jika Anda hanya menentukan blok ConfigurationRepositoryWeb atau ConfigurationRepositoryShare dalam konfigurasi LCM Anda (seperti pada contoh sebelumnya), klien tarik akan menarik sumber daya dari lokasi yang sama dengan yang diambil 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 .

Nota

Anda dapat menggabungkan ConfigurationRepositoryWeb dengan ResourceRepositoryShare atau ConfigurationRepositoryShare dengan ResourceRepositoryWeb. Contohnya tidak ditunjukkan di bawah ini.

Server Tarik HTTP DSC

Metakonfigurasi berikut mengonfigurasi klien tarik 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

Contoh berikut menunjukkan metakonfigurasi yang menyiapkan klien untuk menarik konfigurasi dari berbagi SMB , dan sumber daya dari berbagi \\SMBPullServer\Configurations\\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

Unduh Sumber Daya secara otomatis dalam Mode Push

Dimulai di PowerShell 5.0, klien tarik Anda dapat mengunduh modul dari berbagi SMB, bahkan saat dikonfigurasi untuk mode Push . Ini sangat berguna dalam skenario di mana Anda tidak ingin menyiapkan Server Tarik. Blok ResourceRepositoryShare dapat digunakan tanpa menentukan ConfigurationRepositoryShare. Contoh berikut menunjukkan metakonfigurasi yang menyiapkan klien untuk menarik sumber daya dari Berbagi \\SMBPullServer\ResourcesSMB . Ketika Node PUSH konfigurasi, itu 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 Pull Client untuk melaporkan status

Secara default, Node tidak akan mengirim laporan ke Pull Server yang dikonfigurasi. Anda dapat menggunakan server pull tunggal untuk konfigurasi, sumber daya, dan pelaporan, tetapi Anda harus membuat blok ReportRepositoryWeb untuk menyiapkan pelaporan.

Server Tarik HTTP DSC

Contoh berikut menunjukkan metakonfigurasi yang menyiapkan klien untuk menarik konfigurasi dan sumber daya, dan mengirim data pelaporan, ke satu server tarik.

[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 boleh berupa server SMB. Metakonfigurasi berikut mengonfigurasi klien pull 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

Server laporan tidak boleh berupa berbagi SMB.

Langkah Selanjutnya

Setelah klien tarik dikonfigurasi, Anda dapat menggunakan panduan berikut untuk melakukan langkah berikutnya:

Lihat Juga

Menyiapkan klien tarik dengan nama konfigurasi

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2025-10-23

Menyiapkan Klien Tarik menggunakan ID Konfigurasi di PowerShell 5.0 dan yang lebih baru

Mengonfigurasi LCM klien tarik

ID Konfigurasi

Menyiapkan Pull Client untuk mengunduh Konfigurasi

Server Tarik HTTP DSC

Berbagi UKM

Menyiapkan Pull Client untuk mengunduh Sumber Daya

Server Tarik HTTP DSC

Berbagi UKM

Unduh Sumber Daya secara otomatis dalam Mode Push

Menyiapkan Pull Client untuk melaporkan status

Server Tarik HTTP DSC

Berbagi UKM

Langkah Selanjutnya

Lihat Juga

Saran dan Komentar

Sumber Daya Tambahan: