Bagikan melalui

Set-WSManQuickConfig

  • Referensi
Modul:
Microsoft.WSMan.Management

Mengonfigurasi komputer lokal untuk manajemen jarak jauh.

Sintaks

Set-WSManQuickConfig
   [-UseSSL]
   [-Force]
   [-SkipNetworkProfileCheck]
   [<CommonParameters>]

Deskripsi

Cmdlet ini hanya tersedia di platform Windows.

Set-WSManQuickConfig Cmdlet mengonfigurasi komputer untuk menerima perintah jarak jauh PowerShell yang dikirim dengan menggunakan teknologi Web Services for Management (WS-Management).

Set-WSManQuickConfig melakukan tindakan berikut:

  • Memeriksa apakah layanan WinRM sedang berjalan. Jika layanan WinRM tidak berjalan, layanan dimulai.
  • Mengatur jenis startup layanan WinRM ke otomatis.
  • Membuat listener untuk menerima permintaan pada alamat IP apa pun. Transportasi default adalah HTTP.
  • Mengaktifkan pengecualian firewall untuk lalu lintas WinRM.

Untuk menjalankan Set-WSManQuickConfig, mulai PowerShell dengan opsi Jalankan sebagai Administrator .

Contoh

Contoh 1: Mengaktifkan manajemen jarak jauh komputer lokal melalui HTTP

Contoh ini mengatur konfigurasi yang diperlukan untuk mengaktifkan manajemen jarak jauh komputer lokal. Secara default, perintah ini membuat pendengar WS-Management di HTTP.

Set-WSManQuickConfig

Contoh 2: Mengaktifkan manajemen jarak jauh komputer lokal melalui HTTPS

Contoh ini mengatur konfigurasi yang diperlukan untuk mengaktifkan manajemen jarak jauh komputer lokal. Parameter UseSSL menentukan bahwa HTTPS digunakan untuk berkomunikasi dengan komputer.

Set-WSManQuickConfig -UseSSL

Catatan

HTTPS memerlukan konfigurasi manual. Untuk informasi selengkapnya, lihat deskripsi parameter UseSSL .

Parameter

-Force

Memaksa perintah untuk dijalankan tanpa meminta konfirmasi pengguna.

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

-SkipNetworkProfileCheck

Mengonfigurasi versi klien Windows untuk jarak jauh ketika komputer berada di jaringan publik. Parameter ini memungkinkan aturan firewall untuk jaringan publik yang memungkinkan akses jarak jauh hanya dari komputer di subnet lokal yang sama.

Parameter ini tidak berpengaruh pada versi server Windows, yang secara default, memiliki aturan firewall subnet lokal untuk jaringan publik. Jika aturan firewall subnet lokal dinonaktifkan pada versi server Windows, Enable-PSRemoting mengaktifkannya kembali, terlepas dari nilai parameter ini.

Untuk menghapus pembatasan subnet lokal dan mengaktifkan akses jarak jauh dari semua lokasi di jaringan publik, gunakan Set-NetFirewallRule cmdlet dalam modul NetSecurity .

Parameter ini diperkenalkan di PowerShell 3.0.

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

-UseSSL

Menentukan bahwa protokol Secure Sockets Layer (SSL) digunakan untuk membuat koneksi ke komputer jarak jauh. Secara default, SSL tidak digunakan.

WS-Management mengenkripsi semua konten PowerShell yang dikirimkan melalui jaringan. Parameter UseSSL memungkinkan Anda menentukan perlindungan tambahan HTTPS alih-alih HTTP. Jika Anda menggunakan parameter ini dan SSL tidak tersedia pada port yang digunakan untuk koneksi, perintah gagal.

HTTPS memerlukan konfigurasi manual WinRM dan aturan firewall. Untuk informasi selengkapnya, lihat Cara: Mengonfigurasi WINRM untuk HTTPS.

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

Input

None

Anda tidak dapat menyalurkan objek ke cmdlet ini.

Output

String

Cmdlet ini mengembalikan pesan sebagai objek String yang menjelaskan status konfigurasi setelah operasi.