Restart-Computer

Modul:

Microsoft.PowerShell.Management

Menghidupkan ulang sistem operasi pada komputer lokal dan jarak jauh.

Sintaks

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

Deskripsi

Cmdlet Restart-Computer memulai ulang sistem operasi pada komputer lokal dan jarak jauh.

Anda dapat menggunakan parameter Restart-Computer untuk menjalankan operasi hidupkan ulang, untuk menentukan tingkat autentikasi dan kredensial alternatif, untuk membatasi operasi yang berjalan pada saat yang sama, dan untuk memaksa mulai ulang segera.

Dimulai di Windows PowerShell 3.0, Anda dapat menunggu mulai ulang selesai sebelum menjalankan perintah berikutnya. Tentukan batas waktu tunggu dan interval kueri, dan tunggu layanan tertentu tersedia di komputer yang sudah di-restart. Fitur ini membuatnya praktis untuk menggunakan Restart-Computer dalam skrip dan fungsi.

Di PowerShell 7.1, Restart-Computer ditambahkan untuk Linux dan macOS. Platform non-Windows hanya memiliki parameter WhatIf, Confirm, dan CommonParameters . Cmdlet hanya memanggil perintah asli /sbin/shutdown.

Contoh

Contoh 1: Mulai ulang komputer lokal

Restart-Computer menghidupkan ulang komputer lokal.

Restart-Computer

Contoh 2: Menghidupkan ulang beberapa komputer

Restart-Computer dapat memulai ulang komputer jarak jauh dan lokal. Parameter ComputerName menerima array nama komputer.

Restart-Computer -ComputerName Server01, Server02, localhost

Contoh 3: Mendapatkan nama komputer dari file teks

Restart-Computer mendapatkan daftar nama komputer dari file teks dan memulai ulang komputer. Parameter ComputerName tidak ditentukan. Tetapi karena ini adalah parameter posisi pertama, ia menerima nama komputer dari file teks yang diproses melalui pipeline.

Get-Content -Path C:\Domain01.txt | Restart-Computer

Get-Content menggunakan parameter Jalur untuk mendapatkan daftar nama komputer dari file teks, Domain01.txt. Nama komputer dikirim ke pipeline. Restart-Computer menghidupkan ulang setiap komputer.

Contoh 4: Paksa hidupkan ulang komputer yang tercantum dalam file teks

Contoh ini memaksa mulai ulang segera komputer yang tercantum dalam file Domain01.txt. Nama komputer dari file teks disimpan dalam variabel. Parameter Force mengharuskan restart segera.

$Names = Get-Content -Path C:\Domain01.txt
$Creds = Get-Credential
Restart-Computer -ComputerName $Names -Credential $Creds -Force

Get-Content menggunakan parameter Jalur untuk mendapatkan daftar nama komputer dari file teks, Domain01.txt. Nama komputer disimpan dalam variabel $Names. Get-Credential meminta nama pengguna dan kata sandi dan menyimpan nilai dalam variabel $Creds. Restart-Computer menggunakan parameter ComputerName dan Credential dengan variabelnya. Parameter Force menyebabkan setiap komputer segera dimulai ulang.

Contoh 6: Mulai ulang komputer jarak jauh dan tunggu PowerShell

Restart-Computer menghidupkan ulang komputer jarak jauh lalu menunggu hingga 5 menit (300 detik) agar PowerShell tersedia di komputer yang dimulai ulang sebelum dilanjutkan.

Restart-Computer -ComputerName Server01 -Wait -For PowerShell -Timeout 300 -Delay 2

Restart-Computer menggunakan parameter ComputerName untuk menentukan Server01. Parameter Menunggu menunggu hingga memulai ulang selesai. Untuk menentukan bahwa PowerShell dapat menjalankan perintah di komputer jarak jauh. Parameter Batas Waktu menentukan waktu tunggu lima menit. Parameter Penundaan memeriksa komputer jarak jauh setiap dua detik untuk menentukan apakah komputer tersebut telah dimulai ulang.

