DSC WindowsFeature Kaynağı

Şunlar için geçerlidir: Windows PowerShell 4.0, Windows PowerShell 5.x

Windows PowerShell Desired State Configuration(DSC) içindeki WindowsFeature kaynağı, rollerin ve özelliklerin hedef düğüme eklendiğinden veya kaldırıldığından emin olmak için bir mekanizma sağlar.

Not

Bu DSC kaynağının bu belgeleri, PowerShell'in 7.2 sürümünden önceki sürümünü kapsar. PSDscResources modülü, Microsoft tarafından resmi olarak desteklenen yeni ve güncelleştirilmiş DSC Kaynakları içerir. PSDscResources modülü PowerShell Galerisi kullanılabilir.

Daha fazla bilgi ve güncelleştirilmiş belgeler için PSDscResources başvuru belgelerine bakın.

Syntax

WindowsFeature [string] #ResourceName
{
    Name = [string]
    [ Credential = [PSCredential] ]
    [ IncludeAllSubFeature = [bool] ]
    [ LogPath = [string] ]
    [ DependsOn = [string[]] ]
    [ Ensure = [string] { Absent | Present }  ]
    [ PsDscRunAsCredential = [PSCredential] ]
}

Özellikler

Özellik	Açıklama
Ad	Eklendiğinden veya kaldırıldığından emin olmak istediğiniz rolün veya özelliğin adını gösterir. Bu, Get-WindowsFeature cmdlet'indeki Name özelliğiyle aynıdır ve rolün veya özelliğin görünen adıyla aynı değildir.
Kimlik Bilgisi	Rol veya özelliği eklemek veya kaldırmak için kullanılacak kimlik bilgilerini gösterir.
IncludeAllSubFeature	Name özelliğiyle belirttiğiniz özelliğin $true durumuyla tüm gerekli alt özelliklerin durumunu güvence altına almak için bu özelliği olarak ayarlayın.
Logpath	Kaynak sağlayıcısının işlemi günlüğe kaydetmesini istediğiniz günlük dosyasının yolunu gösterir.

Ortak özellikler

Özellik	Açıklama
Dependson	Bu kaynak yapılandırılmadan önce başka bir kaynağın yapılandırmasının çalıştırılması gerektiğini gösterir. Örneğin, önce çalıştırmak istediğiniz kaynak yapılandırma betik bloğunun kimliği ResourceName ve türü ResourceType ise, bu özelliğin kullanıldığı söz dizimi şeklindedir DependsOn = "[ResourceType]ResourceName".
Sağlamak	Rolün veya özelliğin eklenip eklenmediğini gösterir. Rolün veya özelliğin eklendiğinden emin olmak için bu özelliği Sun olarak ayarlayın. Rolün veya özelliğin kaldırıldığından emin olmak için özelliğini Yok olarak ayarlayın. Varsayılan değer Mevcut'tır.
PsDscRunAsCredential	Kaynağın tamamını çalıştırmak için kimlik bilgilerini olarak ayarlar.

Not

PsDscRunAsCredential common özelliği, diğer kimlik bilgileri bağlamında herhangi bir DSC kaynağının çalıştırılmasına izin vermek için WMF 5.0'a eklendi. Daha fazla bilgi için bkz. DSC Kaynaklarıyla Kimlik Bilgilerini Kullanma.

Örnek

WindowsFeature RoleExample
{
    Ensure = "Present"
    # Alternatively, to ensure the role is uninstalled, set Ensure to "Absent"
    Name = "Web-Server" # Use the Name property from Get-WindowsFeature
}