New-Service
Yeni bir Windows hizmeti oluşturur.
Syntax
Default (Varsayılan)
New-Service
[-Name] <String>
[-BinaryPathName] <String>
[-DisplayName <String>]
[-Description <String>]
[-StartupType <ServiceStartMode>]
[-Credential <PSCredential>]
[-DependsOn <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
New-Service cmdlet'i, kayıt defterinde ve hizmet veritabanında bir Windows hizmeti için yeni bir girdi oluşturur. Yeni bir hizmet, hizmet sırasında çalışan yürütülebilir bir dosya gerektirir.
Bu cmdlet'in parametreleri hizmetin görünen adını, açıklamasını, başlangıç türünü ve bağımlılıklarını ayarlamanıza olanak sağlar.
Örnekler
Örnek 1: Hizmet oluşturma
New-Service -Name "TestService" -BinaryPathName 'C:\WINDOWS\System32\svchost.exe -k netsvcs'
Bu komut TestService adlı bir hizmet oluşturur.
Örnek 2: Açıklama, başlangıç türü ve görünen ad içeren bir hizmet oluşturma
$params = @{
Name = "TestService"
BinaryPathName = 'C:\WINDOWS\System32\svchost.exe -k netsvcs'
DependsOn = "NetLogon"
DisplayName = "Test Service"
StartupType = "Manual"
Description = "This is a test service."
}
New-Service @params
Bu komut TestService adlı bir hizmet oluşturur. Yeni hizmet için bir açıklama, başlangıç türü ve görünen ad belirtmek üzere New-Service parametrelerini kullanır.
Örnek 3: Yeni hizmeti görüntüleme
Get-CimInstance -ClassName Win32_Service -Filter "Name='testservice'"
ExitCode : 0
Name : testservice
ProcessId : 0
StartMode : Auto
State : Stopped
Status : OK
Bu komut, yeni hizmetin Get-CimInstance nesnesini almak için kullanır. Bu nesne başlangıç modunu ve hizmet açıklamasını içerir.
Örnek 4: Hizmeti silme
sc.exe delete TestService
# - or -
(Get-CimInstance -Class Win32_Service -Filter "name='TestService'").Delete()
Bu örnekte TestService hizmetini silmenin iki yolu gösterilmektedir. İlk komut Sc.exesilme seçeneğini kullanır. İkinci komut, döndüren Win32_Service nesnelerinin Get-CimInstance yöntemini kullanır.
Parametreler
-BinaryPathName
Hizmet için yürütülebilir dosyanın yolunu belirtir. Bu parametre gereklidir.
Hizmet ikili dosyasının tam yolu. Yol bir boşluk içeriyorsa, doğru yorumlanması için tırnak içine alınmalıdır. Örneğin, D:\my share\myservice.exe'"D:\my share\myservice.exe"'olarak belirtilmelidir.
Yol, otomatik başlatma hizmetinin bağımsız değişkenlerini de içerebilir. Örneğin, '"D:\my share\myservice.exe" arg1 arg2'. Bu bağımsız değişkenler hizmet giriş noktasına geçirilir.
Daha fazla bilgi için CreateServiceW API'sinin lpBinaryPathName parametresine bakın.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | 1 |
| Zorunlu: | True |
| İş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 |
-Confirm
Cmdlet'i ç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?.
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 |
-DependsOn
Yeni hizmetin bağımlı olduğu diğer hizmetlerin adlarını belirtir. Birden çok hizmet adı girmek için adları ayırmak için virgül 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 |
-Description
Hizmetin açıklamasını belirtir.
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 bir görünen ad belirtir.
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 |
-Name
Hizmetin adını belirtir. Bu parametre gereklidir.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Servis Adı |
Parametre kümeleri
(All)
| Position: | 0 |
| Zorunlu: | True |
| İş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:
- otomatik - Hizmet, işletim sistemi tarafından sistem başlatma sırasında başlatılır veya başlatılmıştı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 İle - Hizmet yalnızca bir kullanıcı tarafından, Hizmet Denetim Yöneticisi kullanılarak veya bir uygulama tarafından el ile 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.
- 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 Otomatik değeridir.
Parametre özellikleri
| Tür: | ServiceStartMode |
| Default value: | Automatic |
| Kabul edilen değerler: | Boot, System, Automatic, Manual, Disabled |
| 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
Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmaz.
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
None
Nesneleri bu cmdlet'e yöneltemezsiniz.
Çıkışlar
ServiceController
Bu cmdlet, yeni hizmeti temsil eden bir nesne döndürür.
Notlar
Bu cmdlet'i çalıştırmak için Yönetici olarak çalıştır seçeneğini kullanarak PowerShell'i başlatın.
Bir hizmeti silmek için Sc.exekullanın veya hizmeti temsil eden Get-CimInstance nesnesini almak için cmdlet'ini kullanın ve ardından hizmeti silmek için Delete yöntemini kullanın.
Get-Service döndüren nesnenin silme yöntemi yok.