Contoh 7: Menghidupkan ulang komputer dengan menggunakan WsmanAuthentication

Restart-Computer memulai ulang komputer jarak jauh menggunakan mekanisme WsmanAuthentication. Autentikasi Kerberos menentukan apakah pengguna saat ini memiliki izin untuk memulai ulang komputer jarak jauh. Untuk informasi selengkapnya, lihat AuthenticationMechanism.

Restart-Computer -ComputerName Server01 -WsmanAuthentication Kerberos

Restart-Computer menggunakan parameter ComputerName untuk menentukan komputer jarak jauh, Server01. Parameter WsmanAuthentication menentukan metode autentikasi sebagai Kerberos.

Parameter

-ComputerName

Menentukan satu nama komputer atau array nama komputer yang dipisahkan koma. Restart-Computer menerima objek ComputerName dari alur atau variabel.

Ketik nama NetBIOS, alamat IP, atau nama domain komputer jarak jauh yang sepenuhnya memenuhi syarat. Untuk menentukan komputer lokal, ketik nama komputer, titik ., atau localhost.

Parameter ini tidak bergantung pada remoting PowerShell. Anda dapat menggunakan parameter ComputerName meskipun komputer Anda tidak dikonfigurasi untuk menjalankan perintah jarak jauh.

Jika parameter ComputerName tidak ditentukan, Restart-Computer memulai ulang komputer lokal.

Parameter ini hanya tersedia di platform Windows.

Jenis:	String[]
Alias:	CN, __SERVER, Server, IPAddress
Position:	0
Nilai default:	None
Diperlukan:	False
Terima input alur:	True
Terima karakter wildcard:	False

-Confirm

Meminta konfirmasi sebelum menjalankan Restart-Computer.

Jenis:	SwitchParameter
Alias:	cf
Position:	Named
Nilai default:	False
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Credential

Menentukan akun pengguna yang memiliki izin untuk melakukan tindakan ini. Defaultnya adalah pengguna saat ini.

Ketik nama pengguna, seperti User01 atau Domain01\User01, atau masukkan objek PSCredential yang dihasilkan oleh cmdlet Get-Credential. Jika Anda mengetikkan nama pengguna, Anda akan diminta untuk memasukkan kata sandi.

Kredensial disimpan dalam objek PSCredential dan kata sandi disimpan sebagai SecureString.

Nota

Untuk informasi selengkapnya tentang perlindungan data SecureString, lihat Seberapa aman SecureString?.

Parameter ini hanya tersedia di platform Windows.

Jenis:	PSCredential
Position:	1
Nilai default:	Current user
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Delay

Menentukan frekuensi kueri, dalam detik. PowerShell meminta layanan yang ditentukan oleh parameter Untuk untuk menentukan apakah layanan tersedia setelah komputer dimulai ulang.

Parameter ini hanya valid bersama dengan parameter Wait dan For.

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Jika parameter Penundaan tidak ditentukan, Restart-Computer menggunakan penundaan lima detik.

Parameter ini hanya tersedia di platform Windows.

Jenis:	Int16
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-For

Menentukan perilaku PowerShell saat menunggu layanan atau fitur yang ditentukan tersedia setelah komputer dimulai ulang. Parameter ini hanya valid dengan parameter Wait.

Nilai yang dapat diterima untuk parameter ini adalah:

• Default: Menunggu PowerShell untuk dimulai ulang.
• PowerShell: Dapat menjalankan perintah dalam sesi jarak jauh PowerShell di komputer.
• WMI: Menerima balasan kueri Win32_ComputerSystem untuk komputer.
• WinRM: Dapat membuat sesi jarak jauh ke komputer dengan menggunakan WS-Management.

Parameter ini diperkenalkan di Windows PowerShell 3.0. Parameter ini hanya tersedia di platform Windows.

