Yerel Configuration Manager Yapılandırma

Makale
05/05/2023

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

Yerel Configuration Manager (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ırmak ve uygulamaktan sorumludur. Ayrıca, aşağıdakiler de dahil olmak üzere DSC'nin diğer bazı yönlerinden de sorumludur.

Yenileme modunu belirleme (gönderme veya çekme).
Bir düğümün yapılandırmaları çekme ve işlem sıklıklarını belirtme.
Düğümü çekme hizmetiyle ilişkilendirme.
Kısmi yapılandırmaları belirtme.

LCM'yi bu davranışların her birini belirtecek şekilde yapılandırmak için özel bir yapılandırma türü kullanırsınız. Aşağıdaki bölümlerde LCM'nin nasıl yapılandırıldığı açıklanmaktadır.

Windows PowerShell 5.0, Yerel Configuration Manager yönetmek için yeni ayarlar kullanıma sunulmuştur. Windows PowerShell 4.0'da LCM'yi yapılandırma hakkında bilgi için bkz. Windows PowerShell Önceki Sürümlerinde Yerel Configuration Manager Yapılandırma.

LCM yapılandırması yazma ve düzenleme

LCM'yi yapılandırmak için LCM ayarlarını uygulayan özel bir yapılandırma türü oluşturup çalıştırırsınız. LCM yapılandırmasını belirtmek için DscLocalConfigurationManager özniteliğini kullanırsınız. Aşağıda LCM'yi gönderme moduna ayarlayan basit bir yapılandırma gösterilmektedir.

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

LCM'ye ayarları uygulama işlemi, DSC yapılandırması uygulama işlemine benzer. Bir LCM yapılandırması oluşturacak, bunu bir MOF dosyasına derleyecek ve düğüme uygulayacaksınız. DSC yapılandırmalarından farklı olarak, Start-DscConfiguration cmdlet'ini çağırarak bir LCM yapılandırması gerçekleştirmezsiniz. Bunun yerine Set-DscLocalConfigurationManager çağrısı yaparak LCM yapılandırması MOF yolunu parametre olarak sağlarsınız. LCM yapılandırmasını işledikten sonra Get-DscLocalConfigurationManager cmdlet'ini çağırarak LCM'nin özelliklerini görebilirsiniz.

LCM yapılandırması yalnızca sınırlı bir kaynak kümesi için bloklar içerebilir. Önceki örnekte, adlı tek kaynak Ayarlar'dır. Diğer kullanılabilir kaynaklar şunlardır:

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ı belirtmenin dışında, LCM'nin tüm özellikleri Ayarlar bloğunda yapılandırılır. Ayarlar bloğunda aşağıdaki özellikler kullanılabilir.

Özellik	Tür	Description
ActionAfterReboot	string	Yapılandırmanın uygulanması sırasında yeniden başlatma sonrasında ne olacağını belirtir. Olası değerler şunlardır: "ContinueConfiguration" ve "StopConfiguration". ContinueConfiguration: Makine yeniden başlatıldıktan sonra geçerli yapılandırmayı uygulamaya devam edin. Bu varsayılan değerdir StopConfiguration: Makine yeniden başlatıldıktan sonra geçerli yapılandırmayı durdurun.
AllowModuleOverwrite	bool	Çekme hizmetinden indirilen yeni yapılandırmaların hedef düğümdeki eski yapılandırmaların üzerine yazılmasının izin verilip verilmediğini $TRUE. 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. Windows PowerShell Desired State Configuration kimlik bilgilerinin güvenliğini sağlamak mı istiyorsunuz?. Not: Bu, Azure Otomasyonu DSC çekme hizmeti kullanılıyorsa 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 hizmetinden alınacak yapılandırma dosyasını tanımlayan GUID. Yapılandırma MOF'sinin adı ConfigurationID.mof ise düğüm çekme hizmetinde yapılandırmaları çeker. Not: Bu özelliği ayarlarsanız , RegistrationKey kullanarak düğümü bir çekme hizmetine kaydetme işlemi çalışmaz. Daha fazla bilgi için bkz . Yapılandırma adlarıyla çekme istemcisi ayarlama.
ConfigurationMode	string	LCM'nin yapılandırmayı hedef düğümlere nasıl uygulaydığını belirtir. Olası değerler şunlardır: "ApplyOnly","ApplyAndMonitor", ve "ApplyAndAutoCorrect". ApplyOnly: DSC, yapılandırmayı uygular ve hedef düğüme yeni bir yapılandırma gönderilmediği veya hizmetten yeni bir yapılandırma çekilmediği sürece başka bir şey yapmaz. Yeni yapılandırmanın ilk uygulamasından sonra DSC, daha önce yapılandırılmış bir durumdan kayma olup olmadığını denetlemez. DSC'nin ApplyOnly etkin olmadan önce başarılı olana kadar yapılandırmayı uygulamayı deneyeceğini unutmayın. ApplyAndMonitor: Bu varsayılan değerdir. LCM yeni yapılandırmaları uygular. Yeni yapılandırmanın ilk uygulamasından sonra, hedef düğüm istenen durumdan kayıyorsa, DSC tutarsızlığı günlüklerde bildirir. DSC'nin ApplyAndMonitor etkin olmadan önce başarılı olana kadar yapılandırmayı uygulamayı deneyeceğini unutmayın. ApplyAndAutoCorrect: DSC yeni yapılandırmaları uygular. Yeni yapılandırmanın ilk uygulamasından sonra hedef düğüm istenen durumdan kayıyorsa, DSC tutarsızlığı günlüklerde bildirir ve geçerli yapılandırmayı yeniden uygular.
ConfigurationModeFrequencyMins	UInt32	Geçerli yapılandırmanın ne sıklıkta (dakika cinsinden) denetlenip 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ınmış kaynakları kullanmak için Yok olarak ayarlayın. Bu varsayılandır ve üretim senaryolarında kullanılmalıdır. ForceModuleImport ayarı, LCM'nin daha önce yüklenmiş ve önbelleğe alınmış olsalar bile tüm DSC kaynak modüllerini yeniden yüklemesine neden olur. Bu, her modül kullanıma yeniden yüklendiğinden DSC işlemlerinin performansını etkiler. Genellikle bir kaynağın hatalarını ayıklarken bu değeri kullanırsınız Bu sürümde, TümüForceModuleImport ile aynıdır
RebootNodeIfNeeded	bool	Kaynakların bayrağını kullanarak Node'un yeniden başlatılmasına izin vermek için bunu `$true` olarak `$global:DSCMachineStatus` ayarlayın. Aksi takdirde, düğümü gerektiren tüm yapılandırmalar için el ile yeniden başlatmanız gerekir. `$false` varsayılan değerdir. Yeniden başlatma koşulu DSC (Windows Installer gibi) dışında bir şey tarafından uygulandığında bu ayarı kullanmak için bu ayarı ComputerManagementDsc modülündeki PendingReboot kaynağıyla birleştirin.
Refreshmode	string	LCM'nin yapılandırmaları nasıl alacağını belirtir. Olası değerler şunlardır: "Disabled", "Push" ve "Pull". Devre dışı: Bu düğüm için DSC yapılandırmaları devre dışı bırakıldı. Gönderme: 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 hizmetinden veya SMB yolundan yapılandırmaları düzenli olarak denetlemek üzere yapılandırılır. Bu özellik Çekme olarak ayarlandıysa, ConfigurationRepositoryWeb veya ConfigurationRepositoryShare bloğunda bir HTTP (hizmet) veya SMB (paylaşım) yolu belirtmeniz gerekir.
RefreshFrequencyMins	Uint32	LCM'nin güncelleştirilmiş yapılandırmaları almak için bir çekme hizmetini denetlediği ve yerel yapılandırmayı kayma için denetlediği dakika cinsinden zaman aralığı. Yapılandırma, bir güncelleştirmenin indirilip indirilmediğine 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ı. Çekme hizmeti HTTP uç noktalarını veya SMB yollarını tanımlamak için sırasıyla ResourceRepositoryWeb ve ResourceRepositoryShare bloklarını kullanın.
PartialConfigurations	CimInstance	Uygulanmaz. Kullanmayın.
StatusRetentionTimeInDays	UInt32	LCM'nin geçerli yapılandırmanın durumunu tuttuğu gün sayısı.

Not

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

Kullanılarak ConfigurationModeFrequencyMins'de değişiklik yapılan yeni bir meta yapılandırma uygulanır Set-DscLocalConfigurationManager
Makine yeniden başlatma

Zamanlayıcı işleminin kilitlenme yaşadığı herhangi bir koşul için, 30 saniye içinde algılanır ve döngü yeniden başlatılır. Eşzamanlı bir işlem, bu işlemin süresi yapılandırılan döngü sıklığını aşarsa sonraki zamanlayıcı başlatılmaz. Örneğin, meta yapılandırma 15 dakikalık çekme sıklığında yapılandırılır ve T1'de çekme gerçekleşir. Düğüm 16 dakika boyunca çalışmayı bitirmez. İlk 15 dakikalık döngü yoksayılır ve bir sonraki çekme işlemi T1+15+15'te gerçekleşir.

Çekme senaryolarındaki özgün amaç, öğesinin değerinden RefreshFrequencyMins daha uzun bir zamana ConfigurationModeFrequencyMinsayarlanmış olmasıdır. Yerel yapılandırmalar öncelikle yapılandırma kaymasını önlemek için tarafından ConfigurationModeFrequencyMins yönetilir ve RefreshFrequencyMins yönetici tarafından yapılan 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ürlerini tanımlamayı 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: PowerShell modülleri olarak paketlenmiş DSC kaynakları için 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ıdır.

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

Yapılandırma sunucusu blokları

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

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

Not

Windows 1809 ve sonraki sürümlerde desteklenir.

Ş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şturursunuz. ConfigurationRepositoryShare aşağıdaki özellikleri tanımlar.

Özellik	Tür	Description
Referans	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şturursunuz. ResourceRepositoryWeb aşağıdaki özellikleri tanımlar.

Özellik	Tür	Description
AllowUnsecureConnection	bool	Düğümden sunucuya kimlik doğrulaması olmadan bağlantılara izin vermek için $TRUE olarak ayarlayın. Kimlik doğrulaması gerektirecek şekilde $FALSE olarak ayarlayın.
Sertifika Kimliği	string	Sunucuda kimlik doğrulaması yapmak için kullanılan bir sertifikanın parmak izi.
Kayıt Anahtarı	string	Düğümü çekme hizmetine tanıtır.
Serverurl	string	Yapılandırma sunucusunun URL'si.
ProxyURL*	string	Yapılandırma hizmetiyle iletişim kurarken kullanılacak http proxy'sinin URL'si.
ProxyCredential*	pscredential	Http ara sunucusu için kullanılacak kimlik bilgisi.

Not

Windows 1809 ve sonraki sürümlerde desteklenir.

Şirket içi düğümler için ResourceRepositoryWeb değerini yapılandırmayı basitleştirmeye yönelik ö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şturursunuz. ResourceRepositoryShare aşağıdaki özellikleri tanımlar.

Özellik	Tür	Description
Referans	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şturursunuz. Rapor sunucusu rolü SMB tabanlı çekme hizmetiyle uyumlu değil. ReportServerWeb aşağıdaki özellikleri tanımlar.

Özellik	Tür	Description
AllowUnsecureConnection	bool	Düğümden sunucuya kimlik doğrulaması olmadan bağlantılara izin vermek için $TRUE olarak ayarlayın. Kimlik doğrulaması gerektirecek şekilde $FALSE olarak ayarlayın.
Sertifika Kimliği	string	Sunucuda kimlik doğrulaması yapmak için kullanılan bir sertifikanın parmak izi.
Kayıt Anahtarı	string	Düğümü çekme hizmetine tanıtır.
Serverurl	string	Yapılandırma sunucusunun URL'si.
ProxyURL*	string	Yapılandırma hizmetiyle iletişim kurarken kullanılacak http proxy'sinin URL'si.
ProxyCredential*	pscredential	Http ara sunucusu için kullanılacak kimlik bilgisi.

Not

Windows 1809 ve sonraki sürümlerde desteklenir.

Şirket içi düğümler için ReportServerWeb değerini yapılandırmayı basitleştirmeye yönelik ö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 PartialConfiguration bloğu oluşturursunuz. 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[]	Kısmi yapılandırmanın çekildiği ConfigurationRepositoryWeb ve ConfigurationRepositoryShare bloklarında daha önce tanımlanan yapılandırma sunucularının adları dizisi.
Dependson	Dize{}	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 aldığını belirtir. Olası değerler "Disabled", "Push" ve "Pull" değerleridir. Devre dışı: Bu kısmi yapılandırma devre dışı bırakıldı. Gönderme: Kısmi yapılandırma Publish-DscConfiguration cmdlet'i çağrılarak düğüme gönderilir. Düğüm için tüm kısmi yapılandırmalar bir hizmetten gönderildikten veya çekildikten sonra, çağrısı `Start-DscConfiguration –UseExisting`yapılarak yapılandırma başlatılabilir. Varsayılan değer budur. Çekme: Düğüm, çekme hizmetinden gelen kısmi yapılandırmayı düzenli olarak denetleyecek şekilde yapılandırılır. Bu özellik Çekme olarak ayarlandıysa, ConfigurationSource özelliğinde bir çekme hizmeti belirtmeniz gerekir. Azure Otomasyonu çekme hizmeti hakkında daha fazla bilgi için bkz. Azure Otomasyonu DSC'ye Genel Bakış.
ResourceModuleSource	string[]	Bu kısmi yapılandırma için gerekli kaynakların indirildiği kaynak sunucularının adları dizisi. Bu adların daha önce ResourceRepositoryWeb ve ResourceRepositoryShare bloklarında tanımlanan hizmet uç noktalarına başvurması gerekir.