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>
[-DisplayName <String>]
[-Credential <PSCredential>]
[-Description <String>]
[-StartupType <ServiceStartupType>]
[-Status <String>]
[-SecurityDescriptorSddl <String>]
[-Force]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
InputObject
Set-Service
[-InputObject] <ServiceController>
[-DisplayName <String>]
[-Credential <PSCredential>]
[-Description <String>]
[-StartupType <ServiceStartupType>]
[-SecurityDescriptorSddl <String>]
[-Status <String>]
[-Force]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Bu cmdlet yalnızca Windows platformunda kullanılabilir.
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: Uzak sistemde bir hizmeti durdurma
Bu örnek, uzak bilgisayardaki bir hizmeti durdurur. Daha fazla bilgi için bkz. Invoke-Command.
$Cred = Get-Credential
$S = Get-Service -Name Schedule
Invoke-Command -ComputerName server01.contoso.com -Credential $Cred -ScriptBlock {
Set-Service -InputObject $S -Status Stopped
}
Get-Credential kullanıcı adı ve parola ister ve kimlik bilgilerini $Cred değişkeninde depolar.
Get-Service, Zamanlama hizmetini belirtmek için Adı parametresini kullanır. nesnesi $Sdeğişkeninde depolanır.
Invoke-Command uzak bir bilgisayar belirtmek için ComputerName parametresini kullanır.
Kimlik Bilgisi parametresi, bilgisayarda oturum açmak için $Cred değişkenini kullanır.
ScriptBlockSet-Serviceçağırır.
InputObject parametresi, $Sdepolanan hizmet nesnesini belirtir.
Durumu parametresi hizmeti Durdurolarak ayarlar.
Örnek 8: Hizmetin kimlik bilgilerini değiştirme
Bu örnek, bir hizmeti yönetmek için kullanılan kimlik bilgilerini değiştirir.
$credential = Get-Credential
Set-Service -Name Schedule -Credential $credential
Get-Credential kullanıcı adı ve parola ister ve kimlik bilgilerini $credential değişkeninde depolar.
Set-Service, Zamanlama hizmetini belirtmek için Adı parametresini kullanır.
Kimlik Bilgisi parametresi $credential değişkenini kullanır ve Zamanlama hizmetini güncelleştirir.
Örnek 9: Bir hizmetin SecurityDescriptor'ını değiştirme
Bu örnek, bir hizmetin SecurityDescriptordeğiştirir.
$SDDL = "D:(A;;CCLCSWRPWPDTLOCRRC;;;SY)(A;;CCDCLCSWRPWPDTLOCRSDRCWDWO;;;BA)(A;;CCLCSWLOCRRC;;;SU)"
Set-Service -Name "BITS" -SecurityDescriptorSddl $SDDL
SecurityDescriptor$SDDL değişkeninde depolanır.
Set-Service, BITS hizmetini belirtmek için Adı parametresini kullanır.
SecurityDescriptorSddl parametresi, $SDDL hizmetinin SecurityDescriptor değiştirmek için kullanır.
Örnek 10: 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
-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 |
-Credential
hizmet tarafından Hizmet Oturum Açma Hesabıolarak kullanılan hesabı belirtir.
User01 veya Domain01\User01gibi bir kullanıcı adı yazın ya da cmdlet'i tarafından oluşturulmuş bir Get-Credential nesnesi girin. Bir kullanıcı adı yazarsanız, bu cmdlet sizden parola ister.
Kimlik bilgileri bir PSCredential nesnesinde depolanır ve parola SecureStringolarak depolanır.
Uyarı
SecureString veri koruması hakkında daha fazla bilgi için bkz. SecureString ne kadar güvenli?.
Bu parametre PowerShell 6.0'da kullanıma sunulmuştur.
Parametre özellikleri
| Tür: | PSCredential |
| 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 |
-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 |
-Force
Hizmetin Durdurma modunu belirtir. Bu parametre yalnızca -Status Stopped kullanıldığında çalışır. Etkinleştirilirse, Set-Service hedef hizmet durdurulmadan önce bağımlı hizmetleri durdurur. Varsayılan olarak, diğer çalışan hizmetler hedef hizmete bağımlı olduğunda istisnalar tetiklenir.
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 |
-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: | 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
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 |
-SecurityDescriptorSddl
Hizmet için SecurityDescriptorSddl biçiminde belirtir. Bu parametreyle Set-Service çağıran hesap WRITE_DAC ve WRITE_OWNER izinlerine sahip olmalıdır. Daha fazla bilgi için bkz. Hizmet güvenliği ve erişim hakları.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Sd |
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ıç modunu belirtir.
Bu parametre için kabul edilebilir değerler aşağıdaki gibidir:
-
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. -
AutomaticDelayedStart- Sistem önyüklemeden kısa süre sonra başlar. -
Disabled- Hizmet devre dışıdır ve bir kullanıcı veya uygulama tarafından başlatılamaz. -
InvalidValue- Hiçbir etkisi yoktur. Cmdlet bir hata döndürmez, ancak hizmetin StartupType değeri değiştirilmez. -
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.
Parametre özellikleri
| Tür: | ServiceStartupType |
| Default value: | None |
| Kabul edilen değerler: | Automatic, AutomaticDelayedStart, Disabled, InvalidValue, Manual |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | StartMode, SM, ST, StartType |
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
Bu cmdlet yalnızca Windows platformlarında kullanılabilir.
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.
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.
