Aracılığıyla paylaş

Restart-Service

  • Başvuru
Modül:
Microsoft.PowerShell.Management

Bir veya daha fazla hizmeti durdurur ve başlatır.

Sözdizimi

Restart-Service
       [-Force]
       [-InputObject] <ServiceController[]>
       [-PassThru]
       [-Include <String[]>]
       [-Exclude <String[]>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Restart-Service
       [-Force]
       [-Name] <String[]>
       [-PassThru]
       [-Include <String[]>]
       [-Exclude <String[]>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Restart-Service
       [-Force]
       [-PassThru]
       -DisplayName <String[]>
       [-Include <String[]>]
       [-Exclude <String[]>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

Bu cmdlet yalnızca Windows platformunda kullanılabilir.

Cmdlet, Restart-Service 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 cmdlet'ini kullanır Get-Service . İşlem hattı işleci (|), services nesnesini cmdlet'ine Where-Object gönderir ve bu da yalnızca durduruldu durumuna sahip hizmetleri seçer. Başka bir işlem hattı işleci seçili hizmetleri adresine 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.

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

Yeniden başlatılan 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 Name parametresini niteler. s* gibi bir ad öğesi veya desen 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

-Force

Komutu, kullanıcı onayı istemeden çalışmaya zorlar.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Include

Bu cmdlet'in yeniden başlatıldığı hizmetleri belirtir. Bu parametrenin değeri Name parametresini niteler. s* gibi bir ad öğesi veya desen 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

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.

Tür:ServiceController[]
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Name

Yeniden başlatacak hizmetlerin hizmet adlarını belirtir.

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:True

-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ıyorsa 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

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 bunu yapma izni olduğunda denetleyebiliyor. Bir komut düzgün çalışmıyorsa gerekli izinlere sahip olmayabilirsiniz.
  • Sisteminizdeki Get-Servicehizmet adlarını bulmak ve hizmetlerin adlarını görüntülemek için "yazın. Hizmet adları Ad sütununda, görünen adlar ise DisplayName sütununda görünür.