Yerel Yapılandırma Yöneticisi

Makale
10/07/2021
Okumak için 8 dakika

Uygulama: Windows PowerShell 5.0

Yerel Yapılandırma Yöneticisi (LCM), Desired State Configuration (DSC) altyapısıdır. LCM her hedef düğümde çalışır ve düğüme gönderilen yapılandırmaları ayrıştırma ve işlemden sorumludur. Aşağıdakiler de dahil olmak üzere DSC'nin diğer çeşitli yönlerinden de sorumludur.

Yenileme modunu (itme veya çekme) belirleme.
Bir düğümün hangi sıklıkta çekme ve işlem yapılandırmaları işley olduğunu belirtme.
Düğümü çekme hizmetiyle irdeler.
Kısmi yapılandırmaları belirtme.

Bu davranışların her biri için LCM'yi yapılandırmak üzere özel bir yapılandırma türü kullanırsiniz. Aşağıdaki bölümlerde LCM'nin nasıl yapılandırıldığından emin olmak gerekir.

Windows PowerShell 5.0'da Yerel Ayarları yönetmeye Yapılandırma Yöneticisi. Windows PowerShell 4.0'da LCM'nin yapılandırılması hakkında bilgi için, bkz. Configuring the Local Yapılandırma Yöneticisi in Previous Versions of Windows PowerShell.

LCM yapılandırmasını yazma ve uygulama

LCM'yi yapılandırmak için LCM ayarlarının uygulandığı özel bir yapılandırma türü oluşturmanız ve çalıştırmanız gerekir. Bir LCM yapılandırması belirtmek için DscLocalConfigurationManager özniteliğini kullanın. Aşağıda, LCM'i itme moduna ayar eden basit bir yapılandırma ve bir yapılandırmayı gösterir.

[DSCLocalConfigurationManager()]
configuration LCMConfig
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Push'
        }
    }
}

Ayarları LCM'ye uygulama işlemi, DSC yapılandırması uygulamaya benzer. Bir LCM yapılandırması oluşturacak, bir MOF dosyasına derleyecek ve düğüme uygulayacak. DSC yapılandırmalarının aksine, Start-DscConfiguration cmdlet'ini çağırarak bir LCM yapılandırması oluşturmazsiniz. Bunun yerine Set-DscLocalConfigurationManager'ıçağırarak parametre olarak LCM yapılandırma MOF'lerinin yolunu sağlar. LCM yapılandırmasını tamamladikten sonra, Get-DscLocalConfigurationManager cmdlet'ini çağırarak LCM'nin özelliklerini görebilir.

LCM yapılandırması yalnızca sınırlı bir kaynak kümesi için bloklar içerebilir. Önceki örnekte adlı tek kaynak Ayarlar. Kullanılabilir diğer kaynaklar:

ConfigurationRepositoryWeb: yapılandırmalar için bir HTTP çekme hizmeti belirtir.
ConfigurationRepositoryShare: yapılandırmalar için bir SMB paylaşımı belirtir.
ResourceRepositoryWeb: modüller için bir HTTP çekme hizmeti belirtir.
ResourceRepositoryShare: modüller için bir SMB paylaşımı belirtir.
ReportServerWeb: Raporların gönderildiği bir HTTP çekme hizmetini belirtir.
PartialConfiguration: kısmi yapılandırmaları etkinleştirmek için veri sağlar.

Temel ayarlar

Çekme hizmeti uç noktalarını/yollarını ve kısmi yapılandırmalarını belirtmenin dışında, LCM'nin tüm özellikleri bir Ayarlar yapılandırılır. Aşağıdaki özellikler bir blokta Ayarlar kullanılabilir.

