Stop-Computer
Menghentikan (mematikan) komputer lokal dan jarak jauh.
Sintaks
All
Stop-Computer
[[-ComputerName] <String[]>]
[[-Credential] <PSCredential>]
[-WsmanAuthentication <String>]
[-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.
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
| Alias: | CN, __PELADEN, pelayan, Alamat IP |
Set parameter
(All)
| Position: | 0 |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-Confirm
Meminta konfirmasi sebelum menjalankan cmdlet.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | False |
| Mendukung wildcard: | False |
| DontShow: | False |
| Alias: | Cf |
Set 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
Nota
Untuk informasi selengkapnya tentang perlindungan data SecureString, lihat Seberapa aman SecureString?.
Parameter ini hanya tersedia di platform Windows.
Properti parameter
| Jenis: | PSCredential |
| Nilai default: | Current user |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
(All)
| Position: | 1 |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Force
Memaksa komputer segera dimatikan.
Parameter ini hanya tersedia di platform Windows.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | False |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
(All)
| 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 ketika cmdlet dijalankan. Cmdlet tidak dijalankan.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | False |
| Mendukung wildcard: | False |
| DontShow: | False |
| Alias: | wi |
Set 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 ketika cmdlet ini menggunakan protokol WSMan. Nilai defaultnya adalah Default.
Nilai yang dapat diterima untuk parameter ini adalah:
- Dasar
- CredSSP
- Bawaan
- ringkasan
- Kerberos
- Berunding.
Untuk informasi selengkapnya tentang nilai parameter ini, lihat AuthenticationMechanism.
Caution
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.
Properti parameter
| Jenis: | String |
| Nilai default: | Default |
| Nilai yang diterima: | Default, Basic, Negotiate, CredSSP, Digest, Kerberos |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
(All)
| 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
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.
