Aracılığıyla paylaş


Hizmet

Özet

Bir Windows hizmetini yönetme.

Syntax

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

Description

Kaynak Service , hizmetleri eklemenize, güncelleştirmenize ve kaldırmanıza olanak tanır.

Gereksinimler

Yok.

Temel özellikler

Name

Hizmet adını dize olarak belirtin.

Not

Bazen bu değer görünen addan farklıdır. Cmdlet'iyle Get-Service hizmetlerin ve geçerli durumlarının listesini alabilirsiniz.

Type: System.String

İsteğe bağlı özellikler

BuiltInAccount

Hizmeti çalıştırmak için makine hesabının adını belirtin. Hizmetin başlatılması için hesabın Path tarafından belirtilen yürütülebilir dosyaya erişimi olmalıdır.

Bu özelliği Credential özelliğiyle belirtmeyin.

Type: System.String
Accepted Values:
  - LocalService
  - LocalSystem
  - NetworkService
Default Value: Null

Kimlik Bilgisi

Hizmeti çalıştırmak için bir hesabın kimlik bilgilerini belirtin. Hizmeti başlatmak için hesabın Path tarafından belirtilen yürütülebilir dosyaya erişimi olmalıdır. Kaynak bu hesaba otomatik olarak "Hizmet Olarak Oturum Aç" hakkını verir.

Bu özelliği BuiltInAccount özelliğiyle belirtmeyin.

Type: System.Management.Automation.PSCredential
Default Value: None

Bağımlılıklar

Bu hizmetin bir dize dizisi olarak çalışması için gereken hizmetlerin adlarını belirtin.

Type: System.String[]
Default Value: None

Description

Hizmetin açıklamasını dize olarak belirtin. Hizmet açıklaması Bilgisayar Yönetimi, Hizmetler'de görünür.

Type: System.String
Default Value: None

DesktopInteract

Hizmetin masaüstünde bir pencere oluşturup oluşturamayacağını veya iletişim kurabileceğini belirtin. BuiltInAccount olarak LocalSystembelirtilmemişse bu özellik olmalıdır$false.

$false varsayılan değerdir.

Type: System.Boolean
Default Value: false

DisplayName

Hizmetin insan dostu görünen adını dize olarak belirtin.

Type: System.String
Default Value: None

Sağlamak

Hizmetin mevcut olup olmayacağını belirtin. Hizmet eklemek veya güncelleştirmek için bu özelliği olarak Presentayarlayın. Bir hizmeti kaldırmak için bu özelliği olarak Absentayarlayın.

Present varsayılan değerdir.

Type: System.String
Accepted Values:
  - Absent
  - Present
Default Value: Present

Yol

Hizmetin yürütülebilir dosyasının yolunu dize olarak belirtin. Hizmet yoksa bu özellik gereklidir.

Type: System.String
Default Value: None

StartupTimeout

Hizmetin başlatılmasını bekleme süresini milisaniye cinsinden belirtin.

30000 varsayılan değerdir.

Type: System.UInt32
Default Value: 30000

StartupType

Hizmetin sistem başlatmada nasıl davranacağını belirtin. Değer aşağıdakilerden biri olmalıdır:

  • Automatic - Hizmet, işletim sistemi tarafından sistem başlangıcında başlatılır. Otomatik olarak başlatılan bir hizmet el ile başlatılan bir hizmete bağımlıysa, el ile başlatılan hizmet de sistem başlangıcında otomatik olarak başlatılır.
  • Disabled - Hizmet devre dışı bırakıldı ve bir kullanıcı veya uygulama tarafından başlatılamıyor.
  • Manual - Hizmet yalnızca el ile, kullanıcı tarafından, Hizmet Denetim Yöneticisi kullanılarak veya bir uygulama tarafından başlatılır.

Hizmet yoksa, varsayılan değer olur Automatic.

Type: System.String
Behavior: Write
Accepted Values:
  - Automatic
  - Disabled
  - Manual
Default Value: None

Durum

Hizmetin çalıştırılıp çalıştırılmayacağını belirtin. Değer aşağıdakilerden biri olmalıdır:

  • Running - Henüz başlatılmamışsa kaynak hizmeti başlatır.
  • Stopped - Kaynak çalışıyorsa hizmeti durdurur.
  • Ignore - Kaynak hizmeti başlatmıyor veya durdurmuyor.

Running varsayılan değerdir.

Type: System.String
Accepted Values:
  - Running
  - Stopped
  - Ignore
Default Value: Running

TerminateTimeout

Hizmetin durması için gereken süreyi milisaniye cinsinden belirtin. 30000 varsayılan değerdir.

Type: System.UInt32
Default Value: 30000

Örnekler