Özellik	Tür	Description
ActionAfterReboot	string	Yapılandırmanın uygulaması sırasında yeniden başlatma sonrasında ne olacağını belirtir. Olası değerler "ContinueConfiguration" ve "StopConfiguration" değerleridir. ContinueConfiguration: Makine yeniden başlatıldıktan sonra geçerli yapılandırmayı uygulamaya devam eder. Bu varsayılan değerdir StopConfiguration: Makine yeniden başlatıldıktan sonra geçerli yapılandırmayı durdurun.
AllowModuleOverwrite	bool	$TRUE hizmetten indirilen yeni yapılandırmaların hedef düğümdeki eski yapılandırmaların üzerine yazmasına izin veriliyorsa bu yapılandırmayı kullanın. Aksi takdirde, $FALSE.
CertificateID	string	Yapılandırmada geçirilen kimlik bilgilerinin güvenliğini sağlamak için kullanılan sertifikanın parmak izi. Daha fazla bilgi için bkz. Kimlik bilgilerinin güvenliğini Windows PowerShell Desired State Configuration.. Not: Bu, DSC çekme hizmeti Azure Otomasyonu otomatik olarak yönetilir.
ConfigurationDownloadManagers	CimInstance[]	Kullanımdan kalktı. Yapılandırma çekme hizmeti uç noktalarını tanımlamak için ConfigurationRepositoryWeb ve ConfigurationRepositoryShare bloklarını kullanın.
ConfigurationID	string	Eski çekme hizmeti sürümleriyle geriye dönük uyumluluk için. Çekme hizmetlerinden almak için yapılandırma dosyasını tanımlayan GUID. Yapılandırma MOF'ünün adı ConfigurationID.mof ise, düğüm çekme hizmeti üzerinde yapılandırmaları çeker. Not: Bu özelliği ayarsanız, RegistrationKey kullanarak düğümü bir çekme hizmetine kaydetme işlemi çalışmıyor. Daha fazla bilgi için bkz. Yapılandırma adlarla çekme istemcisi ayarlama.
ConfigurationMode	string	LCM'nin yapılandırmayı hedef düğümlere nasıl gerçekten uygulaması olduğunu belirtir. Olası değerler "ApplyOnly","ApplyAndMonitor" ve "ApplyAndAutoCorrect" değerleridir. ApplyOnly: DSC yapılandırmayı uygular ve hedef düğüme yeni bir yapılandırmanın veya hizmetten yeni bir yapılandırma çekildikçe başka bir şey yapmadı. Yeni yapılandırmanın ilk uygulamasından sonra DSC, önceden yapılandırılmış bir durumdan kayma olup olmadığını denetlemez. DSC'nin, ApplyOnly geçerli olmadan önce başarılı olana kadar yapılandırmayı uygulama girişiminde olacağını unutmayın. ApplyAndMonitor: Bu varsayılan değerdir. LCM tüm yeni yapılandırmaları uygular. Yeni yapılandırmanın ilk uygulamasından sonra, hedef düğüm istenen durumdan kayması olursa DSC günlüklerde tutarsızlığı raporlar. ApplyAndMonitor geçerli olmadan önce DSC'nin yapılandırmayı başarılı olana kadar uygulama girişiminde olacağını unutmayın. ApplyAndAutoCorrect: DSC yeni yapılandırmaları uygular. Yeni yapılandırmanın ilk uygulamasından sonra, hedef düğüm istenen durumdan kayması olursa DSC, tutarsızlığı günlüklerde raporlar ve sonra geçerli yapılandırmayı yeniden uygular.
ConfigurationModeFrequencyMins	UInt32	Dakikalar içinde geçerli yapılandırmanın ne sıklıkta denetlenir ve uygulandığı. ConfigurationMode özelliği ApplyOnly olarak ayarlanırsa bu özellik yoksayılır. Varsayılan değer 15'tir.
DebugMode	string	Olası değerler None, ForceModuleImport ve All değerleridir. Önbelleğe alınan kaynakları kullanmak için Hiçbiri olarak ayarlayın. Bu varsayılan değerdir ve üretim senaryolarında kullanılmalıdır. ForceModuleImport olarak ayarlandı, daha önce yüklenmiş ve önbelleğe alınmış olsalar bile LCM'nin tüm DSC kaynak modüllerini yeniden yüklemesini sağlar. Bu, her modül kullanımda yeniden yüklendiğinden DSC işlemlerinin performansını etkiler. Genellikle bir kaynakta hata ayıklarken bu değeri kullanır Bu sürümde, Hepsi ForceModuleImport ile aynıdır
RebootNodeIfNeeded	bool	Kaynakların bayrağını `$true` kullanarak Düğümü yeniden başlatmasına izin vermek için bunu olarak `$global:DSCMachineStatus` ayarlayın. Aksi takdirde, düğüm gerektiren tüm yapılandırmalar için düğümü el ile yeniden başlatmanız gerekir. `$false` varsayılan değerdir. Yeniden başlatma koşulu DSC (Windows Yükleyicisi gibi) dışında bir şey tarafından geçerli olduğunda bu ayarı kullanmak için ComputerManagementDsc modülünde PendingReboot kaynağıyla birleştirin.
Refreshmode	string	LCM'nin yapılandırmaları nasıl alır? Olası değerler "Disabled", "Push" ve "Pull" değerleridir. Devre dışı: DSC yapılandırmaları bu düğüm için devre dışı bırakıldı. Anında İlerleme: Yapılandırmalar Start-DscConfiguration cmdlet'i çağrılarak başlatılır. Yapılandırma düğüme hemen uygulanır. Varsayılan değer budur. Çekme: Düğüm, bir çekme hizmeti veya SMB yolundan yapılandırmaları düzenli olarak kontrol etmek üzere yapılandırılır. Bu özellik Çekme olarak ayarlanırsa, ConfigurationRepositoryWeb veya ConfigurationRepositoryShare bloğunda bir HTTP (hizmet) veya SMB (paylaşım) yolu belirtmeniz gerekir.
RefreshFrequencyMins	Uint32	Dakikalar içinde, LCM'nin güncelleştirilmiş yapılandırmaları almak için çekme hizmetini kontrol etmek ve yerel yapılandırmada kaymayı kontrol etmek için zaman aralığı. Yapılandırma, güncelleştirmenin indirilmiş olup olmadığına bakılmaksızın uygulanır. LCM çekme modunda yapılandırılmamışsa bu değer yoksayılır. Varsayılan değer 30’dur.
ReportManagers	CimInstance[]	Kullanımdan kalktı. Raporlama verilerini çekme hizmetine göndermek üzere bir uç nokta tanımlamak için ReportServerWeb bloklarını kullanın.
ResourceModuleManagers	CimInstance[]	Kullanımdan kalktı. Sırasıyla çekme hizmeti HTTP uç noktalarını veya SMB yollarını tanımlamak için ResourceRepositoryWeb ve ResourceRepositoryShare bloklarını kullanın.
PartialConfigurations	CimInstance	Uygulanmaz. Kullanmayın.
StatusRetentionTimeInDays	UInt32	LCM'nin geçerli yapılandırmanın durumunu kaç gün boyunca tutar?

