Restart-Service

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

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

Syntax

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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

Yeniden başlatacak hizmetlerin görünen adlarını belirtir. Joker karakterlere izin verilir.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:ServiceController[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:String[]
Aliases:ServiceName
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-PassThru

Hizmeti temsil eden bir nesne döndürür. Varsayılan olarak, bu cmdlet herhangi bir çıkış oluşturmaz.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.