Set-Service
Bir hizmeti başlatır, durdurur ve askıya alır ve özelliklerini değiştirir.
Syntax
Name (Varsayılan)
Set-Service
[-Name] <String>
[-ComputerName <String[]>]
[-DisplayName <String>]
[-Description <String>]
[-StartupType <ServiceStartMode>]
[-Status <String>]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
InputObject
Set-Service
[-ComputerName <String[]>]
[-DisplayName <String>]
[-Description <String>]
[-StartupType <ServiceStartMode>]
[-Status <String>]
[-InputObject <ServiceController>]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Set-Service cmdlet'i, bir hizmetin özelliklerini, örneğin Durum, Açıklama, Görünen Adve Başlangıç Türü, değiştirir.
Set-Service hizmeti başlatabilir, durdurabilir, askıya alabilir veya duraklatabilirsiniz. Bir hizmeti tanımlamak için hizmet adını girin veya bir hizmet nesnesi gönderin. alternatif olarak, Set-Serviceiçin işlem hattının aşağısına bir hizmet adı veya hizmet nesnesi de gönderebilirsiniz.
Örnekler
Örnek 1: Görünen adı değiştirme
Bu örnekte, hizmetin görünen adı değiştirilir. Orijinal görünen adı görüntülemek için Get-Service'i kullanın.
Set-Service -Name LanmanWorkstation -DisplayName "LanMan Workstation"
Set-Service, hizmetin adını belirtmek için Adı parametresini kullanır LanmanWorkstation.
DisplayName parametresi, yeni görünen ad olarak LanMan Workstationbelirtir.
Ö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
Adı parametresini kullanarak hizmetin adını BITSbelirtir.
StartupType parametresi, hizmeti Otomatikolarak ayarlar.
Get-Service, BITS hizmetini belirtmek için Name parametresini kullanır ve nesneyi işlem hattına gönderir.
Select-Object, BITS hizmetinin durumunu görüntülemek için Özelliği 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'i, hizmetin Açıklamaiçeren bir Win32_Service nesnesi döndürdüğü için 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 nesneyi Format-List üzerinden işlem hattına gönderir ve hizmetin adını ve açıklamasını gösterir. 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 Adı parametresini kullanır.
Açıklaması 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-Service hizmeti belirtmek için Adı parametresini kullanır WinRM.
Durumu parametresi, hizmeti başlatmak için Çalıştırılı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 örnek, hizmeti durdurmak için işlem hattını kullanır.
Get-Service -Name Schedule | Set-Service -Status Paused
Get-Service, Zamanlama hizmetini belirtmek için Name parametresini kullanır ve nesneyi işlem hattına gönderir.
Set-Service hizmeti 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-Service hizmeti belirtmek için Adı parametresini kullanır Zamanlama. nesnesi $Sdeğişkeninde depolanır.
Set-Service
InputObject parametresini kullanır ve $Sdepolanan nesneyi belirtir.
Durumu parametresi hizmeti Durdurolarak ayarlar.
Örnek 7: Birden çok hizmet için başlangıç türünü ayarlama
Set-Service cmdlet'i aynı anda yalnızca bir hizmet adını kabul eder. Birden çok hizmetin yapılandırmasını değiştirmek için birden çok hizmeti Set-Service'a iletebilirsiniz.
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.
Parametre özellikleri
| Tür: | String[] |
| Default value: | Local computer |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Çin |
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: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Confirm
Set-Serviceç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 |
-Description
Hizmet için yeni bir açıklama belirtir.
Hizmet açıklaması, Bilgisayar Yönetimi, Hizmetleriçinde görünür.
Açıklaması, Get-ServiceServiceController nesnesinin özelliği değildir. Hizmet açıklamasını görmek için, hizmeti temsil eden bir Get-CimInstance nesnesini döndüren 'ı kullanın.
Parametre özellikleri
| Tür: | String |
| 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 |
-DisplayName
Hizmet için yeni bir görünen ad belirtir.
Uyarı
Genellikle Set-Service yalnızca 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.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | DN |
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
Değiştireceği hizmeti temsil eden bir ServiceController nesnesi belirtir. Nesnesini içeren bir değişken girin veya Get-Service komutu gibi nesneyi alan bir komut veya ifade yazın. İşlem hattını bir hizmet nesnesini Set-Service'a göndermek için kullanabilirsiniz.
Parametre özellikleri
| Tür: | ServiceController |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
InputObject
| Position: | Named |
| Zorunlu: | False |
| İş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
Değiştirilecek hizmetin hizmet adını belirtir. Joker karakterlere izin verilmez. Bir hizmet adını Set-Service'a göndermek için işlem hattını kullanabilirsiniz.
Uyarı
Genellikle Set-Service yalnızca 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.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Servis Adı, SN |
Parametre kümeleri
Name
| 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
Değiştirilen hizmetleri temsil eden bir ServiceController nesnesi döndürür. Varsayılan olarak, Set-Service herhangi bir çıkış oluşturmaz.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| 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 |
-StartupType
Hizmetin başlangıç türünü ayarlar. Bu parametre için kabul edilebilir değerler şunlardır:
-
Automatic- 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. -
Disabled- Hizmet devre dışıdır ve bir kullanıcı veya uygulama tarafından başlatılamaz. -
Manual- Hizmet yalnızca el ile, kullanıcı tarafından, Hizmet Denetim Yöneticisi kullanılarak veya bir uygulama tarafından başlatılır. -
Boot- 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. -
System- 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 şudur: Automatic.
Parametre özellikleri
| Tür: | ServiceStartMode |
| Default value: | Automatic |
| Kabul edilen değerler: | Boot, System, Automatic, Manual, Disabled |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | StartMode, SM, ST |
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 |
-Status
Hizmetin durumunu belirtir.
Bu parametre için kabul edilebilir değerler aşağıdaki gibidir:
-
Paused. Hizmeti askıya alır. -
Running. Hizmeti başlatır. -
Stopped. Hizmeti durdurur.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Kabul edilen değerler: | Paused, Running, Stopped |
| 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
Set-Service çalıştırıldığında ne olacağını gösterir. Cmdlet çalıştırılmıyor.
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 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 sadece geçerli kullanıcının hizmetleri yönetme iznine sahip olduğu durumlarda hizmetleri denetleyebilir. 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 Get-Servicekullanın. Hizmet adları Adı sütununda ve görünen adlar DisplayName sütunundadır.
