Stop-Computer
Menghentikan (mematikan) komputer lokal dan jarak jauh.
Sintaks
All
Stop-Computer
[[-ComputerName] <String[]>]
[[-Credential] <PSCredential>]
[-AsJob]
[-DcomAuthentication <AuthenticationLevel>]
[-WsmanAuthentication <String>]
[-Protocol <String>]
[-Impersonation <ImpersonationLevel>]
[-ThrottleLimit <Int32>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Deskripsi
cmdlet Stop-Computer mematikan komputer lokal dan komputer jarak jauh.
Anda dapat menggunakan parameter Stop-Computer untuk menjalankan operasi matikan sebagai pekerjaan latar belakang, untuk menentukan tingkat autentikasi dan kredensial alternatif, untuk membatasi koneksi bersamaan yang dibuat untuk menjalankan perintah, dan untuk memaksa matikan segera.
Cmdlet ini tidak memerlukan remoting PowerShell kecuali Anda menggunakan parameter AsJob.
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.
$j = Stop-Computer -ComputerName "Server01", "Server02" -AsJob
$results = $j | Receive-Job
$results
Stop-Computer menggunakan parameter ComputerName untuk menentukan dua komputer jarak jauh. Parameter AsJob 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.
Karena AsJob membuat pekerjaan di komputer lokal dan secara otomatis mengembalikan hasilnya ke komputer lokal, Anda dapat menjalankan Receive-Job sebagai perintah lokal.
Contoh 4: Mematikan komputer jarak jauh
Contoh ini mematikan komputer jarak jauh menggunakan autentikasi yang ditentukan.
Stop-Computer -ComputerName "Server01" -Impersonation Anonymous -DcomAuthentication PacketIntegrity
Stop-Computer menggunakan parameter ComputerName untuk menentukan komputer jarak jauh. Parameter Peniruan menentukan peniruan yang disesuaikan dan parameter DcomAuthentication menentukan pengaturan tingkat autentikasi.
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 -ThrottleLimit 10 -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 ThrottleLimit membatasi perintah hingga 10 koneksi bersamaan. Parameter Kredensial mengirimkan kredensial yang disimpan dalam variabel $c.
Parameter
-AsJob
Menunjukkan bahwa cmdlet ini berjalan sebagai pekerjaan latar belakang.
Untuk menggunakan parameter ini, komputer lokal dan jarak jauh harus dikonfigurasi untuk jarak jauh dan, 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 Receive-Job.
Untuk informasi selengkapnya tentang pekerjaan latar belakang PowerShell, lihat about_Jobs dan about_Remote_Jobs.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | False |
| 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 |
-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.
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: | 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 |
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
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 cmdlet ini dengan WMI.
Stop-Computer menggunakan WMI. Nilai defaultnya adalah Paket.
Nilai yang dapat diterima untuk parameter ini adalah:
- Default : Autentikasi Windows.
- None: Tidak ada autentikasi COM.
- Connect: Autentikasi COM tingkat koneksi.
- Panggil: Autentikasi COM tingkat panggilan.
- Paket: Autentikasi COM tingkat paket.
- PacketIntegrity: Autentikasi COM tingkat Integritas Paket.
- PacketPrivacy: Autentikasi COM tingkat Privasi Paket.
- Tidak Berubah : Sama dengan perintah sebelumnya.
Untuk informasi selengkapnya tentang nilai parameter ini, lihat AuthenticationLevel.
Properti parameter
| Jenis: | AuthenticationLevel |
| Nilai default: | Packet |
| 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 |
-Force
Memaksa komputer segera dimatikan.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | False |
| 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 |
-Impersonation
Menentukan tingkat peniruan untuk digunakan ketika cmdlet ini memanggil WMI. Nilai defaultnya adalah Meniru.
Stop-Computer menggunakan WMI. Nilai yang dapat diterima untuk parameter ini adalah:
- Default : Peniruan 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: | Impersonate |
| 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 dapat diterima untuk parameter ini adalah: WSMan dan DCOM. Nilai defaultnya adalah DCOM.
Parameter ini diperkenalkan di PowerShell 3.0.
Properti parameter
| Jenis: | String |
| Nilai default: | DCOM |
| Nilai yang diterima: | DCOM, WSMan |
| 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 |
-ThrottleLimit
Menentukan jumlah maksimum koneksi bersamaan yang dapat dibuat untuk menjalankan perintah ini. Jika Anda menghilangkan parameter ini atau memasukkan nilai 0, nilai default, 32, digunakan.
Batas pembatasan hanya berlaku untuk perintah saat ini, bukan ke sesi atau ke komputer.
Properti parameter
| Jenis: | Int32 |
| Nilai default: | None |
| 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 |
-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 |
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 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.
Properti parameter
| Jenis: | String |
| Nilai default: | Default |
| Nilai yang diterima: | Default, Basic, Negotiate, CredSSP, Digest, Kerberos |
| 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 |
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
Secara default, cmdlet ini tidak mengembalikan output.
System.Management.Automation.RemotingJob
Saat Anda menggunakan parameter AsJob, cmdlet ini mengembalikan objek RemotingJob.
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.
