Aracılığıyla paylaş

Set-Service

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

Bir hizmeti başlatır, durdurur ve askıya alır ve özelliklerini değiştirir.

Sözdizimi

Set-Service
   [-ComputerName <String[]>]
   [-Name] <String>
   [-DisplayName <String>]
   [-Description <String>]
   [-StartupType <ServiceStartMode>]
   [-Status <String>]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-Service
   [-ComputerName <String[]>]
   [-DisplayName <String>]
   [-Description <String>]
   [-StartupType <ServiceStartMode>]
   [-Status <String>]
   [-InputObject <ServiceController>]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

cmdlet'i Set-Service bir hizmetin Status, Description, DisplayName ve StartupType gibi özelliklerini değiştirir. Set-Service hizmeti başlatabilir, durdurabilir, askıya alabilir veya duraklatabilir. Bir hizmeti tanımlamak için hizmet adını girin veya bir hizmet nesnesi gönderin. Alternatif olarak, işlem hattının Set-Serviceaşağısına bir hizmet adı veya hizmet nesnesi gönderin.

Örnekler

Örnek 1: Görünen adı değiştirme

Bu örnekte, hizmetin görünen adı değiştirilir. Özgün görünen adı görüntülemek için kullanın Get-Service.

Set-Service -Name LanmanWorkstation -DisplayName "LanMan Workstation"

Set-Service, hizmetin adı olan LanmanWorkstation'ı belirtmek için Name parametresini kullanır. DisplayName parametresi, lanman workstation adlı yeni görünen adı belirtir.

Örnek 2: Hizmetlerin başlangıç türünü değiştirme

Bu örnekte bir hizmetin başlangıç türünü değiştirme işlemi gösterilmektedir.

Set-Service -Name BITS -StartupType Automatic
Get-Service BITS | Select-Object -Property Name, StartType, Status

Name  StartType   Status
----  ---------   ------
BITS  Automatic  Running

Set-Service, hizmetin adı olan BITS'i belirtmek için Name parametresini kullanır. StartupType parametresi hizmeti Otomatik olarak ayarlar.

Get-Service, BITS hizmetini belirtmek için Name parametresini kullanır ve nesneyi işlem hattına gönderir. Select-ObjectBITS hizmetinin durumunu görüntülemek için Property parametresini kullanır.

Örnek 3: Hizmetin açıklamasını değiştirme

Bu örnek, BITS hizmetinin açıklamasını değiştirir ve sonucu görüntüler.

Get-CimInstance Cmdlet, hizmetin Açıklamasını içeren bir Win32_Service nesnesi döndürdüğünden kullanılır.

Get-CimInstance Win32_Service -Filter 'Name = "BITS"'  | Format-List  Name, Description

Name        : BITS
Description : Transfers files in the background using idle network bandwidth. If the service is
              disabled, then any applications that depend on BITS, such as Windows Update or MSN
              Explorer, will be unable to automatically download programs and other information.

Set-Service -Name BITS -Description "Transfers files in the background using idle network bandwidth."
Get-CimInstance Win32_Service -Filter 'Name = "BITS"' | Format-List  Name, Description

Name        : BITS
Description : Transfers files in the background using idle network bandwidth.

Get-CimInstance nesnesini işlem hattına Format-List gönderir ve hizmetin adını ve açıklamasını görüntüler. Karşılaştırma amacıyla, komut açıklama güncelleştirilmeden önce ve sonra çalıştırılır.

Set-Service, BITS hizmetini belirtmek için Name parametresini kullanır. Description parametresi, hizmetlerin açıklaması için güncelleştirilmiş metni belirtir.

Örnek 4: Hizmet başlatma

Bu örnekte bir hizmet başlatılır.

Set-Service -Name WinRM -Status Running -PassThru

