PowerShell 5.0 ve sonraki sürümlerde Yapılandırma Kimliklerini kullanarak Çekme İstemcisi ayarlama

Şunlar için geçerlidir: Windows PowerShell 5.0

Önemli

Çekme Sunucusu (Windows Özelliği DSC-Service), 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 konuk yapılandırması adlı Azure İlkesi ö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 karma makine desteği de içerir.

Çekme istemcisi kurmadan ö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. Çekme sunucusu kurmak için aşağıdaki kılavuzları kullanabilirsiniz:

Her hedef düğüm, yapılandırmaları, kaynakları indirecek ve hatta durumunu bildirecek şekilde yapılandırılabilir. Aşağıdaki bölümlerde, SMB paylaşımı veya HTTP DSC Çekme Sunucusu ile ç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şacaktır. Node'da gerekli kaynaklar yoksa, bunları yapılandırılan konumdan otomatik olarak indirecektir. Düğüm bir Rapor Sunucusu ile yapılandırılmışsa, işlemin durumunu bildirir.

Uyarı

Bu konu PowerShell 5.0 için geçerlidir. PowerShell 4.0'da çekme istemcisi ayarlama hakkında 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 birinin yürütülmesi, PullClientConfigID adlı yeni bir çıkış klasörü oluşturur ve oraya bir metayapılandırma MOF dosyası yerleştirir. Bu durumda, metayapılandırma MOF dosyası olarak adlandırılacaktır localhost.meta.mof.

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

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

Yapılandırma Kimliği

Aşağıdaki örnekler, LCM'nin ConfigurationID özelliğini daha önce bu amaçla oluşturulmuş bir Guid'e ayarlar. ConfigurationID, LCM'nin çekme sunucusunda uygun yapılandırmayı bulmak için kullandığı şeydir. Çekme sunucusundaki yapılandırma MOF dosyası adlandırılmalıdır ConfigurationID.mof, burada ConfigurationID hedef düğümün LCM'sinin ConfigurationID özelliğinin değeridir. Daha fazla bilgi için bkz: Yapılandırmaları Çekme Sunucusunda Yayımlama (v4/v5).

Aşağıdaki örneği kullanarak veya New-Guid cmdlet'ini kullanarak rastgele bir Guid oluşturabilirsiniz.

[System.Guid]::NewGuid()

Ortamınızda Guid'leri kullanma hakkında daha fazla bilgi için bkz: Guid'leri Planlama.

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

Her istemci Çekme modunda yapılandırılmalı ve yapılandırmasının depolandığı çekme sunucusu URL'si verilmelidir. Bunu yapmak için Yerel Configuration Manager'ı (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 Configuration Manager'ı Yapılandırma.

HTTP DSC Çekme Sunucusu

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

[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

Komut dosyasında ConfigurationRepositoryWeb bloğu çekme sunucusunu tanımlar. ServerUrl, DSC Çekme URL'sini belirtir

KOBİ Payı

Aşağıdaki betik, LCM'yi SMB Paylaşımı'ndan \\SMBPullServer\Pullyapılandırmaları çekecek şekilde yapılandırır.

[DSCLocalConfigurationManager()]
configuration PullClientConfigID
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Pull'
            ConfigurationID = '1d545e3b-60c3-47a0-bf65-5afc05182fd0'
            RefreshFrequencyMins = 30
            RebootNodeIfNeeded = $true
        }

        ConfigurationRepositoryShare SMBPullServer
        {
            SourcePath = '\\SMBPullServer\Pull'
        }
    }
}
PullClientConfigID

Betikte ConfigurationRepositoryShare bloğu, bu durumda yalnızca bir SMB paylaşımı olan çekme sunucusunu tanımlar.

Kaynakları indirmek için bir Çekme İstemcisi kurun

