DSC Hizmet Kaynağı

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

Windows PowerShell Desired State Configuration(DSC) içindeki Hizmet kaynağı, hedef düğümdeki hizmetleri yönetmek 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

Service [string] #ResourceName
{
    Name = [string]
    [ BuiltInAccount = [string] { LocalService | LocalSystem | NetworkService }  ]
    [ Credential = [PSCredential] ]
    [ StartupType = [string] { Automatic | Disabled | Manual }  ]
    [ State = [string] { Running | Stopped }  ]
    [ Dependencies = [string[]] ]
    [ Description = [string] ]
    [ DisplayName = [string] ]
    [ Path = [string] ]
    [ DependsOn = [string[]] ]
    [ Ensure = [string] { Absent | Present } ]
    [ PsDscRunAsCredential = [PSCredential] ]
}

Özellikler

Özellik	Açıklama
Ad	Hizmet adını gösterir. Bunun bazen görünen addan farklı olduğunu unutmayın. cmdlet'ini kullanarak Get-Service hizmetlerin ve geçerli durumlarının listesini alabilirsiniz.
BuiltInAccount	Hizmet için kullanılacak oturum açma hesabını gösterir. Bu özellik için izin verilen değerler şunlardır: LocalService, LocalSystem ve NetworkService.
Kimlik Bilgisi	Hizmetin altında çalıştırılacağı hesabın kimlik bilgilerini gösterir. Bu özellik ve BuiltinAccount özelliği birlikte kullanılamaz.
StartupType	Hizmetin başlangıç türünü gösterir. Bu özellik için izin verilen değerler şunlardır: Otomatik, Devre Dışı ve El ile.
Durum	Hizmet için emin olmak istediğiniz durumu gösterir. Değerler şunlardır: Çalışıyor veya Durduruldu.
Bağımlılıklar	Hizmetin sahip olması gereken bağımlılıkların adları dizisi.
Açıklama	Hedef hizmetin açıklamasını gösterir.
DisplayName	Hedef hizmetin görünen adını gösterir.
Yol	Yeni bir hizmet için ikili dosyanı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ği kullanmanın söz dizimi olur DependsOn = "[ResourceType]ResourceName".
Sağlamak	Hedef hizmetin sistemde var olup olmadığını gösterir. Hedef hizmetin mevcut olmadığından emin olmak için bu özelliği Yok olarak ayarlayın. Bunu Mevcut olarak ayarlamak, hedef hizmetin mevcut olmasını sağlar. Varsayılan değer Var'dı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

configuration ServiceTest
{
    Import-DscResource -ModuleName PSDesiredStateConfiguration

    Node localhost
    {

        Service ServiceExample
        {
            Name        = "TermService"
            StartupType = "Manual"
            State       = "Running"
        }
    }
}