Restart-Computer
Yerel ve uzak bilgisayarlarda işletim sistemini yeniden başlatır.
Syntax
DefaultSet (Varsayılan)
Restart-Computer
[[-ComputerName] <String[]>]
[[-Credential] <PSCredential>]
[-DcomAuthentication <AuthenticationLevel>]
[-Impersonation <ImpersonationLevel>]
[-WsmanAuthentication <String>]
[-Protocol <String>]
[-Force]
[-Wait]
[-Timeout <Int32>]
[-For <WaitForServiceTypes>]
[-Delay <Int16>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
AsJobSet
Restart-Computer
[[-ComputerName] <String[]>]
[[-Credential] <PSCredential>]
[-AsJob]
[-DcomAuthentication <AuthenticationLevel>]
[-Impersonation <ImpersonationLevel>]
[-Force]
[-ThrottleLimit <Int32>]
[-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 arka plan işi olarak ç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.
Dağıtılmış Bileşen Nesne Modeli (DCOM) çağrılarının bir kurumsal güvenlik duvarı gibi engellenmesi durumunda bilgisayarı yeniden başlatmak için WS-Management (WSMan) protokolunu kullanabilirsiniz. Daha fazla bilgi için bkz. protokol WS-Management.
Bu cmdlet yalnızca bir komutta AsJob parametresini kullandığınızda Windows PowerShell uzaktan iletişimini gerektirir.
Ö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: Bilgisayarları arka plan işi olarak yeniden başlatma
Bu komutlar, iki uzak bilgisayarda arka plan işi olarak bir Restart-Computer komutu çalıştırır ve ardından sonuçları alır.
asjob
$Job = Restart-Computer -ComputerName "Server01", "Server02" -AsJob
$Job | Receive-Job
Restart-Computer, Server01 ve Server02belirtmek için ComputerName parametresini kullanır.
AsJob parametresi, komutu arka plan işi olarak çalıştırır. İş nesnesi $Job değişkeninde depolanır.
$Job işlem hattını sonuçları alan Receive-Job cmdlet'ine gönderilir.
Örnek 4: Uzak bilgisayarı yeniden başlatma
Restart-Computer, özelleştirilmiş kimliğe bürünme ve kimlik doğrulama ayarlarıyla uzak bilgisayarı yeniden başlatır.
Restart-Computer -ComputerName Server01 -Impersonation Anonymous -DcomAuthentication PacketIntegrity
Restart-Computer, Server01belirtmek için ComputerName parametresini kullanır.
Kimliğe Bürünme parametresi, istek sahibinin kimliğini gizlemek için Anonim'i belirtir.
DcomAuthentication parametresi, bağlantının kimlik doğrulama düzeyi olarak PacketIntegrity'yi belirtir.
Örnek 5: 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 ve ThrottleLimit parametresi eşzamanlı bağlantı sayısını sınırlar.
$Names = Get-Content -Path C:\Domain01.txt
$Creds = Get-Credential
Restart-Computer -ComputerName $Names -Credential $Creds -Force -ThrottleLimit 10
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.
ThrottleLimit parametresi komutu 10 eşzamanlı bağlantıyla sınırlar.
Ö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: WSMan Protokolü kullanarak bilgisayarı yeniden başlatma
Restart-Computer, varsayılan DCOM yerine WSMan protokolünün kullanılmasıyla 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.
Bu ayarlar, DCOM engellendiğinden DCOM tabanlı yeniden başlatmaların başarısız olduğu kuruluşlar için tasarlanmıştır. Örneğin, bir güvenlik duvarı tarafından.
Restart-Computer -ComputerName Server01 -Protocol WSMan -WsmanAuthentication Kerberos
Restart-Computer uzak bilgisayarı belirtmek için ComputerName parametresini kullanır Server01.
Protokolü parametresi, WSMan protokolunun kullanılacağını belirtir.
WsmanAuthentication parametresi, kimlik doğrulama yöntemini kerberos olarak belirtir.
Parametreler
-AsJob
Restart-Computer arka plan işi olarak çalıştığını gösterir.
Bu parametreyi kullanmak için yerel ve uzak bilgisayarların uzaktan iletişim için yapılandırılması gerekir. Windows Vista ve Windows işletim sisteminin sonraki sürümlerinde, Yönetici olarak çalıştır seçeneğini kullanarak PowerShell'i açmanız gerekir. Daha fazla bilgi için bkz. about_Remote_Requirements.
AsJob parametresini belirttiğinizde, komut hemen arka plan işini temsil eden bir nesne döndürür. İş tamamlarken oturumda çalışmaya devam edebilirsiniz. İş yerel bilgisayarda oluşturulur ve uzak bilgisayarlardan alınan sonuçlar otomatik olarak yerel bilgisayara döndürülür. İşi yönetmek için İşi cmdlet'lerini kullanın. İş sonuçlarını almak için Receive-Job cmdlet'ini kullanın.
Windows PowerShell arka plan işleri hakkında daha fazla bilgi için bkz. about_Jobs ve about_Remote_Jobs.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
AsJobSet
| 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 |
-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 |
-DcomAuthentication
WMI bağlantısı için kullanılan kimlik doğrulama düzeyini belirtir.
Restart-Computer WMI kullanır.
Geçerli değerler şunlardır:
- Arama: Arama düzeyi COM kimlik doğrulaması
- Connect: Bağlantı düzeyi COM kimlik doğrulaması
- Varsayılan: Windows Kimlik Doğrulaması
- Hiçbiri: COM kimlik doğrulaması yok
- Paket: Paket düzeyi COM kimlik doğrulaması.
- PacketIntegrity: Paket Bütünlüğü düzeyinde COM kimlik doğrulaması
- PacketPrivacy: Paket Gizlilik düzeyi COM kimlik doğrulaması.
- Değişmemiş: Kimlik doğrulama düzeyi önceki komutla aynıdır.
Daha fazla bilgi için bkz. AuthenticationLevel Sabit Listesi.
Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.
Parametre özellikleri
| Tür: | AuthenticationLevel |
| Default value: | None |
| Kabul edilen değerler: | Default, None, Connect, Call, Packet, PacketIntegrity, PacketPrivacy, Unchanged |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Kimlik doğrulama |
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 |
-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
DefaultSet
| 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 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.
Parametre özellikleri
| Tür: | WaitForServiceTypes |
| Default value: | None |
| Kabul edilen değerler: | Wmi, WinRM, PowerShell |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
DefaultSet
| 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 |
-Impersonation
Bu cmdlet'in WMI'yi çağırmak için kullandığı kimliğe bürünme düzeyini belirtir.
Restart-Computer WMI kullanır.
Bu parametre için kabul edilebilir değerler şunlardır:
- Varsayılan: Varsayılan kimliğe bürünme. Ada rağmen, bu varsayılan değer değildir.
- anonim
: Çağıranın kimliğini gizler. - Tanımla: Nesnelerin çağıranın kimlik bilgilerini sorgulamasına izin verir.
- Kimliğe Bürün: Nesnelerin çağıranın kimlik bilgilerini kullanmasına izin verir.
Parametre özellikleri
| Tür: | ImpersonationLevel |
| Default value: | None |
| Kabul edilen değerler: | Default, Anonymous, Identify, Impersonate, Delegate |
| 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 |
-Protocol
Bilgisayarları yeniden başlatmak için hangi protokolün kullanılacağını belirtir. Geçerli değerler
Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Kabul edilen değerler: | DCOM, WSMan |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
DefaultSet
| 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 |
-ThrottleLimit
Bu komutu çalıştırmak için oluşturulabilecek en fazla eşzamanlı bağlantı sayısını belirtir. Hız sınırlaması yalnızca geçerli komut için geçerlidir, oturuma veya bilgisayara uygulanmaz.
ThrottleLimit parametresi belirtilmezse veya 0 değeri kullanılırsa, Restart-Computer en fazla 32 eşzamanlı bağlantı kullanır.
Parametre özellikleri
| Tür: | Int32 |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
AsJobSet
| 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
DefaultSet
| 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
DefaultSet
| 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
DefaultSet
| 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
Varsayılan olarak, bu cmdlet çıkış döndürmez.
System.Management.Automation.RemotingJob
AsJob parametresini kullandığınızda, bu cmdlet bir iş nesnesi döndürür.
Notlar
- Windows win32Shutdown
Restart-Computeryöntemini Win32_OperatingSystem sınıfını 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.
Windows PowerShell 2.0'da AsJob parametresi, uzak bilgisayarları yeniden başlatırken veya durdururken güvenilir bir şekilde çalışmaz. Windows PowerShell 3.0'da bu sorunu çözmek için uygulama değiştirilir.
