about_WSMan_Provider
Nama Penyedia
WSMan
Drive
WSMan:
Deskripsi singkat
Menyediakan akses ke informasi konfigurasi Web Services for Management (WS-Management).
Deskripsi terperinci
Informasi ini hanya berlaku untuk PowerShell yang berjalan di Windows.
Penyedia WSMan untuk PowerShell memungkinkan Anda menambahkan, mengubah, menghapus, dan menghapus data konfigurasi WS-Management di komputer lokal atau jarak jauh.
Penyedia WSMan mengekspos drive PowerShell dengan struktur direktori yang sesuai dengan pengelompokan logis pengaturan konfigurasi WS-Management. Pengelompokan ini dikenal sebagai kontainer.
Mulai Windows PowerShell 3.0, penyedia WSMan telah diperbarui untuk mendukung properti baru untuk konfigurasi sesi, seperti OutputBufferingMode. Konfigurasi sesi muncul sebagai item di direktori WSMan: Plugin drive dan properti muncul sebagai item di setiap konfigurasi sesi.
Penyedia WSMan mendukung cmdlet berikut, yang tercakup dalam artikel ini.
Catatan
Anda dapat menggunakan perintah di WSMan: drive untuk mengubah nilai properti baru. Namun, Anda tidak dapat menggunakan WSMan: drive di PowerShell 2.0 untuk mengubah properti yang diperkenalkan di Windows PowerShell 3.0.
Meskipun tidak ada kesalahan yang dihasilkan, perintah tidak efektif Untuk mengubah pengaturan ini, gunakan drive WSMan di Windows PowerShell 3.0.
Organisasi WSMan: Drive
Klien: Anda dapat mengonfigurasi berbagai aspek klien WS-Management. Informasi konfigurasi disimpan di registri.
Layanan: Anda dapat mengonfigurasi berbagai aspek layanan WS-Management. Informasi konfigurasi disimpan di registri.
Catatan
Konfigurasi layanan terkadang disebut sebagai konfigurasi Server.
Shell: Anda dapat mengonfigurasi berbagai aspek shell WS-Management, seperti pengaturan untuk mengizinkan akses shell jarak jauh (AllowRemoteShellAccess) dan jumlah maksimum pengguna bersamaan yang diizinkan (MaxConcurrentUsers).
Pendengar: Anda dapat membuat dan mengonfigurasi pendengar. Pendengar adalah layanan manajemen yang menerapkan protokol WS-Management untuk mengirim dan menerima pesan.
Plugin: Plug-in dimuat dan digunakan oleh layanan WS-Management untuk menyediakan berbagai fungsi. Secara default, PowerShell menyediakan tiga plug-in:
- Plug-in Penerusan Peristiwa.
- Plug-in Microsoft.PowerShell.
- Plug-in Penyedia Windows Management Instrumentation (WMI). Ketiga plug-in ini mendukung penerusan peristiwa, konfigurasi, dan akses WMI.
ClientCertificate: Anda dapat membuat dan mengonfigurasi sertifikat klien. Sertifikat klien digunakan saat klien WS-Management dikonfigurasi untuk menggunakan autentikasi sertifikat.
Hierarki Direktori Penyedia WSMan
Hierarki direktori penyedia WSMan untuk komputer lokal adalah sebagai berikut.
WSMan:\localhost
--- Client
--- Service
--- Shell
--- Listener
------ <Specific_Listener>
--- Plugin
------ Event Forwarding Plugin
--------- InitializationParameters
--------- Resources
------------ Security
------ Microsoft.Powershell
--------- InitializationParameters
--------- Resources
------------ Security
------ WMI Provider
--------- InitializationParameters
--------- Resources
------------ Security
--- ClientCertificate
Hierarki direktori penyedia WSMan untuk komputer jarak jauh sama dengan komputer lokal. Namun, untuk mengakses pengaturan konfigurasi komputer jarak jauh, Anda perlu membuat koneksi ke komputer jarak jauh menggunakan Connect-WSMan. Setelah koneksi dibuat ke komputer jarak jauh, nama komputer jarak jauh muncul di penyedia.
WSMan:\<Remote_Computer_Name>
Menavigasi WSMan: Drive
Perintah ini menggunakan Set-Location cmdlet untuk mengubah lokasi saat ini ke WSMan: drive.
Set-Location WSMan:
Untuk kembali ke drive sistem file, ketik nama drive. Misalnya, ketik.
Set-Location C:
Menavigasi ke lokasi penyimpanan sistem jarak jauh
Perintah ini menggunakan Set-Location perintah untuk mengubah lokasi saat ini ke lokasi akar di lokasi penyimpanan sistem jarak jauh. Gunakan garis miring \ terbelakang atau garis miring / untuk menunjukkan tingkat WSMan: drive.
Set-Location -Path WSMan:\SERVER01
Catatan
Perintah di atas mengasumsikan bahwa koneksi ke sistem jarak jauh sudah ada.
Menampilkan Konten WSMan: Drive
Perintah ini menggunakan Get-Childitem cmdlet untuk menampilkan penyimpanan WS-Management di lokasi penyimpanan Localhost.
Get-ChildItem -path WSMan:\Localhost
Jika Anda berada di WSMan: drive, Anda dapat menghilangkan nama drive.
Perintah ini menggunakan Get-Childitem cmdlet untuk menampilkan penyimpanan WS-Management di lokasi penyimpanan "SERVER01" komputer jarak jauh.
Get-ChildItem -path WSMan:\SERVER01
Catatan
Perintah di atas mengasumsikan bahwa koneksi ke sistem jarak jauh sudah ada.
Mengatur nilai item di WSMAN: drive
Anda dapat menggunakan Set-Item cmdlet untuk mengubah pengaturan konfigurasi di WSMAN drive. Contoh berikut menetapkan nilai TrustedHosts untuk menerima semua host dengan akhiran "contoso.com".
# You do not need to specify the -Path parameter name when using Set-Item.
PS WSMAN:\localhost\Client> Set-Item .\TrustedHosts -Value "*.contoso.com"
Set-Item Cmdlet mendukung parameter -Concatenate tambahan yang menambahkan nilai alih-alih mengubahnya. Contoh berikut akan menambahkan nilai baru "*.domain2.com" ke nilai lama yang disimpan di TrustedHost:
Set-Item WSMAN:\localhost\Client\TrustedHosts *.domain2.com -Concatenate
Membuat item di WSMAN: drive
Membuat pendengar baru
New-Item Cmdlet membuat item dalam drive penyedia. Setiap penyedia memiliki jenis item berbeda yang dapat Anda buat. WSMAN: Di drive, Anda dapat membuat Listener yang Anda konfigurasi untuk menerima dan merespons permintaan jarak jauh. Perintah berikut membuat pendengar HTTP baru menggunakan New-Item cmdlet .
New-Item -Path WSMan:\localhost\Listener -Address * -Transport HTTP -force
Membuat plug-in baru
Perintah ini membuat (mendaftarkan) plug-in untuk layanan WS-Management.
New-Item -Path WSMan:\localhost\Plugin `
-Plugin TestPlugin `
-FileName %systemroot%\system32\WsmWmiPl.dll `
-Resource http://schemas.dmtf.org/wbem/wscim/2/cim-schema `
-SDKVersion 1 `
-Capability "Get","Put","Invoke","Enumerate" `
-XMLRenderingType text
Membuat entri sumber daya baru
Perintah ini membuat entri sumber daya di direktori Sumber Daya testPlugin. Perintah ini mengasumsikan bahwa TestPlugin telah dibuat menggunakan perintah terpisah.
New-Item -Path WSMan:\localhost\Plugin\TestPlugin\Resources `
-ResourceUri http://schemas.dmtf.org/wbem/wscim/3/cim-schema `
-Capability "Enumerate"
Membuat entri keamanan baru untuk sumber daya
Perintah ini membuat entri keamanan di direktori Keamanan Resource_5967683 (sumber daya tertentu). Perintah ini mengasumsikan bahwa entri sumber daya telah dibuat menggunakan perintah terpisah.
$path = "WSMan:\localhost\Plugin\TestPlugin\Resources\Resource_5967683"
New-Item -Path $path\Security `
-Sddl "O:NSG:BAD:P(A;;GA;;;BA)S:P(AU;FA;GA;;;WD)(AU;SA;GWGX;;;WD)"
Membuat Sertifikat Klien baru
Perintah ini membuat entri ClientCertificate yang dapat digunakan oleh klien WS-Management. ClientCertificate baru akan muncul di bawah direktori ClientCertificate sebagai "ClientCertificate_1234567890". Semua parameter bersifat wajib. Penerbit harus menjadi thumbprint sertifikat penerbit.
$cred = Get-Credential
New-Item -Path WSMan:\localhost\ClientCertificate `
-Issuer 1b3fd224d66c6413fe20d21e38b304226d192dfe `
-URI wmicimv2/* `
-Credential $cred;
Membuat Parameter Inisialisasi baru
Perintah ini membuat parameter Inisialisasi bernama "testparametername" di direktori "InitializationParameters". Perintah ini mengasumsikan bahwa "TestPlugin" telah dibuat menggunakan perintah terpisah.
New-Item -Path WSMan:\localhost\Plugin\TestPlugin\InitializationParameters `
-ParamName testparametername `
-ParamValue testparametervalue
Parameter dinamis
Parameter dinamis adalah parameter cmdlet yang ditambahkan oleh penyedia PowerShell dan hanya tersedia saat cmdlet digunakan di drive yang diaktifkan penyedia.
String Alamat <>
Menentukan alamat tempat pendengar ini dibuat. Nilainya bisa menjadi salah satu dari berikut ini:
- String harfiah "*". (Karakter kartubebas (
*) membuat perintah mengikat semua alamat IP pada semua adaptor jaringan.) - String harfiah "IP:" diikuti oleh alamat IP yang valid dalam format IPv4 dotted-decimal atau dalam format IPv6 cloned-hexadecimal.
- String harfiah "MAC:" diikuti oleh alamat MAC adaptor. Misalnya: MAC:32-a3-58-90-be-cc.
Catatan
Nilai Alamat diatur saat membuat Listener.
Cmdlet yang didukung
<Enumerasi Kemampuan>
Saat bekerja dengan Plug-in , parameter ini menentukan operasi yang didukung pada Pengidentifikasi Sumber Daya Seragam (URI) ini. Anda harus membuat satu entri untuk setiap jenis operasi yang didukung URI. Anda dapat menentukan atribut yang valid untuk operasi tertentu, jika operasi mendukungnya.
Atribut ini termasuk SupportsFiltering dan SupportsFragment.
- Buat: Buat operasi didukung pada URI.
- Atribut SupportFragment digunakan jika operasi Buat mendukung konsep.
- Atribut SupportFiltering TIDAK valid untuk Membuat operasi dan harus diatur ke "False".
Catatan
Operasi ini tidak valid untuk URI jika operasi Shell juga didukung.
- Hapus: Operasi penghapusan didukung pada URI.
- Atribut SupportFragment digunakan jika operasi Hapus mendukung konsep.
- Atribut SupportFiltering TIDAK valid untuk operasi Hapus dan harus diatur ke "False".
Catatan
Operasi ini tidak valid untuk URI jika operasi Shell juga didukung.
- Hitung: Menghitung operasi didukung pada URI.
- Atribut SupportFragment TIDAK didukung untuk operasi Enumerasi dan harus diatur ke False.
- Atribut SupportFiltering valid, dan jika plug-in mendukung pemfilteran, atribut ini harus diatur ke "True".
Catatan
Operasi ini tidak valid untuk URI jika operasi Shell juga didukung.
- Get: Operasi get didukung pada URI.
- Atribut SupportFragment digunakan jika operasi Get mendukung konsep.
- Atribut SupportFiltering TIDAK valid untuk operasi Get dan harus diatur ke "False".
Catatan
Operasi ini tidak valid untuk URI jika operasi Shell juga didukung.
- Panggil: Operasi pemanggilan didukung pada URI.
- Atribut SupportFragment tidak didukung untuk operasi Invoke dan harus diatur ke False.
- Atribut SupportFiltering tidak valid dan harus diatur ke "False".
Catatan
Operasi ini tidak valid untuk URI jika operasi Shell juga didukung.
- Put: Operasi put didukung pada URI.
- Atribut SupportFragment digunakan jika operasi Put mendukung konsep.
- Atribut SupportFiltering tidak valid untuk operasi Put dan harus diatur ke "False".
Catatan
Operasi ini tidak valid untuk URI jika operasi Shell juga didukung.
- Berlangganan: Operasi berlangganan didukung pada URI.
- Atribut SupportFragment tidak didukung untuk operasi Berlangganan dan harus diatur ke False.
- Atribut SupportFiltering tidak valid untuk operasi Berlangganan dan harus diatur ke "False".
Catatan
Operasi ini tidak valid untuk URI jika operasi Shell juga didukung.
- Shell: Operasi shell didukung pada URI.
- Atribut SupportFragment tidak didukung untuk operasi Shell dan harus diatur ke "False".
- Atribut SupportFiltering tidak valid untuk operasi Shell dan harus diatur ke "False".
Catatan
Operasi ini tidak valid untuk URI jika ada operasi lain yang juga didukung.
Catatan
Jika operasi Shell dikonfigurasi untuk operasi URI, Get, Put, Create, Delete, Invoke, dan Enumerate diproses secara internal dalam layanan WS-Management (WinRM) untuk mengelola shell. Akibatnya, plug-in tidak dapat menangani operasi.
Cmdlet yang didukung
String CertificateThumbprint <>
Menentukan thumbprint sertifikat layanan.
Nilai ini mewakili string nilai heksadesimal dua digit di bidang Thumbprint sertifikat. Ini menentukan sertifikat kunci publik digital (X509) dari akun pengguna yang memiliki izin untuk melakukan tindakan ini. Sertifikat digunakan dalam autentikasi berbasis sertifikat klien. Mereka hanya dapat dipetakan ke akun pengguna lokal, dan mereka tidak berfungsi dengan akun domain. Untuk mendapatkan thumbprint sertifikat, gunakan Get-Item cmdlet atau Get-ChildItem di drive PowerShell Cert: .
Cmdlet yang didukung
Boolean diaktifkan <>
Menentukan apakah pendengar diaktifkan atau dinonaktifkan. Default-nya adalah True.
Cmdlet yang Didukung
String FileName (Plugin) <>
Menentukan nama file plug-in operasi. Variabel lingkungan apa pun yang dimasukkan ke dalam entri ini akan diperluas dalam konteks pengguna saat permintaan diterima. Karena setiap pengguna dapat memiliki versi yang berbeda dari variabel lingkungan yang sama, setiap pengguna dapat memiliki plug-in yang berbeda. Entri ini tidak boleh kosong dan harus menunjuk ke plug-in yang valid.
Cmdlet yang Didukung
String Nama <Host>
Menentukan nama host komputer tempat layanan WS-Management (WinRM) berjalan.
Nilai harus berupa nama domain yang sepenuhnya memenuhi syarat, string harfiah IPv4 atau IPv6, atau karakter kartubebas.
Cmdlet yang Didukung
String Pengeluar <Sertifikat>
Menentukan nama otoritas sertifikasi yang menerbitkan sertifikat.
Cmdlet yang Didukung
Plug-in <> WS-Management plugin adalah pustaka tautan dinamis asli (DLL)
yang menyambungkan ke dan memperluas fungsionalitas WS-Management . WSW-Management Plug-in API menyediakan fungsionalitas yang memungkinkan pengguna menulis plug-in dengan menerapkan API tertentu untuk URI dan operasi sumber daya yang didukung. Setelah plug-in dikonfigurasi untuk layanan WS-Management (WinRM) atau untuk Layanan Informasi Internet (IIS), plug-in dimuat di host WS-Management atau di host IIS. Permintaan jarak jauh dirutekan ke titik masuk plug-in ini untuk melakukan operasi.
Cmdlet yang Didukung
Bilangan Bulat Pendek Port <Tidak Ditandatangani>
Menentukan port TCP tempat pendengar ini dibuat. Anda dapat menentukan nilai apa pun dari 1 hingga 65535.
Cmdlet yang Didukung
String Sumber Daya <>
Menentukan titik akhir yang mewakili jenis operasi atau nilai manajemen yang berbeda. Layanan mengekspos satu atau beberapa sumber daya, dan beberapa sumber daya dapat memiliki lebih dari satu instans. Sumber daya manajemen mirip dengan kelas WMI atau tabel database, dan instans mirip dengan instans kelas atau baris dalam tabel. Misalnya, kelas Win32_LogicalDisk mewakili sumber daya. Win32_LogicalDisk="C:\\" adalah instans sumber daya tertentu.
Pengidentifikasi Sumber Daya Seragam (URI) berisi awalan dan jalur ke sumber daya. Contohnya:
http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk
http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_NumericSensor
Cmdlet yang Didukung
String Sumber Daya <>
Menentukan Pengidentifikasi Sumber Daya Seragam (URI) yang mengidentifikasi jenis sumber daya tertentu, seperti disk atau proses, di komputer.
URI terdiri dari awalan dan jalur ke sumber daya. Contohnya:
http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk
http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_NumericSensor
Cmdlet yang Didukung
String SDKVersion <>
Menentukan versi SDK plug-in WS-Management. Satu-satunya nilai yang valid adalah 1.
Cmdlet yang Didukung
String Subjek <>
Menentukan entitas yang diidentifikasi oleh sertifikat.
Cmdlet yang Didukung
String Transportasi <>
Menentukan transportasi yang akan digunakan untuk mengirim dan menerima permintaan dan respons protokol WS-Management. Nilainya harus HTTP atau HTTPS.
Catatan: Nilai Transportasi diatur saat membuat Listener.
Cmdlet yang Didukung
String URI <>
Mengidentifikasi URI yang aksesnya diotorisasi berdasarkan nilai parameter Sddl.
Cmdlet yang Didukung
String URLPrefix <>
Awalan URL untuk menerima permintaan HTTP atau HTTPS. Ini adalah string yang hanya berisi karakter [a-z], , , [9-0]garis bawah (_) dan garis miring terbelakang (/[A-Z]). String tidak boleh dimulai dengan atau diakhir dengan garis miring terbelakang (/). Misalnya, jika nama komputer adalah "SampleComputer", klien WS-Management akan menentukan http://SampleMachine/URLPrefix di alamat tujuan.
Cmdlet yang Didukung
String Nilai <>
Menentukan nilai parameter inisialisasi, yang merupakan nilai khusus plug-in yang digunakan untuk menentukan opsi konfigurasi.
Cmdlet yang Didukung
String XMLRenderingType <>
Menentukan format di mana XML diteruskan ke plug-in melalui objek WSMAN_DATA . Berikut ini adalah nilai yang valid:
- Teks: Data XML masuk terkandung dalam struktur WSMAN_DATA_TYPE_TEXT , yang mewakili XML sebagai buffer memori PCWSTR .
- XMLReader: Data XML masuk terkandung dalam struktur WSMAN_DATA_TYPE_WS_XML_READER , yang mewakili XML sebagai objek XmlReader , yang didefinisikan dalam file header "WebServices.h".
Cmdlet yang Didukung
Menggunakan alur
Cmdlet penyedia menerima input alur. Anda dapat menggunakan alur untuk menyederhanakan tugas dengan mengirim data penyedia dari satu cmdlet ke cmdlet penyedia lain. Untuk membaca selengkapnya tentang cara menggunakan alur dengan cmdlet penyedia, lihat referensi cmdlet yang disediakan di seluruh artikel ini.
Mendapatkan bantuan
Mulai dari Windows PowerShell 3.0, Anda bisa mendapatkan topik bantuan yang disesuaikan untuk cmdlet penyedia yang menjelaskan bagaimana cmdlet tersebut bereaksi dalam drive sistem file.
Untuk mendapatkan topik bantuan yang disesuaikan untuk drive sistem file, jalankan perintah Get-Help di drive sistem file atau gunakan -Path parameter Get-Help untuk menentukan drive sistem file.
Get-Help Get-ChildItem
Get-Help Get-ChildItem -Path wsman: