Aracılığıyla paylaş

Restart-Computer

Modül:
Microsoft.PowerShell.Management

Yerel ve uzak bilgisayarlarda işletim sistemini yeniden başlatır.

Sözdizimi

Restart-Computer
       [-WsmanAuthentication <String>]
       [[-ComputerName] <String[]>]
       [[-Credential]<PSCredential>]
       [-Force]
       [-Wait]
       [-Timeout <Int32>]
       [-For <WaitForServiceTypes>]
       [-Delay <Int16>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

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.

PowerShell 7.1'de Linux ve macOS için Restart-Computer eklendi. Windows olmayan platformlarda yalnızca WhatIf, Confirm ve CommonParameters parametreleri bulunur. Cmdlet yalnızca /sbin/shutdownyerel komutunu çağırır.

Ö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.

Bu parametre yalnızca Windows platformlarında kullanılabilir.

Tür:String[]
Diğer adlar:CN, __SERVER, Server, IPAddress
Position:0
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Confirm

Restart-Computerçalıştırmadan ö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

-Credential

Bu eylemi yapma izni olan bir kullanıcı hesabı belirtir. Varsayılan değer geçerli 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.

Not

SecureString veri koruması hakkında daha fazla bilgi için bkz. SecureString ne kadar güvenli?.

Bu parametre yalnızca Windows platformlarında kullanılabilir.

Tür:PSCredential
Position:1
Default value:Current user
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

Bu parametre yalnızca Windows platformlarında kullanılabilir.

Tür:Int16
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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 bir 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. Bu parametre yalnızca Windows platformlarında kullanılabilir.

Tür:WaitForServiceTypes
Kabul edilen değerler:Wmi, WinRM, PowerShell
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Force

Bilgisayarın hemen yeniden başlatılmasını zorlar.

Bu parametre yalnızca Windows platformlarında kullanılabilir.

Tür:SwitchParameter
Diğer adlar:f
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

Bu parametre yalnızca Windows platformlarında kullanılabilir.

Tür:Int32
Diğer adlar:TimeoutSec
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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. Bu parametre yalnızca Windows platformlarında kullanılabilir.

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

-WhatIf

Restart-Computer çalıştırıldığında ne olacağını gösterir. Restart-Computer 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

-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.

Bu parametre yalnızca Windows platformlarında kullanılabilir.

Tür:String
Kabul edilen değerler:Basic, CredSSP, Default, Digest, Kerberos, Negotiate
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

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.
  • Bu cmdlet, PowerShell 7.1'de Linux ve macOS için eklenmiştir. Linux ve macOS'ta Restart-Computer/sbin/shutdown bash aracını kullanır.