Not

LCM, ConfigurationModeFrequencyMins döngüsünü şu şekilde başlatır:

ConfigurationModeFrequencyMins değişikliğine sahip yeni bir metaconfig, kullanılarak uygulanırSet-DscLocalConfigurationManager
Makine yeniden başlatma

Zamanlayıcı işleminin kilitlenmesi durumunda 30 saniye içinde algılanır ve döngü yeniden başlatılır. Eşzamanlı bir işlem döngü başlatmayı geciktirenin, bu işlem süresi yapılandırılmış döngü sıklığını aşarsa, sonraki zamanlayıcı başlamaz. Örnek olarak metaconfig 15 dakikalık çekme sıklığında yapılandırılır ve T1'de çekme gerçekleşir. Düğüm 16 dakika süreyle çalışmaya sonlanmaz. İlk 15 dakikalık döngü yoksayılır ve sonraki çekme T1+15+15'te olur.

Çekme senaryolarında ilk amaç, için RefreshFrequencyMins olandan daha uzun bir süreye ayarlanmıştır. ConfigurationModeFrequencyMins Yerel yapılandırmalar, yapılandırma kaymalarını önlemek için öncelikle tarafından idare edilebilir ve yönetici tarafından yapılan ConfigurationModeFrequencyMins RefreshFrequencyMins gerçek yapılandırma değişikliklerini izlemek için kullanılır.

Çekme hizmeti

LCM yapılandırması aşağıdaki çekme hizmeti uç noktası türlerinin tanımlanmasını destekler:

