Stop-Computer

  • Referensi
Modul:
Microsoft.PowerShell.Management

Menghentikan (mematikan) komputer lokal dan jarak jauh.

Sintaks

Stop-Computer
    [-AsJob]
    [-DcomAuthentication <AuthenticationLevel>]
    [-WsmanAuthentication <String>]
    [-Protocol <String>]
    [[-ComputerName] <String[]>]
    [[-Credential] <PSCredential>]
    [-Impersonation <ImpersonationLevel>]
    [-ThrottleLimit <Int32>]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Deskripsi

Stop-Computer Cmdlet 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-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.

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

Stop-Computermenggunakan parameter ComputerName untuk menentukan dua komputer jarak jauh. Parameter AsJob 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.

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-Computermenggunakan 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-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 ThrottleLimit membatasi perintah ke 10 koneksi bersamaan. Parameter Kredensial mengirimkan kredensial yang disimpan dalam $c variabel.

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 selengkapnya, 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 mendapatkan hasil pekerjaan, gunakan Receive-Job cmdlet .

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

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

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

-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.
  • Tidak ada: Tidak ada autentikasi COM.
  • Koneksi: autentikasi COM tingkat Koneksi.
  • Panggilan: Autentikasi COM tingkat panggilan.
  • Paket: Autentikasi COM tingkat paket.
  • PacketIntegrity: Autentikasi COM tingkat Integritas Paket.
  • PacketPrivacy: Autentikasi COM tingkat Privasi Paket.
  • Tidak berubah: Sama seperti perintah sebelumnya.

Untuk informasi selengkapnya tentang nilai parameter ini, lihat AuthenticationLevel.

Type:AuthenticationLevel
Aliases:Authentication
Accepted values:Default, None, Connect, Call, Packet, PacketIntegrity, PacketPrivacy, Unchanged
Position:Named
Default value:Packet
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

-Impersonation

Menentukan tingkat peniruan untuk digunakan ketika cmdlet ini memanggil WMI. Nilai defaultnya adalah Impersonate.

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.
Type:ImpersonationLevel
Accepted values:Default, Anonymous, Identify, Impersonate, Delegate
Position:Named
Default value:Impersonate
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Accepted values:DCOM, WSMan
Position:Named
Default value:DCOM
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Int32
Position:Named
Default value:None
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

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 Win32ShutdownWin32_OperatingSystem metode kelas WMI. Metode ini mengharuskan SeShutdownPrivilege hak istimewa diaktifkan untuk akun pengguna yang digunakan untuk mematikan komputer.