about_WSMan_Provider

  • Artikel

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.

Dimulai di 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 dalam registri.

  • Layanan: Anda dapat mengonfigurasi berbagai aspek layanan WS-Management. Informasi konfigurasi disimpan dalam 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).

  • Listener: Anda dapat membuat dan mengonfigurasi listener. Listener adalah layanan manajemen yang mengimplementasikan 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 Instrumentasi Manajemen Windows (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 Koneksi-WSMan. Setelah koneksi dibuat ke komputer jarak jauh, nama komputer jarak jauh muncul di penyedia.

WSMan:\<Remote_Computer_Name>

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:

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 mengatur 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 perlu 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 ketika cmdlet digunakan dalam drive yang diaktifkan penyedia.

String Alamat <>

Menentukan alamat tempat pendengar ini dibuat. Nilainya dapat berupa salah satu dari berikut ini:

  • String harfiah "*". (Karakter kartubebas (*) membuat perintah mengikat semua alamat IP pada semua adaptor jaringan.)
  • String literal "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.

  • Menghitung: Menghitung operasi didukung pada URI.
    • Atribut SupportFragment TIDAK didukung untuk operasi Enumerate 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. Defaultnya adalah True.

Cmdlet 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 variabel lingkungan yang sama yang berbeda, setiap pengguna dapat memiliki plug-in yang berbeda. Entri ini tidak boleh kosong dan harus menunjuk ke plug-in yang valid.

Cmdlet didukung

String HostName <>

Menentukan nama host komputer tempat layanan WS-Management (WinRM) berjalan.

Nilainya harus berupa nama domain yang sepenuhnya memenuhi syarat, string harfiah IPv4 atau IPv6, atau karakter kartubebas.

Cmdlet didukung

String Pengeluar Sertifikat <>

Menentukan nama otoritas sertifikasi yang menerbitkan sertifikat.

Cmdlet didukung

Plug-in Plugin <> WS-Management adalah pustaka tautan dinamis asli (DLL)

yang menyambungkan ke dan memperluas fungsionalitas WS-Management . API Plug-in WSW-Management 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 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 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 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 didukung

String SDKVersion <>

Menentukan versi SDK plug-in WS-Management. Satu-satunya nilai yang valid adalah 1.

Cmdlet didukung

String Subjek <>

Menentukan entitas yang diidentifikasi oleh sertifikat.

Cmdlet 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 didukung

String URI <>

Mengidentifikasi URI yang aksesnya diotorisasi berdasarkan nilai parameter Sddl.

Cmdlet didukung

String URLPrefix <>

Awalan URL untuk menerima permintaan HTTP atau HTTPS. Ini adalah string yang hanya berisi karakter [a-z], , [A-Z], [9-0]garis bawah (_) dan garis miring terbelakang (/). 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 didukung

String Nilai <>

Menentukan nilai parameter inisialisasi, yang merupakan nilai khusus plug-in yang digunakan untuk menentukan opsi konfigurasi.

Cmdlet 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 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

Dimulai di 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:

Lihat juga