Restart-Computer

Modul:

Microsoft.PowerShell.Management Module

Menghidupkan ulang sistem operasi pada komputer lokal dan jarak jauh.

Sintaks

DefaultSet (Default)

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

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 sebagai pekerjaan latar belakang, 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.

Anda dapat menggunakan protokol WS-Management (WSMan) untuk menghidupkan ulang komputer, jika panggilan Distributed Component Object Model (DCOM) diblokir, seperti oleh firewall perusahaan. Untuk informasi selengkapnya, lihat protokol WS-Management.

Cmdlet ini memerlukan remoting Windows PowerShell hanya saat Anda menggunakan parameter AsJob dalam perintah.

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: Menghidupkan ulang komputer sebagai pekerjaan latar belakang

Perintah ini menjalankan perintah Restart-Computer sebagai pekerjaan latar belakang pada dua komputer jarak jauh, lalu mendapatkan hasilnya.

Karena AsJob membuat pekerjaan di komputer lokal dan secara otomatis mengembalikan hasilnya ke komputer lokal, Anda dapat menjalankan Receive-Job sebagai perintah lokal.

$Job = Restart-Computer -ComputerName "Server01", "Server02" -AsJob
$Job | Receive-Job

menggunakan parameter ComputerName untuk menentukan Server01 dan Server02. Parameter AsJob menjalankan perintah sebagai pekerjaan latar belakang. Objek pekerjaan disimpan dalam variabel $Job. $Job dikirimkan alur ke cmdlet Receive-Job yang mendapatkan hasilnya.

Contoh 4: Menghidupkan ulang komputer jarak jauh

Restart-Computer menghidupkan ulang komputer jarak jauh dengan pengaturan peniruan dan autentikasi yang disesuaikan.

Restart-Computer -ComputerName Server01 -Impersonation Anonymous -DcomAuthentication PacketIntegrity

Restart-Computer menggunakan parameter ComputerName untuk menentukan Server01. Parameter Peniruan menentukan Anonim untuk menyembunyikan identitas pemohon. Parameter DcomAuthentication menentukan PacketIntegrity sebagai tingkat autentikasi koneksi.

Contoh 5: 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 memaksa mulai ulang segera dan parameter ThrottleLimit membatasi jumlah koneksi bersamaan.

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

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. Parameter ThrottleLimit membatasi perintah hingga 10 koneksi bersamaan.

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 Protokol WSMan

Restart-Computer menghidupkan ulang komputer jarak jauh dengan menggunakan protokol WSMan alih-alih default, DCOM. Autentikasi Kerberos menentukan apakah pengguna saat ini memiliki izin untuk memulai ulang komputer jarak jauh.

Pengaturan ini dirancang untuk perusahaan di mana hidupkan ulang berbasis DCOM gagal karena DCOM diblokir. Misalnya, oleh firewall.

Restart-Computer -ComputerName Server01 -Protocol WSMan -WsmanAuthentication Kerberos

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

Parameter

-AsJob

Menunjukkan bahwa Restart-Computer berjalan sebagai pekerjaan latar belakang.

Untuk menggunakan parameter ini, komputer lokal dan jarak jauh harus dikonfigurasi untuk jarak jauh. Pada Windows Vista dan versi sistem operasi Windows yang lebih baru, Anda harus membuka PowerShell dengan menggunakan opsi Jalankan sebagai Administrator. Untuk informasi lebih lanjut, lihat about_Remote_Requirements.

Saat Anda menentukan parameter AsJob, perintah segera mengembalikan objek yang mewakili pekerjaan latar belakang. Anda dapat terus bekerja dalam sesi saat pekerjaan selesai. Pekerjaan dibuat pada komputer lokal dan hasil dari komputer jarak jauh secara otomatis dikembalikan ke komputer lokal. Untuk mengelola pekerjaan, gunakan cmdlet Pekerjaan . Untuk mendapatkan hasil pekerjaan, gunakan cmdlet Receive-Job.

Untuk informasi selengkapnya tentang pekerjaan latar belakang Windows PowerShell, lihat about_Jobs dan about_Remote_Jobs.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

AsJobSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

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

Properti parameter