LCM yapılandırmanızda yalnızca ConfigurationRepositoryWeb veya ConfigurationRepositoryShare bloğunu belirtirseniz (önceki örneklerde olduğu gibi), çekme istemcisi yapılandırmalarını aldığı konumdan kaynakları çeker. Kaynaklar için ayrı konumlar da belirtebilirsiniz. Bir kaynak konumunu ayrı bir sunucu olarak belirtmek için ResourceRepositoryWeb bloğunu kullanın. Bir kaynak konumunu SMB paylaşımı olarak belirtmek için ResourceRepositoryShare bloğunu kullanın.

Uyarı

ConfigurationRepositoryWeb'iResourceRepositoryShare ile veya ConfigurationRepositoryShare'iResourceRepositoryWeb ile birleştirebilirsiniz. Bunun örnekleri aşağıda gösterilmemiştir.

HTTP DSC Çekme Sunucusu

Aşağıdaki meta yapılandırma, bir çekme istemcisini yapılandırmalarını CONTOSO-PullSrv'den ve kaynaklarını CONTOSO-ResourceSrv'den alacak şekilde yapılandırır.

[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

KOBİ Payı

Aşağıdaki örnekte, istemciyi SMB paylaşımından yapılandırmaları ve SMB paylaşımından \\SMBPullServer\Configurations\\SMBPullServer\Resourceskaynakları çekecek şekilde ayarlayan bir meta yapılandırma gösterilmektedir.

[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

Kaynakları Push Modunda otomatik olarak indirin

PowerShell 5.0'dan başlayarak, çekme istemcileriniz Anında Gönderme modu için yapılandırılmış olsalar bile modülleri bir SMB paylaşımından indirebilir. Bu, özellikle bir Çekme Sunucusu kurmak istemediğiniz senaryolarda kullanışlıdır. ResourceRepositoryShare bloğu, ConfigurationRepositoryShare belirtilmeden kullanılabilir. Aşağıdaki örnekte, istemciyi SMB Paylaşımından \\SMBPullServer\Resourceskaynak çekecek şekilde ayarlayan bir meta yapılandırma gösterilmektedir. Düğüm bir konfigürasyona PUSH edildiğinde, belirtilen paylaşımdan gerekli tüm kaynakları otomatik olarak indirecektir.

[DSCLocalConfigurationManager()]
configuration PullClientConfigID
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Push'
            ConfigurationID = '1d545e3b-60c3-47a0-bf65-5afc05182fd0'
        }

        ResourceRepositoryShare SMBResourceServer
        {
            SourcePath = '\\SMBPullServer\Resources'
        }
    }
}
PullClientConfigID

Durumu bildirmek için bir Çekme İstemcisi ayarlama

Varsayılan olarak, Düğümler yapılandırılmış bir Çekme Sunucusuna rapor göndermez. Yapılandırmalar, kaynaklar ve raporlama için tek bir çekme sunucusu kullanabilirsiniz, ancak raporlamayı ayarlamak için bir ReportRepositoryWeb bloğu oluşturmanız gerekir.

HTTP DSC Çekme Sunucusu

Aşağıdaki örnekte, yapılandırmaları ve kaynakları çekmek ve raporlama verilerini tek bir çekme sunucusuna göndermek için bir istemci ayarlayan bir meta yapılandırma gösterilmektedir.

[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

Bir rapor sunucusu belirtmek için, bir ReportRepositoryWeb bloğu kullanırsınız. Rapor sunucusu SMB sunucusu olamaz. Aşağıdaki meta yapılandırma, bir çekme istemcisini yapılandırmalarını CONTOSO-PullSrv'den ve kaynaklarını CONTOSO-ResourceSrv'den alacak ve durum raporlarını CONTOSO-ReportSrv'ye gönderecek şekilde yapılandırır:

[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

KOBİ Payı

Rapor sunucusu SMB paylaşımı olamaz.

Sonraki Adımlar

Çekme istemcisi yapılandırıldıktan sonra, sonraki adımları gerçekleştirmek için aşağıdaki kılavuzları kullanabilirsiniz:

Ayrıca Bkz.