Restart-Computer
Yerel ve uzak bilgisayarlarda işletim sistemini yeniden başlatır.
Syntax
DefaultSet (Varsayılan)
Restart-Computer
[[-ComputerName] <String[]>]
[-WsmanAuthentication <String>]
[-Credential]<PSCredential>]
[-Force]
[-Wait]
[-Timeout <Int32>]
[-For <WaitForServiceTypes>]
[-Delay <Int16>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Bu cmdlet yalnızca Windows platformunda kullanılabilir.
Restart-Computer cmdlet'i, yerel ve uzak bilgisayarlarda işletim sistemini yeniden başlatır.
Restart-Computer parametrelerini kullanarak yeniden başlatma işlemlerini çalıştırabilir, kimlik doğrulama düzeylerini ve alternatif kimlik bilgilerini belirtebilir, aynı anda çalışan işlemleri sınırlandırabilir ve hemen yeniden başlatmayı zorlayabilirsiniz.
Windows PowerShell 3.0'dan başlayarak, sonraki komutu çalıştırmadan önce yeniden başlatmanın tamamlanmasını bekleyebilirsiniz. Bekleme zaman aşımı ve sorgu aralığı belirtin ve yeniden başlatılan bilgisayarda belirli hizmetlerin kullanılabilir olmasını bekleyin. Bu özellik, betiklerde ve işlevlerde Restart-Computer kullanmayı pratik hale getirir.
Örnekler
Örnek 1: Yerel bilgisayarı yeniden başlatma
Restart-Computer yerel bilgisayarı yeniden başlatır.
Restart-Computer
Örnek 2: Birden çok bilgisayarı yeniden başlatma
Restart-Computer uzak ve yerel bilgisayarları yeniden başlatabilir.
ComputerName parametresi bir dizi bilgisayar adını kabul eder.
Restart-Computer -ComputerName Server01, Server02, localhost
Örnek 3: Metin dosyasından bilgisayar adlarını alma
Restart-Computer bir metin dosyasından bilgisayar adlarının listesini alır ve bilgisayarları yeniden başlatır.
ComputerName parametresi belirtilmedi. Ancak ilk konum parametresi olduğundan işlem hattına gönderilen metin dosyasındaki bilgisayar adlarını kabul eder.
Get-Content -Path C:\Domain01.txt | Restart-Computer
Get-Content, Domain01.txtbir metin dosyasından bilgisayar adlarının listesini almak için Path parametresini kullanır. Bilgisayar adları işlem hattına gönderilir.
Restart-Computer her bilgisayarı yeniden başlatır.
Örnek 4: Metin dosyasında listelenen bilgisayarların yeniden başlatılmasını zorlama
Bu örnek, Domain01.txt dosyasında listelenen bilgisayarların hemen yeniden başlatılmasını zorlar. Metin dosyasındaki bilgisayar adları bir değişkende depolanır.
Force parametresi hemen yeniden başlatmaya zorlar.
$Names = Get-Content -Path C:\Domain01.txt
$Creds = Get-Credential
Restart-Computer -ComputerName $Names -Credential $Creds -Force
Get-Content, Domain01.txtbir metin dosyasından bilgisayar adlarının listesini almak için Path parametresini kullanır. Bilgisayar adları $Namesdeğişkeninde depolanır.
Get-Credential sizden kullanıcı adı ve parola ister ve değerleri $Credsdeğişkeninde depolar.
Restart-Computer, ComputerName ve Credential parametrelerini değişkenleriyle kullanır.
Force parametresi, her bilgisayarın hemen yeniden başlatılmasına neden olur.
Örnek 6: Uzak bilgisayarı yeniden başlatın ve PowerShell'i bekleyin
Restart-Computer uzak bilgisayarı yeniden başlatır ve devam etmeden önce PowerShell'in yeniden başlatılan bilgisayarda kullanılabilir duruma gelmesi için 5 dakika (300 saniye) kadar bekler.
Restart-Computer -ComputerName Server01 -Wait -For PowerShell -Timeout 300 -Delay 2
Restart-Computer, Server01belirtmek için ComputerName parametresini kullanır.
Bekle parametresi yeniden başlatmanın tamamlanmasını bekler.
için, PowerShell'in uzak bilgisayarda komut çalıştırabileceğini belirtir.
Zaman Aşımı parametresi beş dakikalık beklemeyi belirtir.
Gecikme parametresi, uzak bilgisayarı yeniden başlatılıp başlatılmadığını belirlemek için iki saniyede bir sorgular.
Örnek 7: WsmanAuthentication kullanarak bilgisayarı yeniden başlatma
Restart-Computer
WsmanAuthentication mekanizmasını kullanarak uzak bilgisayarı yeniden başlatır.
Kerberos kimlik doğrulaması, geçerli kullanıcının uzak bilgisayarı yeniden başlatma izni olup olmadığını belirler. Daha fazla bilgi için bkz. AuthenticationMechanism.
Restart-Computer -ComputerName Server01 -WsmanAuthentication Kerberos
Restart-Computer uzak bilgisayarı belirtmek için ComputerName parametresini kullanır Server01.
WsmanAuthentication parametresi, kimlik doğrulama yöntemini kerberos olarak belirtir.
Parametreler
-ComputerName
Bir bilgisayar adı veya virgülle ayrılmış bir bilgisayar adı dizisi belirtir.
Restart-Computer işlem hattından veya değişkenlerden ComputerName nesnelerini kabul eder.
Uzak bilgisayarın NetBIOS adını, IP adresini veya tam nitelikli alan adını yazın. Yerel bilgisayarı belirtmek için bilgisayar adını, nokta .veya localhost yazın.
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.
ComputerName parametresi belirtilmezse, Restart-Computer yerel bilgisayarı yeniden başlatır.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Çin, __SUNUCU, Sunucu, IP Adresi |
Parametre kümeleri
(All)
| Position: | 0 |
| Zorunlu: | False |
| İş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 |
-Confirm
Restart-Computerç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
Bu eylemi yapma izni olan bir kullanıcı hesabı belirtir. Varsayılan değer mevcut kullanıcıdır.
User01 veya Domain01\User01gibi bir kullanıcı adı yazın veya cmdlet'i tarafından oluşturulan Get-Credential nesnesi girin. Bir kullanıcı adı yazarsanız parolayı girmeniz istenir.
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: | Current user |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | 1 |
| 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 |
-Delay
Saniye cinsinden sorguların sıklığını belirtir. PowerShell, for parametresi tarafından belirtilen hizmeti sorgulayarak hizmetin bilgisayar yeniden başlatıldıktan sonra kullanılabilir olup olmadığını belirler.
Bu parametre yalnızca Wait ve For parametreleriyle birlikte geçerlidir.
Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.
Gecikme parametresi belirtilmezse, Restart-Computer beş saniyelik bir gecikme kullanır.
Parametre özellikleri
| Tür: | Int16 |
| 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 |
-For
Bilgisayar yeniden başlatıldıktan sonra belirtilen hizmetin veya özelliğin kullanılabilir olmasını beklediğinden PowerShell'in davranışını belirtir. Bu parametre yalnızca Wait parametresiyle geçerlidir.
Bu parametre için kabul edilebilir değerler şunlardır:
- Varsayılan: PowerShell'in yeniden başlatılmasını bekler.
- PowerShell: Bilgisayardaki bir PowerShell uzak oturumunda komutları çalıştırabilir.
- WMI: Bilgisayar için Win32_ComputerSystem sorgusuna yanıt alır.
- WinRM: WS-Management kullanarak bilgisayarda uzak oturum oluşturabilir.
Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.
Parametre özellikleri
| Tür: | WaitForServiceTypes |
| Default value: | None |
| Kabul edilen değerler: | Wmi, WinRM, PowerShell |
| 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 |
-Force
Bilgisayarın hemen yeniden başlatılmasını zorlar.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | f |
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 |
-Timeout
Bekleme süresini saniye cinsinden belirtir. Zaman aşımı tamamlandığında, bilgisayarlar yeniden başlatılmasa bile Restart-Computer komut istemine döner.
Zaman Aşımı parametresi yalnızca Wait parametresiyle geçerlidir. Zaman Aşımı, Bekleme parametresinin süresiz bekleme süresini geçersiz kılar.
Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.
Parametre özellikleri
| Tür: | Int32 |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | TimeoutSec |
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 |
-Wait
Restart-Computer PowerShell istemini gizler ve bilgisayarlar yeniden başlatılana kadar işlem hattını engeller. Bu parametreyi bir betikte kullanarak bilgisayarları yeniden başlatabilir ve yeniden başlatma tamamlandığında işlemeye devam edebilirsiniz.
Bekle parametresi, bilgisayarların yeniden başlatılması için süresiz olarak bekler. Yeniden başlatılan bilgisayarlarda belirli hizmetlerin kullanılabilir olmasını beklemek için zamanlamayı ayarlamak ve ve Gecikme parametrelerini ayarlamak üzere Zaman Aşımı kullanabilirsiniz.
yerel bilgisayarı yeniden başlatırken Bekleme parametresi geçerli değildir.
ComputerName parametresinin değeri uzak bilgisayarların ve yerel bilgisayarın adlarını içeriyorsa, Restart-Computer yerel bilgisayarda Bekleme için sonlandırılmayan bir hata oluşturur, ancak uzak bilgisayarların yeniden başlatılmasını bekler.
Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.
Parametre özellikleri
| Tür: | SwitchParameter |
| 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 |
-WhatIf
Restart-Computer çalıştırıldığında ne olacağını gösterir.
Restart-Computer 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 |
-WsmanAuthentication
Kullanıcı kimlik bilgilerinin kimliğini doğrulamak için kullanılan mekanizmayı belirtir. Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.
Bu parametre için kabul edilebilir değerler şunlardır: Basic, CredSSP, Default, Digest, Kerberosve Negotiate.
Daha fazla bilgi için bkz. AuthenticationMechanism.
Uyarı
Kimlik Bilgileri Güvenlik Hizmeti Sağlayıcısı (CredSSP) kimlik doğrulaması, kullanıcı kimlik bilgilerinin kimlik doğrulaması için uzak bir bilgisayara geçirildiği, uzak ağ paylaşımına erişme gibi birden fazla kaynakta kimlik doğrulaması gerektiren komutlar için tasarlanmıştır. Bu mekanizma, uzak işlemin güvenlik riskini artırır. Uzak bilgisayarın güvenliği aşılırsa, bu bilgisayara geçirilen kimlik bilgileri ağ oturumunu denetlemek için kullanılabilir.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Kabul edilen değerler: | Basic, CredSSP, Default, Digest, Kerberos, Negotiate |
| 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 |
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
String
Bilgisayar adı içeren bir dizeyi bu cmdlet'e aktarabilirsiniz.
Çıkışlar
None
Bu cmdlet çıkış döndürmez.
Notlar
- Windows'da
Restart-Computer, Windows Yönetim Araçları (WMI) Win32_OperatingSystem sınıfının Win32Shutdown yöntemini kullanır. Bu yöntem, makineyi yeniden başlatmak için kullanılan kullanıcı hesabı için SeShutdownPrivilege ayrıcalığının etkinleştirilmesini gerektirir. - Linux ve Mac OS'ta
Restart-Computer/sbin/shutdownbash aracını kullanır.