Jenis:	String[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	CN, __PELADEN, pelayan, Alamat IP

Kumpulan parameter

(All)

Position:	0
Wajib:	False
Nilai dari alur:	True
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-Confirm

Meminta konfirmasi sebelum menjalankan Restart-Computer.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	False
Mendukung wildcard:	False
DontShow:	False
Alias:	Cf

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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?.

Properti parameter

Jenis:	PSCredential
Nilai default:	Current user
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	1
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-DcomAuthentication

Menentukan tingkat autentikasi yang digunakan untuk koneksi WMI. Restart-Computer menggunakan WMI.

Nilai yang valid adalah:

• Memanggil: Autentikasi COM tingkat panggilan
• Connect: Autentikasi COM tingkat koneksi
• Default : Autentikasi Windows
• Tidak Ada: Tidak ada autentikasi COM
• Paket: Autentikasi COM tingkat paket.
• PacketIntegrity: Autentikasi COM tingkat Integritas Paket
• PacketPrivacy: Autentikasi COM tingkat Privasi Paket.
• Tidak Berubah : Tingkat autentikasi sama dengan perintah sebelumnya.

Untuk informasi selengkapnya, lihat AuthenticationLevel Enumeration.

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Properti parameter

Jenis:	AuthenticationLevel
Nilai default:	None
Nilai yang diterima:	Default, None, Connect, Call, Packet, PacketIntegrity, PacketPrivacy, Unchanged
Mendukung wildcard:	False
DontShow:	False
Alias:	Otentikasi

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	Int16
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

DefaultSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	WaitForServiceTypes
Nilai default:	None
Nilai yang diterima:	Wmi, WinRM, PowerShell
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

DefaultSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Force

Memaksa komputer untuk memulai ulang segera.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	f

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Impersonation

Menentukan tingkat peniruan yang digunakan cmdlet ini untuk memanggil WMI. Restart-Computer menggunakan WMI. Nilai yang dapat diterima untuk parameter ini adalah:

• Default : Peniruan default. Terlepas dari namanya, ini bukan nilai default.
• Anonim : Menyembunyikan identitas pemanggil.
• Identifikasi: Memungkinkan objek untuk mengkueri kredensial pemanggil.
• Meniru: Memungkinkan objek untuk menggunakan kredensial pemanggil.

Properti parameter

Jenis:	ImpersonationLevel
Nilai default:	None
Nilai yang diterima:	Default, Anonymous, Identify, Impersonate, Delegate
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Protocol

Menentukan protokol mana yang akan digunakan untuk memulai ulang komputer. Nilai yang valid adalah WSMan danDCOM .

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Properti parameter

Jenis:	String
Nilai default:	None
Nilai yang diterima:	DCOM, WSMan
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

DefaultSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-ThrottleLimit

Menentukan jumlah maksimum koneksi bersamaan yang dapat dibuat untuk menjalankan perintah ini. Batas pembatasan hanya berlaku untuk perintah saat ini, bukan ke sesi atau ke komputer.

Jika parameter ThrottleLimit tidak ditentukan atau nilai 0 digunakan, menggunakan maksimum 32 koneksi bersamaan.

Properti parameter

Jenis:	Int32
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

AsJobSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	Int32
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	TimeoutSec

Kumpulan parameter

DefaultSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

DefaultSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-WhatIf

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

Properti parameter

Jenis:	SwitchParameter
Nilai default:	False
Mendukung wildcard:	False
DontShow:	False
Alias:	wi

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	String
Nilai default:	None
Nilai yang diterima:	Basic, CredSSP, Default, Digest, Kerberos, Negotiate
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

DefaultSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Input

String

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

Output

None

Secara default, cmdlet ini tidak mengembalikan output.

System.Management.Automation.RemotingJob

Saat Anda menggunakan parameter AsJob, cmdlet ini mengembalikan objek pekerjaan.

Catatan

• Pada Windows, Restart-Computer menggunakan metode Win32ShutdownWin32_OperatingSystem kelas. Metode ini mengharuskan hak istimewa SeShutdownPrivilege diaktifkan untuk akun pengguna yang digunakan untuk memulai ulang komputer.

Di Windows PowerShell 2.0, parameter AsJob tidak berfungsi dengan andal saat Anda memulai ulang atau menghentikan komputer jarak jauh. Di Windows PowerShell 3.0, implementasi diubah untuk mengatasi masalah ini.

Link Terkait

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