Status   Name               DisplayName
------   ----               -----------
Running  WinRM              Windows Remote Management (WS-Manag...

Set-ServiceHizmeti (WinRM) belirtmek için Name parametresini kullanır. Status parametresi, hizmeti başlatmak için Çalışıyor değerini kullanır. PassThru parametresi, sonuçları görüntüleyen bir ServiceController nesnesi oluşturur.

Örnek 5: Hizmeti askıya alma

Bu örnekte hizmet vermek için duraklatmak için işlem hattı kullanılır.

Get-Service -Name Schedule | Set-Service -Status Paused

Get-ServiceSchedule hizmetini belirtmek için Name parametresini kullanır ve nesneyi işlem hattına gönderir. Set-ServiceHizmeti Duraklatıldı olarak ayarlamak için Durum parametresini kullanır.

Örnek 6: Hizmeti durdurma

Bu örnekte bir hizmeti durdurmak için bir değişken kullanılır.

$S = Get-Service -Name Schedule
Set-Service -InputObject $S -Status Stopped

Get-ServiceHizmeti (Schedule) belirtmek için Name parametresini kullanır. nesnesi, $Sdeğişkeninde depolanır. Set-ServiceInputObject parametresini kullanır ve depolanan $Snesnesini belirtir. Status parametresi hizmeti Durduruldu olarak ayarlar.

Örnek 7: Birden çok hizmet için başlangıç türünü ayarlama

Cmdlet aynı Set-Service anda yalnızca bir hizmet adını kabul eder. Ancak, birden çok hizmetin yapılandırmasını değiştirmek için Set-Service birden çok hizmeti adresine yöneltebilirsiniz.

Get-Service SQLWriter,spooler |
    Set-Service -StartupType Automatic -PassThru |
    Select-Object Name, StartType

Name      StartType
----      ---------
spooler   Automatic
SQLWriter Automatic

Parametreler

-ComputerName

Bir veya daha fazla bilgisayarı belirtir. Uzak bilgisayarlar için NetBIOS adını, IP adresini veya tam etki alanı adını yazın. ComputerName parametresi belirtilmezse, komut yerel bilgisayarda çalışır.

Bu parametre PowerShell uzaktan iletişimini desteklemez. Bilgisayarınız uzak komutları çalıştıracak şekilde yapılandırılmamış olsa bile ComputerName parametresini kullanabilirsiniz.

Tür:String[]
Diğer adlar:cn
Position:Named
Default value:Local computer
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Confirm

komutunu çalıştırmadan Set-Serviceö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

-Description

Hizmet için yeni bir açıklama belirtir.

Hizmet açıklaması Bilgisayar Yönetimi, Hizmetler'de görünür. Açıklama, ServiceController nesnesinin Get-Service bir özelliği değildir. Hizmet açıklamasını görmek için, hizmeti temsil eden bir Win32_Service nesnesi döndüren öğesini kullanınGet-CimInstance.

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

-DisplayName

Hizmet için yeni bir görünen ad belirtir.

Not

Genellikle yalnızca Set-Service Windows hizmetlerinde çalışır, sürücüler üzerinde çalışmaz. Ancak, bir sürücünün adını belirtirseniz, Set-Service sürücüyü hedefleyebilir.

Tür:String
Diğer adlar:DN
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-InputObject

Değiştirecek hizmeti temsil eden bir ServiceController nesnesi belirtir. Nesnesini içeren bir değişken girin veya nesneyi alan bir komut veya ifade yazın, örneğin bir Get-Service komut. bir hizmet nesnesini Set-Serviceadresine göndermek için işlem hattını kullanabilirsiniz.

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

-Name

Değiştirilecek hizmetin hizmet adını belirtir. Joker karakterlere izin verilmez. İşlem hattını kullanarak hizmetine bir hizmet adı Set-Servicegönderebilirsiniz.

Not

Genellikle yalnızca Set-Service Windows hizmetlerinde çalışır, sürücüler üzerinde çalışmaz. Ancak, bir sürücünün adını belirtirseniz, Set-Service sürücüyü hedefleyebilir.

Tür:String
Diğer adlar:ServiceName, SN
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-PassThru

Değiştirilen hizmetleri temsil eden bir ServiceController nesnesi döndürür. Varsayılan olarak, Set-Service herhangi bir çıkış oluşturmaz.

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

-StartupType

Hizmetin başlangıç türünü ayarlar. Bu parametrenin kabul edilebilir değerleri şunlardır:

  • Otomatik - Hizmet, işletim sistemi tarafından, sistem başlatma sırasında başlatılır veya 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.
  • Devre dışı - Hizmet devre dışı bırakıldı ve bir kullanıcı veya uygulama tarafından başlatılamıyor.
  • El ile - Hizmet yalnızca el ile, kullanıcı tarafından, Service Control Manager kullanılarak veya bir uygulama tarafından başlatılır.
  • Önyükleme - Hizmetin sistem yükleyicisi tarafından başlatılan bir cihaz sürücüsü olduğunu gösterir. Bu değer yalnızca cihaz sürücüleri için geçerlidir.
  • Sistem - Hizmetin 'IOInitSystem()' işlevi tarafından başlatılan bir cihaz sürücüsü olduğunu gösterir. Bu değer yalnızca cihaz sürücüleri için geçerlidir.

Varsayılan değer Otomatik'tir.

Tür:ServiceStartMode
Diğer adlar:StartMode, SM, ST
Kabul edilen değerler:Boot, System, Automatic, Manual, Disabled
Position:Named
Default value:Automatic
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Status

Hizmetin durumunu belirtir.

Bu parametre için kabul edilebilir değerler aşağıdaki gibidir:

  • Duraklatıldı. Hizmeti askıya alır.
  • Çalışıyor. Hizmeti başlatır.
  • Durduruldu. Hizmeti durdurur.
Tür:String
Kabul edilen değerler:Paused, Running, Stopped
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-WhatIf

Çalıştırılırsa Set-Service ne olacağını gösterir. Cmdlet çalıştırılmıyor.

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 bir ServiceController nesnesi döndürür.

Notlar

Set-Service yükseltilmiş izinler gerektirir. Yönetici olarak çalıştır seçeneğini kullanın.

Set-Service yalnızca geçerli kullanıcının hizmetleri yönetme izinleri olduğunda hizmetleri denetleyebiliyor. Bir komut düzgün çalışmıyorsa gerekli izinlere sahip olmayabilirsiniz.

Bir hizmetin hizmet adını veya görünen adını bulmak için kullanın Get-Service. Hizmet adları Ad sütununda, görünen adlar ise DisplayName sütunundadır.