Bagikan melalui

Stop-Computer

Modul:
Microsoft.PowerShell.Management

Menghentikan (mematikan) komputer lokal dan jarak jauh.

Sintaks

Stop-Computer
    [-WsmanAuthentication <String>]
    [[-ComputerName] <String[]>]
    [[-Credential] <PSCredential>]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Deskripsi

cmdlet Stop-Computer mematikan komputer lokal dan komputer jarak jauh.

Anda dapat menggunakan parameter Stop-Computer untuk menentukan tingkat autentikasi dan kredensial alternatif, dan untuk memaksa matikan segera.

Di PowerShell 7.1, Stop-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: Matikan komputer lokal

Contoh ini mematikan komputer lokal.

Stop-Computer -ComputerName localhost

Contoh 2: Matikan dua komputer jarak jauh dan komputer lokal

Contoh ini menghentikan dua komputer jarak jauh dan komputer lokal.

Stop-Computer -ComputerName "Server01", "Server02", "localhost"

Stop-Computer menggunakan parameter ComputerName untuk menentukan dua komputer jarak jauh dan komputer lokal. Setiap komputer dimatikan.

Contoh 3: Mematikan komputer jarak jauh sebagai pekerjaan latar belakang

Dalam contoh ini, Stop-Computer berjalan sebagai pekerjaan latar belakang pada dua komputer jarak jauh.

Operator latar belakang & menjalankan perintah Stop-Computer sebagai pekerjaan latar belakang. Untuk informasi selengkapnya, lihat about_Operators.

$j = Stop-Computer -ComputerName "Server01", "Server02" &
$results = $j | Receive-Job
$results

Stop-Computer menggunakan parameter ComputerName untuk menentukan dua komputer jarak jauh. Operator latar belakang & menjalankan perintah sebagai pekerjaan latar belakang. Objek pekerjaan disimpan dalam variabel $j.

Objek pekerjaan dalam variabel $j dikirimkan alur ke Receive-Job, yang mendapatkan hasil pekerjaan. Objek disimpan dalam variabel $results. Variabel $results menampilkan informasi pekerjaan di konsol PowerShell.

Contoh 4: Mematikan komputer jarak jauh

Contoh ini mematikan komputer jarak jauh menggunakan autentikasi yang ditentukan.

Stop-Computer -ComputerName "Server01" -WsmanAuthentication Kerberos

Stop-Computer menggunakan parameter ComputerName untuk menentukan komputer jarak jauh. Parameter WsmanAuthentication menentukan untuk menggunakan Kerberos untuk membuat koneksi jarak jauh.

Contoh 5: Mematikan komputer di domain

Dalam contoh ini, perintah memaksa matikan segera semua komputer dalam domain tertentu.

$s = Get-Content -Path ./Domain01.txt
$c = Get-Credential -Credential Domain01\Admin01
Stop-Computer -ComputerName $s -Force -Credential $c

Get-Content menggunakan parameter Jalur untuk mendapatkan file di direktori saat ini dengan daftar komputer domain. Objek disimpan dalam variabel $s.

Get-Credential menggunakan parameter Kredensial untuk menentukan kredensial administrator domain. Kredensial disimpan dalam variabel $c.

Stop-Computer mematikan komputer yang ditentukan dengan daftar komputer parameter ComputerName dalam variabel $s. Parameter Force memaksa pematian segera. Parameter Kredensial mengirimkan kredensial yang disimpan dalam variabel $c.

Parameter

-ComputerName

Menentukan komputer yang akan dihentikan. Defaultnya adalah komputer lokal.

Ketik nama NETBIOS, alamat IP, atau nama domain yang sepenuhnya memenuhi syarat dari satu atau beberapa komputer dalam daftar yang dipisahkan koma. Untuk menentukan komputer lokal, ketik nama komputer atau localhost.

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

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

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

-Force

Memaksa komputer segera dimatikan.

Parameter ini hanya tersedia di platform Windows.

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

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet 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 ketika cmdlet ini menggunakan protokol WSMan. Nilai defaultnya adalah Default.

Nilai yang dapat diterima untuk parameter ini adalah:

  • Dasar
  • CredSSP
  • Bawaan
  • Kunyah
  • Kerberos
  • Berunding.

Untuk informasi selengkapnya tentang nilai parameter ini, lihat AuthenticationMechanism.

Hati

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 diperkenalkan di PowerShell 3.0. Parameter ini hanya tersedia di platform Windows.

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

Input

None

Anda tidak dapat menyalurkan objek ke cmdlet ini.

Output

None

Cmdlet ini tidak mengembalikan output.

Catatan

Cmdlet ini menggunakan metode Win32Shutdown dari kelas WMI Win32_OperatingSystem. Metode ini mengharuskan hak istimewa SeShutdownPrivilege diaktifkan untuk akun pengguna yang digunakan untuk mematikan komputer.

Di PowerShell 7.1, Stop-Computer ditambahkan untuk Linux dan macOS. Untuk platform ini, cmdlet memanggil perintah asli /sbin/shutdown.