Yapılandırma sunucusu: DSC yapılandırmaları için bir depo. ConfigurationRepositoryWeb (web tabanlı sunucular için) ve ConfigurationRepositoryShare (SMB tabanlı sunucular için) bloklarını kullanarak yapılandırma sunucularını tanımlayın.
Kaynak sunucusu: DSC kaynakları için PowerShell modülleri olarak paketlenmiş bir depo. ResourceRepositoryWeb (web tabanlı sunucular için) ve ResourceRepositoryShare (SMB tabanlı sunucular için) bloklarını kullanarak kaynak sunucularını tanımlayın.
Rapor sunucusu: DSC'nin rapor verilerini gönderdiği bir hizmet. ReportServerWeb bloklarını kullanarak rapor sunucularını tanımlayın. Rapor sunucusu bir web hizmeti olmalı.

Çekme hizmeti hakkında daha fazla bilgi için bkz. Desired State Configuration Hizmeti.

Yapılandırma sunucusu blokları

Web tabanlı bir yapılandırma sunucusu tanımlamak için bir ConfigurationRepositoryWeb bloğu oluşturun. ConfigurationRepositoryWeb aşağıdaki özellikleri tanımlar.

Özellik	Tür	Description
AllowUnsecureConnection	bool	Düğümden $TRUE sunucuya kimlik doğrulaması olmadan bağlantılara izin vermek için varsayılan olarak ayarlayın. Kimlik doğrulaması $FALSE olarak ayarlayın.
CertificateID	string	Sunucuda kimlik doğrulaması yapmak için kullanılan sertifikanın parmak izi.
ConfigurationNames	Dize[]	Hedef düğüm tarafından çekilen yapılandırmaların adları dizisi. Bunlar yalnızca düğüm RegistrationKey kullanılarak çekme hizmetine kayıtlı ise kullanılır. Daha fazla bilgi için bkz. Yapılandırma adlarla çekme istemcisi ayarlama.
RegistrationKey	string	Düğümü çekme hizmetine kaydeden GUID. Daha fazla bilgi için bkz. Yapılandırma adlarla çekme istemcisi ayarlama.
Serverurl	string	Yapılandırma hizmetinin URL'si.
ProxyURL*	string	Yapılandırma hizmetiyle iletişim kurarken kullanmak üzere http ara sunucusunun URL'si.
ProxyCredential*	pscredential	Http ara sunucusu için kullanmak üzere kimlik bilgileri.

Not

1809 ve Windows sürümleri için destek.

Şirket içi düğümler için ConfigurationRepositoryWeb değerini yapılandırmayı basitleştirmek için örnek bir betik kullanılabilir - bkz. DSC meta yapılandırmaları oluşturma

SMB tabanlı bir yapılandırma sunucusu tanımlamak için bir ConfigurationRepositoryShare bloğu oluşturun. ConfigurationRepositoryShare aşağıdaki özellikleri tanımlar.

Özellik	Tür	Description
Kimlik Bilgisi	MSFT_Credential	SMB paylaşımında kimlik doğrulaması yapmak için kullanılan kimlik bilgisi.
Sourcepath	string	SMB paylaşımının yolu.

Kaynak sunucusu blokları

Web tabanlı bir kaynak sunucusu tanımlamak için bir ResourceRepositoryWeb bloğu oluşturun. ResourceRepositoryWeb aşağıdaki özellikleri tanımlar.

Özellik	Tür	Description
AllowUnsecureConnection	bool	Düğümden $TRUE sunucuya kimlik doğrulaması olmadan bağlantılara izin vermek için varsayılan olarak ayarlayın. Kimlik doğrulaması $FALSE olarak ayarlayın.
CertificateID	string	Sunucuda kimlik doğrulaması yapmak için kullanılan sertifikanın parmak izi.
RegistrationKey	string	Düğümü çekme hizmetine tanımlayan BIR GUID.
Serverurl	string	Yapılandırma sunucusunun URL'si.
ProxyURL*	string	Yapılandırma hizmetiyle iletişim kurarken kullanmak üzere http ara sunucusunun URL'si.
ProxyCredential*	pscredential	Http ara sunucusu için kullanmak üzere kimlik bilgileri.

Not

1809 ve Windows sürümleri için destek.

Şirket içi düğümler için ResourceRepositoryWeb değerini yapılandırmayı basitleştirmek için örnek bir betik kullanılabilir - bkz. DSC meta yapılandırmaları oluşturma

