Remove-WSManInstance
Menghapus instans sumber daya manajemen.
Sintaks
Remove-WSManInstance
[-ApplicationName <String>]
[-ComputerName <String>]
[-OptionSet <Hashtable>]
[-Port <Int32>]
[-ResourceURI] <Uri>
[-SelectorSet] <Hashtable>
[-SessionOption <SessionOption>]
[-UseSSL]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[<CommonParameters>] Remove-WSManInstance
[-ConnectionURI <Uri>]
[-OptionSet <Hashtable>]
[-ResourceURI] <Uri>
[-SelectorSet] <Hashtable>
[-SessionOption <SessionOption>]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[<CommonParameters>] Deskripsi
Cmdlet ini hanya tersedia di platform Windows.
Cmdlet Remove-WSManInstance menghapus instans sumber daya manajemen yang ditentukan dalam parameter ResourceURI dan SelectorSet.
Cmdlet ini menggunakan lapisan transportasi koneksi WinRM untuk menghapus instans sumber daya manajemen.
Contoh
Contoh 1: Menghapus pendengar
Remove-WSManInstance -ResourceUri winrm/config/Listener -SelectorSet @{
Address = 'test.fabrikam.com'
Transport = 'http'
}Perintah ini menghapus pendengar HTTP WS-Management pada komputer.
Parameter
-ApplicationName
Menentukan nama aplikasi dalam koneksi. Nilai default parameter ApplicationName adalah WSMAN. Pengidentifikasi lengkap untuk titik akhir jarak jauh dalam format berikut:
<Transport>://<Server>:<Port>/<ApplicationName>
Misalnya: http://server01:8080/WSMAN
Internet Information Services (IIS), yang menghosting sesi, meneruskan permintaan dengan titik akhir ini ke aplikasi yang ditentukan. Pengaturan default WSMAN ini sesuai untuk sebagian besar penggunaan. Parameter ini dirancang untuk digunakan jika banyak komputer membuat koneksi jarak jauh ke satu komputer yang menjalankan Windows PowerShell. Dalam hal ini, IIS menghosting Web Services for Management (WS-Management) untuk efisiensi.
| Jenis: | String |
| Position: | Named |
| Nilai default: | None |
| Diperlukan: | False |
| Terima input alur: | False |
| Terima karakter wildcard: | False |
-Authentication
Menentukan mekanisme autentikasi yang akan digunakan di server. Nilai yang dapat diterima untuk parameter ini adalah:
-
Basic- Dasar adalah skema di mana nama pengguna dan kata sandi dikirim dalam teks yang jelas ke server atau proksi. -
Default- Gunakan metode autentikasi yang diterapkan oleh protokol WS-Management. Ini adalah default. -
Digest- Digest adalah skema respons tantangan yang menggunakan string data yang ditentukan server untuk tantangan tersebut. -
Kerberos- Komputer klien dan server saling mengautentikasi dengan menggunakan sertifikat Kerberos. -
Negotiate- Negosiasi adalah skema respons tantangan yang bernegosiasi dengan server atau proksi untuk menentukan skema yang akan digunakan untuk autentikasi. Misalnya, nilai parameter ini memungkinkan negosiasi untuk menentukan apakah protokol Kerberos atau NTLM digunakan. -
CredSSP- Gunakan autentikasi Penyedia Dukungan Keamanan Kredensial (CredSSP), yang memungkinkan pengguna mendelegasikan kredensial. Opsi ini dirancang untuk perintah yang berjalan di satu komputer jarak jauh tetapi mengumpulkan data dari atau menjalankan perintah tambahan di komputer jarak jauh lainnya.
Hati
CredSSP mendelegasikan kredensial pengguna dari komputer lokal ke komputer jarak jauh. Praktik ini meningkatkan risiko keamanan operasi jarak jauh. Jika komputer jarak jauh disusupi, ketika kredensial diteruskan ke komputer jarak jauh, kredensial dapat digunakan untuk mengontrol sesi jaringan.
| Jenis: | AuthenticationMechanism |
| Alias: | auth, am |
| Nilai yang diterima: | None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp |
| Position: | Named |
| Nilai default: | None |
| Diperlukan: | False |
| Terima input alur: | False |
| Terima karakter wildcard: | False |
-CertificateThumbprint
Menentukan sertifikat kunci publik digital (X509) dari akun pengguna yang memiliki izin untuk melakukan tindakan ini. Masukkan thumbprint sertifikat sertifikat.
Sertifikat digunakan dalam autentikasi berbasis sertifikat klien. Mereka hanya dapat dipetakan ke akun pengguna lokal. Sertifikat tidak berfungsi dengan akun domain.
Untuk mendapatkan thumbprint sertifikat, gunakan perintah Get-Item atau Get-ChildItem di drive Cert: PowerShell.
| Jenis: | String |
| Position: | Named |
| Nilai default: | None |
| Diperlukan: | False |
| Terima input alur: | False |
| Terima karakter wildcard: | False |
-ComputerName
Menentukan komputer yang akan menjalankan operasi manajemen. Nilainya dapat berupa nama domain yang sepenuhnya memenuhi syarat, nama NetBIOS, atau alamat IP. Gunakan nama komputer lokal, gunakan localhost, atau gunakan titik (.) untuk menentukan komputer lokal. Komputer lokal adalah default. Ketika komputer jarak jauh berada di domain yang berbeda dari pengguna, Anda harus menggunakan nama domain yang sepenuhnya memenuhi syarat harus digunakan. Anda dapat menyalurkan nilai untuk parameter ini ke cmdlet.
| Jenis: | String |
| Alias: | cn |
| Position: | Named |
| Nilai default: | None |
| Diperlukan: | False |
| Terima input alur: | False |
| Terima karakter wildcard: | False |
-ConnectionURI
Menentukan titik akhir koneksi. Format string ini adalah sebagai berikut:
<Transport>://<Server>:<Port>/<ApplicationName>
String berikut adalah nilai yang diformat dengan benar untuk parameter ini:
http://Server01:8080/WSMAN
URI harus sepenuhnya memenuhi syarat.
| Jenis: | Uri |
| Position: | Named |
| Nilai default: | None |
| Diperlukan: | False |
| Terima input alur: | False |
| Terima karakter wildcard: | False |
-Credential
Menentukan akun pengguna yang memiliki izin untuk melakukan tindakan ini. Defaultnya adalah pengguna saat ini. Ketik nama pengguna, seperti User01, Domain01\User01, atau User@Domain.com. Atau, masukkan objek PSCredential, seperti yang dikembalikan oleh cmdlet Get-Credential. Saat Anda mengetik nama pengguna, cmdlet ini meminta kata sandi kepada Anda.
| Jenis: | PSCredential |
| Alias: | cred, c |
| Position: | Named |
| Nilai default: | None |
| Diperlukan: | False |
| Terima input alur: | True |
| Terima karakter wildcard: | False |
-OptionSet
Menentukan sekumpulan sakelar ke layanan untuk memodifikasi atau memperbaiki sifat permintaan. Sakelar menyerupai ini digunakan dalam shell baris perintah karena spesifik untuk layanan. Sejumlah opsi dapat ditentukan.
Contoh berikut menunjukkan sintaks yang meneruskan nilai 1, 2, dan 3 untuk parameter a, b, dan c:
-OptionSet @{a=1;b=2;c=3}
| Jenis: | Hashtable |
| Alias: | os |
| Position: | Named |
| Nilai default: | None |
| Diperlukan: | False |
| Terima input alur: | False |
| Terima karakter wildcard: | False |
-Port
Menentukan port yang akan digunakan ketika klien tersambung ke layanan WinRM. Ketika transportasi adalah HTTP, port default adalah 80. Ketika transportasi adalah HTTPS, port default adalah 443.
Saat Anda menggunakan HTTPS sebagai transportasi, nilai parameter ComputerName harus cocok dengan nama umum sertifikat (CN) server. Namun, jika parameter SkipCNCheck ditentukan sebagai bagian dari parameter SessionOption, nama umum sertifikat server tidak harus cocok dengan nama host server. Parameter SkipCNCheck harus digunakan hanya untuk komputer tepercaya.
| Jenis: | Int32 |
| Position: | Named |
| Nilai default: | None |
| Diperlukan: | False |
| Terima input alur: | False |
| Terima karakter wildcard: | False |
-ResourceURI
Menentukan URI kelas atau instans sumber daya. URI digunakan untuk mengidentifikasi jenis sumber daya tertentu, seperti disk atau proses, di komputer.
URI terdiri dari awalan dan jalur sumber daya. Misalnya:
http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk
http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_NumericSensor
| Jenis: | Uri |
| Alias: | ruri |
| Position: | 0 |
| Nilai default: | None |
| Diperlukan: | True |
| Terima input alur: | False |
| Terima karakter wildcard: | False |
-SelectorSet
Menentukan sekumpulan pasangan nilai yang digunakan untuk memilih instans sumber daya manajemen tertentu. Parameter SelectorSet digunakan ketika ada lebih dari satu instans sumber daya. Nilai SelectorSet harus berupa tabel hash.
Contoh berikut menunjukkan cara memasukkan nilai untuk parameter ini:
-SelectorSet @{Name="WinRM";ID="yyy"}
| Jenis: | Hashtable |
| Position: | 1 |
| Nilai default: | None |
| Diperlukan: | True |
| Terima input alur: | True |
| Terima karakter wildcard: | False |
-SessionOption
Menentukan opsi yang diperluas untuk sesi WS-Management. Masukkan objek SessionOption yang Anda buat dengan menggunakan cmdlet New-WSManSessionOption. Untuk informasi selengkapnya tentang opsi yang tersedia, ketik Get-Help New-WSManSessionOption.
| Jenis: | SessionOption |
| Alias: | so |
| Position: | Named |
| Nilai default: | None |
| 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 Windows PowerShell yang dikirimkan melalui jaringan. Parameter UseSSL memungkinkan Anda menentukan perlindungan tambahan HTTPS alih-alih HTTP. Jika SSL tidak tersedia pada port yang digunakan untuk koneksi, dan Anda menentukan parameter ini, perintah gagal.
| Jenis: | SwitchParameter |
| Alias: | ssl |
| Position: | Named |
| Nilai default: | None |
| Diperlukan: | False |
| Terima input alur: | False |
| Terima karakter wildcard: | False |
Input
None
Anda tidak dapat menyalurkan objek ke cmdlet ini.
Output
None
Cmdlet ini tidak mengembalikan output.
Catatan
Cmdlet dalam modul CimCmdlets serupa. Mereka menggunakan lapisan koneksi/transportasi DCOM untuk membuat atau memperbarui instans WMI.
