Stop-Computer

  • Referensi
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

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

Anda dapat menggunakan parameter Stop-Computer untuk menentukan tingkat autentikasi dan info masuk alternatif, dan untuk memaksa segera dimatikan.

Di PowerShell 7.1, Stop-Computer ditambahkan untuk Linux dan macOS. Parameter tidak berpengaruh pada platform ini. Cmdlet hanya memanggil perintah /sbin/shutdownasli .

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-Computermenggunakan 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 Stop-Computer perintah sebagai pekerjaan latar belakang. Untuk informasi selengkapnya, lihat about_Operators.

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

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

Objek pekerjaan dalam $j variabel dikirim ke alur ke Receive-Job, yang mendapatkan hasil pekerjaan. Objek disimpan dalam $results variabel . 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-Computermenggunakan 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-Contentmenggunakan parameter Jalur untuk mendapatkan file di direktori saat ini dengan daftar komputer domain. Objek disimpan dalam $s variabel .

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

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

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.

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

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required: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 mengetikkan 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Memaksa komputer segera dimatikan.

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

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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
  • Default
  • digest
  • Kerberos
  • Bernegosiasi.

Untuk informasi selengkapnya tentang nilai parameter ini, lihat AuthenticationMechanism.

Perhatian

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.

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

Input

None

Anda tidak dapat menyalurkan objek ke cmdlet ini.

Output

None

Cmdlet ini tidak mengembalikan output.

Catatan

Cmdlet ini menggunakan Win32ShutdownWin32_OperatingSystem metode kelas WMI. Metode ini mengharuskan SeShutdownPrivilege hak istimewa 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 /sbin/shutdownasli .