Start-Service
Bir veya daha fazla durdurulmuş hizmeti başlatır.
Sözdizimi
Start-Service
[-InputObject] <ServiceController[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Start-Service
[-Name] <String[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Start-Service
[-PassThru]
-DisplayName <String[]>
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Bu cmdlet yalnızca Windows platformunda kullanılabilir.
Start-Service
cmdlet'i, belirtilen hizmetlerin her biri için Windows Hizmet Denetleyicisi'ne bir başlangıç iletisi gönderir. Bir hizmet zaten çalışıyorsa, ileti hatasız olarak yoksayılır. Hizmetleri hizmet adlarına veya görünen adlarına göre belirtebilir veya başlatmak istediğiniz hizmetleri temsil eden bir hizmet nesnesi sağlamak için InputObject parametresini kullanabilirsiniz.
Örnekler
Örnek 1: Adını kullanarak hizmet başlatma
Bu örnek, yerel bilgisayarda EventLog hizmetini başlatır. Adı parametresi hizmeti hizmet adına göre tanımlar.
Start-Service -Name "eventlog"
Örnek 2: Hizmeti başlatmadan bilgileri görüntüleme
Bu örnek, "uzak" içeren bir görünen ada sahip hizmetleri başlattıysanız ne olacağını gösterir.
Start-Service -DisplayName *remote* -WhatIf
DisplayName parametresi, hizmetleri hizmet adları yerine görünen adlarıyla tanımlar. WhatIf parametresi, cmdlet'in komutu çalıştırdığınızda ancak değişiklik yapmadığınızda ne olacağını görüntülemesine neden olur.
Örnek 3: Bir hizmet başlatma ve eylemi bir metin dosyasına kaydetme
Bu örnek, bilgisayarda Windows Yönetim Araçları (WMI) hizmetini başlatır ve eylemin kaydını services.txt dosyasına ekler.
$s = Get-Service wmi
Start-Service -InputObject $s -PassThru | Format-List >> services.txt
İlk olarak, WMI hizmetini temsil eden bir nesneyi almak ve $s
değişkeninde depolamak için Get-Service
kullanırız. Ardından hizmeti başlatacağız.
PassThru parametresi olmadan Start-Service
herhangi bir çıkış oluşturmaz. İşlem hattı işleci (|
), nesnenin özelliklerini listesi olarak biçimlendirmek için nesne çıkışını Start-Service
Format-List
cmdlet'ine geçirir. Ekleme yeniden yönlendirme işleci (>>
) çıkışı services.txt dosyasına yönlendirir. Çıkış, var olan dosyanın sonuna eklenir.
Örnek 4: Devre dışı bırakılmış bir hizmeti başlatma
Bu örnekte, hizmetin başlangıç türü Devre Dışı bir hizmetin nasıl başlatılır gösterilmektedir.
PS> Start-Service tlntsvr
Start-Service : Service 'Telnet (TlntSvr)' cannot be started due to the following error: Cannot
start service TlntSvr on computer '.'.
At line:1 char:14
+ Start-Service <<<< tlntsvr
PS> Get-CimInstance Win32_Service | Where-Object Name -EQ "tlntsvr"
ExitCode : 0
Name : TlntSvr
ProcessId : 0
StartMode : Disabled
State : Stopped
Status : OK
PS> Set-Service tlntsvr -StartupType manual
PS> Start-Service tlntsvr
Telnet hizmetini (tlntsvr) başlatmaya yönelik ilk deneme başarısız olur.
Get-CimInstance
komutu, Tlntsvr hizmetinin StartMode özelliğinin Devre Dışı olduğunu gösterir.
Set-Service
cmdlet'i başlangıç türünü El ile olarak değiştirir. Şimdi Start-Service
komutunu yeniden gönderebiliriz. Bu kez komut başarılı olur. Komutun başarılı olduğunu doğrulamak için Get-Service
çalıştırın.
Parametreler
-Confirm
Cmdlet'i çalıştırmadan önce sizden onay ister.
Tür: | SwitchParameter |
Diğer adlar: | cf |
Position: | Named |
Default value: | False |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-DisplayName
Başlatacak hizmetlerin görünen adlarını belirtir. Joker karakterlere izin verilir.
Tür: | String[] |
Position: | Named |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | True |
-Exclude
Bu cmdlet'in atlayan hizmetleri belirtir. Bu parametrenin değeri, Adı parametresini niteler.
s*
gibi bir ad öğesi veya deseni girin. Joker karakterlere izin verilir.
Tür: | String[] |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | True |
-Include
Bu cmdlet'in başlatıldığı hizmetleri belirtir. Bu parametrenin değeri, Adı parametresini niteler.
s*
gibi bir ad öğesi veya deseni girin. Joker karakterlere izin verilir.
Tür: | String[] |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | True |
-InputObject
Başlatılacak hizmetleri temsil eden ServiceController nesneleri belirtir. Nesneleri içeren bir değişken girin veya nesneleri alan bir komut veya ifade yazın.
Tür: | ServiceController[] |
Position: | 0 |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-Name
Başlatılacak hizmetin hizmet adlarını belirtir.
Parametre adı isteğe bağlıdır. Adı veya diğer adını kullanabilir, ServiceName veya parametre adını atlayabilirsiniz.
Tür: | String[] |
Diğer adlar: | ServiceName |
Position: | 0 |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-PassThru
Hizmeti temsil eden bir nesne döndürür. Varsayılan olarak, bu cmdlet herhangi bir çıkış oluşturmaz.
Tür: | SwitchParameter |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-WhatIf
Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmaz.
Tür: | SwitchParameter |
Diğer adlar: | wi |
Position: | Named |
Default value: | False |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
Girişler
Bir hizmet nesnesini bu cmdlet'e yöneltebilirsiniz.
Hizmet adını içeren bir dizeyi bu cmdlet'e aktarabilirsiniz.
Çıkışlar
None
Varsayılan olarak, bu cmdlet çıkış döndürmez.
PassThru parametresini kullandığınızda, bu cmdlet hizmeti temsil eden bir ServiceController nesnesi döndürür.
Notlar
PowerShell, Start-Service
için aşağıdaki diğer adları içerir:
- Windows:
sasv
Bu cmdlet yalnızca Windows platformlarında kullanılabilir.
- Varsayılan olarak, bir hizmeti yalnızca Yöneticiler grubunun üyeleri başlatabilir, durdurabilir, duraklatabilir, sürdürebilir veya yeniden başlatabilir. Yöneticiler grubunun üyesiyseniz yükseltilmiş bir PowerShell oturumundan
Start-Service
çalıştırmanız gerekir. PowerShell'i başlatmak için yönetici olarak çalıştır seçeneğini kullanın. - Sisteminizdeki hizmet adlarını bulmak ve hizmetlerin adlarını görüntülemek için
Get-Service
yazın. Hizmet adları Adı sütununda, görünen adlar DisplayName sütununda görünür. - Yalnızca El ile, Otomatik veya Otomatik (Gecikmeli Başlangıç) başlangıç türüne sahip hizmetleri başlatabilirsiniz. Başlangıç türü Devre Dışı olan hizmetleri başlatamazsınız.
Start-Service
komutuCannot start service \<service-name\> on computer
iletisiyle başarısız olursa, hizmetin başlangıç türünü bulmak içinGet-CimInstance
kullanın ve gerekirse hizmetin başlangıç türünü değiştirmek içinSet-Service
cmdlet'ini kullanın. - Performans Günlükleri ve Uyarılar (SysmonLog) gibi bazı hizmetler, yapacak işleri yoksa otomatik olarak durur. PowerShell kendisini neredeyse hemen durduran bir hizmeti başlattığında şu iletiyi görüntüler:
Service \<display-name\> start failed.