Restart-Service
Bir veya daha fazla hizmeti durdurur ve başlatır.
Syntax
InputObject (Varsayılan)
Restart-Service
[-InputObject] <ServiceController[]>
[-Force]
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Default
Restart-Service
[-Name] <String[]>
[-Force]
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
DisplayName
Restart-Service
-DisplayName <String[]>
[-Force]
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Bu cmdlet yalnızca Windows platformunda kullanılabilir.
Restart-Service cmdlet'i, belirtilen hizmet için Windows Hizmet Denetleyicisi'ne bir durdurma iletisi ve ardından bir başlangıç iletisi gönderir. Bir hizmet zaten durdurulduysa, size bir hata bildirilmeden başlatılır. Hizmetleri hizmet adlarına veya görünen adlarına göre belirtebilir veya yeniden başlatmak istediğiniz her hizmeti temsil eden bir nesne geçirmek için InputObject parametresini kullanabilirsiniz.
Örnekler
Örnek 1: Yerel bilgisayarda bir hizmeti yeniden başlatma
PS C:\> Restart-Service -Name winmgmt
Bu komut, yerel bilgisayarda Windows Yönetim Araçları hizmetini (WinMgmt) yeniden başlatır.
Örnek 2: Bir hizmeti dışlama
PS C:\> Restart-Service -DisplayName "net*" -Exclude "net logon"
Bu komut, Net Logon hizmeti dışında Net ile başlayan görünen ada sahip hizmetleri yeniden başlatır.
Örnek 3: Durdurulan tüm ağ hizmetlerini başlatma
PS C:\> Get-Service -Name "net*" | Where-Object {$_.Status -eq "Stopped"} | Restart-Service
Bu komut, bilgisayardaki tüm durdurulan ağ hizmetlerini başlatır.
Bu komut, hizmet adı net ile başlayan hizmetleri temsil eden nesneleri almak için Get-Service cmdlet'ini kullanır. İşlem hattı işleci (|), services nesnesini Where-Object cmdlet'ine gönderir ve bu da yalnızca durduruldu durumuna sahip hizmetleri seçer. Başka bir işlem hattı işleci seçili hizmetleri Restart-Servicegönderir.
Uygulamada, çalıştırmadan önce komutun etkisini belirlemek için WhatIf parametresini kullanırsınız.
Parametreler
-Confirm
Cmdlet'i çalıştırmadan önce sizden onay ister.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Cf |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-DisplayName
Yeniden başlatılan hizmetlerin görünen adlarını belirtir. Joker karakterlere izin verilir.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
DisplayName
| Position: | Named |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Exclude
Bu cmdlet'in atlayan hizmetleri belirtir. Bu parametrenin değeri, Adı parametresini niteler. s* gibi bir ad öğesi veya desen girin. Joker karakterlere izin verilir.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Force
Komutu, kullanıcı onayı istemeden çalışmaya zorlar.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Include
Bu cmdlet'in yeniden başlatıldığı hizmetleri belirtir. Bu parametrenin değeri, Adı parametresini niteler. s* gibi bir ad öğesi veya desen girin. Joker karakterlere izin verilir.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-InputObject
Yeniden başlatacak hizmetleri temsil eden ServiceController nesnelerini belirtir. Nesneleri içeren bir değişken girin veya nesneleri alan bir komut veya ifade yazın.
Parametre özellikleri
| Tür: | |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
InputObject
| Position: | 0 |
| Zorunlu: | True |
| İşlem hattından gelen değer: | True |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Name
Yeniden başlatacak hizmetlerin hizmet adlarını belirtir.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | True |
| DontShow: | False |
| Diğer adlar: | Servis Adı |
Parametre kümeleri
Default
| Position: | 0 |
| Zorunlu: | True |
| İşlem hattından gelen değer: | True |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-PassThru
Hizmeti temsil eden bir nesne döndürür. Varsayılan olarak, bu cmdlet herhangi bir çıkış oluşturmaz.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-WhatIf
Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmaz.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Wi |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
CommonParameters
Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.
Girişler
ServiceController
Bir hizmet nesnesini bu cmdlet'e yöneltebilirsiniz.
String
Hizmet adı içeren bir dizeyi bu cmdlet'e aktarabilirsiniz.
Çıkışlar
None
Varsayılan olarak, bu cmdlet çıkış döndürmez.
ServiceController
PassThru parametresini kullandığınızda, bu cmdlet yeniden başlatılan hizmeti temsil eden bir ServiceController nesnesi döndürür.
Notlar
Bu cmdlet yalnızca Windows platformlarında kullanılabilir.
-
Restart-Service, hizmetleri yalnızca geçerli kullanıcının buna izin verdiği durumda denetleyebilir. Bir komut düzgün çalışmıyorsa gerekli izinlere sahip olmayabilirsiniz. - Sisteminizdeki hizmet adlarını bulmak ve hizmetlerin adlarını görüntülemek için "
Get-Serviceyazın. Hizmet adları Adı sütununda, gösterim adları DisplayName sütununda yer alır.
PowerShell 6.0'da başlayarak, komut artık ComputerName parametresini içermiyor. Bu komutu uzak bir bilgisayarda kullanmak için uzak bir sistemi hedeflemek için komutunu Invoke-Command kullanın.
