Restart-Computer

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 ini hanya tersedia di platform Windows.

Restart-Computer Cmdlet 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.

Mulai dari Windows PowerShell 3.0, Anda dapat menunggu mulai ulang selesai sebelum menjalankan perintah berikutnya. Tentukan waktu tunggu habis dan interval kueri, dan tunggu hingga layanan tertentu tersedia di komputer yang dimulai ulang. Fitur ini membuatnya praktis untuk digunakan Restart-Computer dalam skrip dan fungsi.

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 dikirim ke alur.

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 alur. Restart-Computer menghidupkan ulang setiap komputer.

Contoh 4: Menghidupkan ulang komputer secara paksa yang tercantum dalam file teks

Contoh ini memaksa mulai ulang segera komputer yang tercantum dalam Domain01.txt file. Nama komputer dari file teks disimpan dalam variabel. Parameter Force memaksa hidupkan ulang 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 Paksa menyebabkan mulai ulang segera setiap komputer.

Contoh 6: Mulai ulang komputer jarak jauh dan tunggu PowerShell

Restart-Computer memulai ulang komputer jarak jauh dan kemudian 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 Tunggu menunggu mulai ulang selesai. Untuk menentukan bahwa PowerShell dapat menjalankan perintah di komputer jarak jauh. Parameter Batas waktu menentukan waktu tunggu lima menit. Parameter Penundaan meminta komputer jarak jauh setiap dua detik untuk menentukan apakah itu dimulai ulang.

Contoh 7: Menghidupkan ulang komputer dengan menggunakan WsmanAuthentication

Restart-Computer menghidupkan 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 akses jauh PowerShell. Anda dapat menggunakan parameter ComputerName meskipun komputer Anda tidak dikonfigurasi untuk menjalankan perintah jarak jauh.

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

Type:String[]
Aliases:CN, __SERVER, Server, IPAddress
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Meminta konfirmasi sebelum menjalankan Restart-Computer.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters: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 Get-Credential cmdlet . Jika Anda mengetik nama pengguna, Anda akan diminta untuk memasukkan kata sandi.

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

Catatan

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

Type:PSCredential
Position:1
Default value:Current user
Accept pipeline input:False
Accept wildcard characters:False

-Delay

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

Parameter ini hanya valid bersama dengan parameter Tunggu dan Untuk .

Parameter ini diperkenalkan dalam Windows PowerShell 3.0.

Jika parameter Tunda tidak ditentukan, Restart-Computer gunakan penundaan lima detik.

Type:Int16
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-For

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

Nilai yang dapat diterima untuk parameter ini adalah:

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

Parameter ini diperkenalkan dalam Windows PowerShell 3.0.

Type:WaitForServiceTypes
Accepted values:Wmi, WinRM, PowerShell
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Force

Memaksa mulai ulang komputer segera.

Type:SwitchParameter
Aliases:f
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Timeout

Menentukan durasi tunggu, dalam detik. Ketika waktu habis berlalu, Restart-Computer kembali ke prompt perintah, meskipun komputer tidak dimulai ulang.

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

Parameter ini diperkenalkan dalam Windows PowerShell 3.0.

Type:Int32
Aliases:TimeoutSec
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Wait

Restart-Computer menekan prompt PowerShell dan memblokir alur hingga komputer dimulai ulang. Anda dapat menggunakan parameter ini dalam skrip untuk menghidupkan ulang komputer dan kemudian 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 Untuk dan Tunda untuk 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 yang tidak mengakhiri untuk Tunggu di komputer lokal, tetapi menunggu komputer jarak jauh dimulai ulang.

Parameter ini diperkenalkan dalam Windows PowerShell 3.0.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-WsmanAuthentication

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

Nilai yang dapat diterima untuk parameter ini adalah: Dasar, 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.

Type:String
Accepted values:Basic, CredSSP, Default, Digest, Kerberos, Negotiate
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Input

String

Restart-Computer menerima nama komputer dari alur atau variabel.

Output

None

Restart-Computer tidak menghasilkan output apa pun.

Catatan

  • Di Windows, Restart-Computer menggunakan metode Win32Shutdown dari kelas Win32_OperatingSystem Windows Management Instrumentation (WMI). Metode ini memerlukan hak istimewa SeShutdownPrivilege diaktifkan untuk akun pengguna yang digunakan untuk menghidupkan ulang komputer.
  • Di Linux dan Mac OS, Restart-Computer menggunakan /sbin/shutdown alat bash.