SMB tabanlı bir kaynak sunucusu tanımlamak için bir ResourceRepositoryShare bloğu oluşturun. ResourceRepositoryShare aşağıdaki özellikleri tanımlar.

Özellik	Tür	Description
Kimlik Bilgisi	MSFT_Credential	SMB paylaşımında kimlik doğrulaması yapmak için kullanılan kimlik bilgisi. Kimlik bilgilerini geçirme örneği için bkz. DSC SMB çekme sunucusu ayarlama
Sourcepath	string	SMB paylaşımının yolu.

Rapor sunucusu blokları

Bir rapor sunucusu tanımlamak için bir ReportServerWeb bloğu oluşturun. Rapor sunucusu rolü SMB tabanlı çekme hizmetiyle uyumlu değildir. ReportServerWeb aşağıdaki özellikleri tanımlar.

Özellik	Tür	Description
AllowUnsecureConnection	bool	Düğümden $TRUE sunucuya kimlik doğrulaması olmadan bağlantılara izin vermek için varsayılan olarak ayarlayın. Kimlik doğrulaması $FALSE olarak ayarlayın.
CertificateID	string	Sunucuda kimlik doğrulaması yapmak için kullanılan sertifikanın parmak izi.
RegistrationKey	string	Düğümü çekme hizmetine tanımlayan BIR GUID.
Serverurl	string	Yapılandırma sunucusunun URL'si.
ProxyURL*	string	Yapılandırma hizmetiyle iletişim kurarken kullanmak üzere http ara sunucusunun URL'si.
ProxyCredential*	pscredential	Http ara sunucusu için kullanmak üzere kimlik bilgileri.

Not

1809 ve Windows sürümleri için destek.

Şirket içi düğümler için ReportServerWeb değerini yapılandırmayı basitleştirmek için örnek bir betik kullanılabilir- bkz. DSC meta yapılandırmaları oluşturma

Kısmi yapılandırmalar

Kısmi yapılandırma tanımlamak için bir PartialConfiguration bloğu oluşturun. Kısmi yapılandırmalar hakkında daha fazla bilgi için bkz. DSC Kısmi yapılandırmaları. PartialConfiguration aşağıdaki özellikleri tanımlar.

Özellik	Tür	Description
ConfigurationSource	string[]	Daha önce ConfigurationRepositoryWeb ve ConfigurationRepositoryShare bloklarında tanımlanan ve kısmi yapılandırmanın çeklandığı yapılandırma sunucularının adları dizisi.
Dependson	string{}	Bu kısmi yapılandırma uygulanmadan önce tamamlanması gereken diğer yapılandırmaların adlarının listesi.
Description	dize	Kısmi yapılandırmayı açıklamak için kullanılan metin.
ExclusiveResources	string[]	Bu kısmi yapılandırmaya özel bir kaynak dizisi.
Refreshmode	string	LCM'nin bu kısmi yapılandırmayı nasıl alır? Olası değerler "Disabled", "Push" ve "Pull" değerleridir. Devre dışı: Bu kısmi yapılandırma devre dışıdır. Anında İlerleme: Kısmi yapılandırma Publish-DscConfiguration cmdlet'i çağrılarak düğüme itilir. Düğüme yönelik tüm kısmi yapılandırmalar bir hizmetten ertelendikten veya çekildikten sonra, yapılandırma çağrılarak `Start-DscConfiguration –UseExisting` başlatabilirsiniz. Varsayılan değer budur. Çekme: Düğüm, çekme hizmetlerinden kısmi yapılandırmayı düzenli olarak kontrol etmek üzere yapılandırılır. Bu özellik Çekme olarak ayarlanırsa, ConfigurationSource özelliğinde bir çekme hizmeti belirtmeniz gerekir. Çekme hizmeti hakkında daha fazla Azure Otomasyonu için bkz. DSC'Azure Otomasyonu Genel Bakış.
ResourceModuleSource	string[]	Bu kısmi yapılandırma için gerekli kaynakları indiren kaynak sunucularının adlarının dizisi. Bu adlar daha önce ResourceRepositoryWeb ve ResourceRepositoryShare bloklarında tanımlanmış olan hizmet uç noktalarına başvurur.