PowerShell 5.0 ve sonraki sürümlerde Yapılandırma Adlarını kullanarak bir Çekme İstemcisi ayarlayın

Uygulama Alanı: Windows PowerShell 5.0

Önemli

Çekme Sunucusu (Windows Özelliği DSC-Hizmeti), Windows Server'ın desteklenen bir bileşenidir, ancak yeni özellikler veya yetenekler sunma planı yoktur. DSC'nin daha yeni bir sürümünün genel kullanıma sunulduğunu ve Azure İlkesi'nin konuk yapılandırması adlı bir özelliği tarafından yönetildiğini bilmenizi isteriz. Konuk yapılandırma hizmeti, DSC Uzantısı, Azure Otomasyonu State Configuration ve müşteri geri bildirimlerinden en sık istenen özellikleri birleştirir. Konuk yapılandırması, Arc özellikli sunucular aracılığıyla hibrit makine desteğini de içerir.

Bir çekme istemcisi ayarlamadan önce, bir çekme sunucusu ayarlamanız gerekir. Bu sipariş gerekli olmasa da, sorun gidermeye yardımcı olur ve kaydın başarılı olduğundan emin olmanıza yardımcı olur. Bir çekme sunucusu ayarlamak için aşağıdaki kılavuzları kullanabilirsiniz:

Her hedef düğüm, yapılandırmaları, kaynakları indirmek ve hatta durumunu raporlamak için yapılandırılabilir. Aşağıdaki bölümlerde, SMB paylaşımı veya HTTP DSC Çekme Sunucusu ile bir çekme istemcisinin nasıl yapılandırılacağı gösterilmektedir. Düğümün LCM'si yenilendiğinde, atanan yapılandırmaları indirmek için yapılandırılan konuma ulaşır. Düğümde gerekli herhangi bir kaynak yoksa, bunları yapılandırılan konumdan otomatik olarak indirecektir. Düğüm bir Rapor Sunucusu ile yapılandırılmışsa, işlemin durumunu rapor eder.

Uyarı

Bu konu PowerShell 5.0 için geçerlidir. PowerShell 4.0'da çekme istemcisi ayarlama hakkında daha fazla bilgi için bkz. PowerShell 4.0'da yapılandırma kimliğini kullanarak çekme istemcisi ayarlama.

Çekme istemcisi LCM'sini yapılandırma

Aşağıdaki örneklerden herhangi biri yürütüldüğünde PullClientConfigName adlı yeni bir çıkış klasörü oluşturulur ve buraya bir meta yapılandırma MOF dosyası yerleştirilir. Bu durumda, meta yapılandırma MOF dosyası olarak adlandırılacaktır localhost.meta.mof.

Yapılandırmayı uygulamak için, Set-DscLocalConfigurationManager cmdlet'ini çağırın ve Yol, meta yapılandırma MOF dosyasının konumuna ayarlandı. Örneğin:

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

Yapılandırma Adı

Aşağıdaki örnekler, LCM'nin ConfigurationName özelliğini, bu amaç için oluşturulmuş daha önce derlenmiş bir Yapılandırmanın adına ayarlar. ConfigurationName, LCM'nin çekme sunucusunda uygun yapılandırmayı bulmak için kullandığı şeydir. Çekme sunucusundaki yapılandırma MOF dosyası , bu durumda "ClientConfig.mof" olarak adlandırılmalıdır <ConfigurationName>.mof. Daha fazla bilgi için bkz: Çekme Sunucusuna Yapılandırma Yayımlama (v4/v5).

Yapılandırmaları indirmek için bir Çekme İstemcisi ayarlayın

Her istemcinin Çekme modunda yapılandırılması ve yapılandırmasının depolandığı çekme sunucusu URL'sinin verilmesi gerekir. Bunu yapmak için, Yerel Yapılandırma Yöneticisini (LCM) gerekli bilgilerle yapılandırmanız gerekir. LCM'yi yapılandırmak için, DSCLocalConfigurationManager özniteliğiyle süslenmiş özel bir yapılandırma türü oluşturursunuz. LCM'yi yapılandırma hakkında daha fazla bilgi için bkz: Yerel Yapılandırma Yöneticisini Yapılandırma.

Aşağıdaki betik, LCM'yi "CONTOSO-PullSrv" adlı bir sunucudan yapılandırmaları çekecek şekilde yapılandırır.

  • Betikte, ConfigurationRepositoryWeb bloğu çekme sunucusunu tanımlar. ServerURL özelliği, çekme sunucusunun uç noktasını belirtir.

  • RegistrationKey özelliği, bir çekme sunucusu ile bu çekme sunucusu için tüm istemci düğümleri arasında paylaşılan bir anahtardır. Aynı değer, çekme sunucusundaki bir dosyada depolanır.

    Uyarı

    Kayıt anahtarları yalnızca web çekme sunucularıyla çalışır. SMB çekme sunucusuyla ConfigurationID'yi kullanmaya devam etmeniz gerekir. > ConfigurationID kullanarak bir çekme sunucusu yapılandırma hakkında daha fazla bilgi için bkz: Yapılandırma kimliğini kullanarak bir çekme istemcisi ayarlama

  • ConfigurationNames özelliği, istemci düğümü için amaçlanan yapılandırmaların adlarını belirten bir dizidir. > Not:ConfigurationNames'te birden fazla değer belirtirseniz, yapılandırmanızda PartialConfiguration bloklarını da belirtmeniz gerekir. >Kısmi yapılandırmalar hakkında daha fazla bilgi için bkz: PowerShell Desired State Configuration kısmi yapılandırmaları.

[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

Kaynakları indirmek için bir Çekme İstemcisi ayarlayın

LCM yapılandırmanızda yalnızca bir ConfigurationRepositoryWeb veya ConfigurationRepositoryShare bloğu belirtirseniz (önceki örnekte olduğu gibi), çekme istemcisi kaynakları ".mof" dosyalarınızın depolandığı konumdan çeker. İstemcilerin kaynakları indirebileceği farklı konumlar da belirtebilirsiniz. Bir kaynak sunucusu belirtmek için, bir ResourceRepositoryWeb (web çekme sunucusu için) veya bir ResourceRepositoryShare bloğu (SMB çekme sunucusu için) kullanırsınız.

Aşağıdaki örnekte, bir istemciyi bir Çekme Sunucusundan yapılandırmaları ve bir SMB paylaşımından kaynakları indirecek şekilde ayarlayan bir meta yapılandırma gösterilmektedir.

[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

Durumu raporlamak için bir Çekme İstemcisi ayarlayın

Yapılandırmalar, kaynaklar ve raporlama için tek bir çekme sunucusu kullanabilirsiniz. Raporlama, istemciler için varsayılan olarak yapılandırılmamıştır. Bir istemciyi durumu bildirecek şekilde yapılandırmak için bir ReportRepositoryWeb bloğu oluşturmanız gerekir. Aşağıdaki örnekte, yapılandırmaları ve kaynakları çekmek ve raporlama verilerini tek bir çekme sunucusuna göndermek için bir istemciyi ayarlayan bir meta yapılandırma gösterilmektedir.

Uyarı

Rapor sunucusu bir SMB paylaşımı olamaz.

[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

Ayrıca Bkz.

  • Last updated on