Jenis:	WaitForServiceTypes
Nilai yang diterima:	Wmi, WinRM, PowerShell
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Force

Memaksa komputer untuk memulai ulang segera.

Parameter ini hanya tersedia di platform Windows.

Jenis:	SwitchParameter
Alias:	f
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Timeout

Menentukan durasi tunggu, dalam hitungan detik. Ketika batas waktu habis, Restart-Computer kembali ke prompt perintah, meskipun komputer tidak di-restart.

Parameter Batas Waktu hanya valid dengan parameter Tunggu. Timeout mengambil alih periode tunggu parameter Tunggu yang tidak terbatas.

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Parameter ini hanya tersedia di platform Windows.

Jenis:	Int32
Alias:	TimeoutSec
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Wait

Restart-Computer menyembunyikan prompt PowerShell dan memblokir alur proses hingga komputer dimulai ulang. Anda dapat menggunakan parameter ini dalam skrip untuk menghidupkan ulang komputer lalu melanjutkan proses ketika hidupkan ulang selesai.

Parameter Tunggu menunggu tanpa batas waktu hingga komputer dimulai ulang. Anda dapat menggunakan Batas Waktu untuk menyesuaikan waktu dan parameter Penundaan Untuk dan menunggu layanan tertentu tersedia di komputer yang dimulai ulang.

Parameter Tunggu tidak valid saat Anda memulai ulang komputer lokal. Jika nilai parameter ComputerName berisi nama komputer jarak jauh dan komputer lokal, Restart-Computer menghasilkan kesalahan non-terminasi untuk Tunggu di komputer lokal, tetapi menunggu komputer jarak jauh untuk memulai ulang.

Parameter ini diperkenalkan di Windows PowerShell 3.0. Parameter ini hanya tersedia di platform Windows.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-WhatIf

Menunjukkan apa yang akan terjadi jika Restart-Computer dijalankan. Cmdlet Restart-Computer tidak dijalankan.

Jenis:	SwitchParameter
Alias:	wi
Position:	Named
Nilai default:	False
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-WsmanAuthentication

Menentukan mekanisme yang digunakan untuk mengautentikasi kredensial pengguna. Parameter ini diperkenalkan di Windows PowerShell 3.0.

Nilai yang dapat diterima untuk parameter ini adalah: Basic, CredSSP, Default, Digest, Kerberos, dan Negosiasi.

Untuk informasi selengkapnya, lihat AuthenticationMechanism.

Peringatan

Autentikasi Penyedia Layanan Keamanan Kredensial (CredSSP), di mana kredensial pengguna diteruskan ke komputer jarak jauh untuk diautentikasi, dirancang untuk perintah yang memerlukan autentikasi pada lebih dari satu sumber daya, seperti mengakses berbagi jaringan jarak jauh. Mekanisme ini meningkatkan risiko keamanan operasi jarak jauh. Jika komputer jarak jauh disusupi, kredensial yang diteruskan ke komputer jarak jauh dapat digunakan untuk mengontrol sesi jaringan.

Parameter ini hanya tersedia di platform Windows.

Jenis:	String
Nilai yang diterima:	Basic, CredSSP, Default, Digest, Kerberos, Negotiate
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

Input

String

Anda dapat menyalurkan string yang berisi nama komputer ke cmdlet ini.

Output

None

Cmdlet ini tidak mengembalikan output.

Catatan

• Di Windows, Restart-Computer menggunakan metode Win32Shutdown dari Windows Management Instrumentation (WMI) kelas Win32_OperatingSystem. Metode ini mengharuskan hak istimewa SeShutdownPrivilege diaktifkan untuk akun pengguna yang digunakan untuk memulai ulang komputer.
• Cmdlet ini ditambahkan untuk Linux dan macOS di PowerShell 7.1. Di Linux dan macOS, Restart-Computer menggunakan alat bash /sbin/shutdown.

Link Terkait

• Tentang Windows Remote Management
• Get-Credential
• Protokol WS-Management