about_WSMan_Provider

Nama penyedia

WSMan

Drives

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 Plugin drive WSMan: dan properti muncul sebagai item di setiap konfigurasi sesi.

Penyedia WSMan mendukung cmdlet berikut, yang tercakup dalam artikel ini.

Nota

Anda dapat menggunakan perintah di drive WSMan: untuk mengubah nilai properti baru. Namun, Anda tidak dapat menggunakan drive WSMan: 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

  • Client: Anda dapat mengonfigurasi berbagai aspek klien WS-Management. Informasi konfigurasi disimpan dalam registri.

  • Service: Anda dapat mengonfigurasi berbagai aspek layanan WS-Management. Informasi konfigurasi disimpan dalam registri.

    Nota

    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. 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 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 Connect-WSMan. Setelah koneksi dibuat ke komputer jarak jauh, nama komputer jarak jauh muncul di penyedia.

WSMan:\<Remote_Computer_Name>

Perintah ini menggunakan cmdlet Set-Location untuk mengubah lokasi saat ini ke drive WSMan:.

Set-Location WSMan:

Untuk kembali ke drive sistem file, ketik nama drive. Misalnya, ketik.

Set-Location C:

Perintah ini menggunakan perintah Set-Location untuk mengubah lokasi saat ini ke lokasi akar di lokasi penyimpanan sistem jarak jauh. Gunakan garis miring terbelakang \ atau garis miring / untuk menunjukkan tingkat drive WSMan:.

Set-Location -Path  WSMan:\SERVER01

Nota

Perintah di atas mengasumsikan bahwa koneksi ke sistem jarak jauh sudah ada.

Menampilkan konten WSMan: drive

Perintah ini menggunakan cmdlet Get-ChildItem untuk menampilkan penyimpanan WS-Management di lokasi penyimpanan Localhost.

Get-ChildItem -Path WSMan:\Localhost

Jika Anda berada di drive WSMan:, Anda dapat menghilangkan nama drive.

Perintah ini menggunakan cmdlet Get-ChildItem untuk menampilkan penyimpanan WS-Management di lokasi penyimpanan "SERVER01" komputer jarak jauh.

Get-ChildItem -Path WSMan:\SERVER01

Nota

Perintah di atas mengasumsikan bahwa koneksi ke sistem jarak jauh sudah ada.

Mengatur nilai item di WSMan: drive

Anda dapat menggunakan cmdlet Set-Item untuk mengubah pengaturan konfigurasi di drive WSMan:. 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"

cmdlet Set-Item mendukung parameter tambahan -Concatenate yang menambahkan nilai alih-alih mengubahnya. Contoh berikut akan menambahkan nilai baru "*.domain2.com" ke nilai lama yang disimpan dalam TrustedHost:

Set-Item WSMan:\localhost\Client\TrustedHosts *.domain2.com -Concatenate

Membuat item di WSMan: drive

Membuat pendengar baru

cmdlet New-Item membuat item dalam drive penyedia. Setiap penyedia memiliki jenis item berbeda yang dapat Anda buat. Di drive WSMan:, Anda dapat membuat Listeners yang Anda konfigurasi untuk menerima dan merespons permintaan jarak jauh. Perintah berikut membuat pendengar HTTP baru menggunakan cmdlet New-Item.

New-Item -Path WSMan:\localhost\Listener -Address * -Transport http -Force

Membuat plug-in baru

Perintah ini membuat (mendaftarkan) plug-in untuk layanan WS-Management.

$newItemSplat = @{
    Path = 'WSMan:\localhost\Plugin'
    Plugin = 'TestPlugin'
    FileName = "$Env:SystemRoot\system32\WsmWmiPl.dll"
    Resource = 'http://schemas.dmtf.org/wbem/wscim/2/cim-schema'
    SDKVersion = 1
    Capability = 'Get', 'Put', 'Invoke', 'Enumerate'
    XMLRenderingType = 'text'
}
New-Item @newItemSplat

Membuat entri sumber daya baru

Perintah ini membuat entri sumber daya di Resources direktori TestPlugin. Perintah ini mengasumsikan bahwa telah TestPlugin dibuat menggunakan perintah terpisah.

$newItemSplat = @{
    Path = 'WSMan:\localhost\Plugin\TestPlugin\Resources'
    ResourceUri = 'http://schemas.dmtf.org/wbem/wscim/3/cim-schema'
    Capability = "Enumerate"
}
New-Item @newItemSplat

Membuat entri keamanan baru untuk sumber daya

Perintah ini membuat entri keamanan di direktori Resource_5967683 Keamanan (sumber daya tertentu). Perintah ini mengasumsikan bahwa entri sumber daya telah dibuat menggunakan perintah terpisah.

$path = "WSMan:\localhost\Plugin\TestPlugin\Resources\Resource_5967683"
$newItemSplat = @{
    Path = "$path\Security"
    Sddl = "O:NSG:BAD:P(A;;GA;;;BA)S:P(AU;FA;GA;;;WD)(AU;SA;GWGX;;;WD)"
}
New-Item @newItemSplat

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
$newItemSplat = @{
    Path = 'WSMan:\localhost\ClientCertificate'
    Issuer = '1b3fd224d66c6413fe20d21e38b304226d192dfe'
    URI = 'wmicimv2/*'
    Credential = $cred
}
New-Item @newItemSplat

Membuat Parameter Inisialisasi baru

Perintah ini membuat parameter Inisialisasi bernama testparametername dalam InitializationParameters direktori. Perintah ini mengasumsikan bahwa TestPlugin telah dibuat menggunakan perintah terpisah.

$newItemSplat = @{
    Path = 'WSMan:\localhost\Plugin\TestPlugin\InitializationParameters'
    ParamName = 'testparametername'
    ParamValue = 'testparametervalue'
}
New-Item @newItemSplat

Parameter dinamis

Parameter dinamis adalah parameter cmdlet yang ditambahkan oleh penyedia PowerShell dan hanya tersedia ketika cmdlet digunakan dalam drive yang diaktifkan penyedia.

< >String

Menentukan alamat tempat pendengar ini dibuat. Nilainya bisa menjadi salah satu dari yang 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.

Nota

Nilai Alamat diatur saat membuat Listener.

Cmdlet yang didukung

  • Item Baru

< 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: Operasi buat didukung pada URI.

    • Atribut SupportFragment digunakan jika operasi Buat mendukung konsep.
    • Atribut SupportFiltering TIDAK valid untuk Operasi buat dan harus diatur ke "False".

    Nota

    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".

    Nota

    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".

    Nota

    Operasi ini tidak valid untuk URI jika operasi Shell juga didukung.

  • Dapatkan: 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".

    Nota

    Operasi ini tidak valid untuk URI jika operasi Shell juga didukung.

  • Memanggil: Operasi pemanggilan didukung pada URI.

    • Atribut SupportFragment tidak didukung untuk operasi Panggil dan harus diatur ke False.
    • Atribut SupportFiltering tidak valid dan harus diatur ke "False".

    Nota

    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".

    Nota

    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".

    Nota

    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".

    Nota

    Operasi ini tidak valid untuk URI jika ada operasi lain yang juga didukung. 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

  • Item Baru

< 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 cmdlet Get-Item atau Get-ChildItem di drive Cert: PowerShell.

Cmdlet yang didukung

  • Item Baru

Mengaktifkan< Boolean >

Menentukan apakah pendengar diaktifkan atau dinonaktifkan. Defaultnya adalah True.

Cmdlet didukung

  • Item Baru

< 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

  • Item Baru

< 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

  • Item Baru

< String >Penerbit

Menentukan nama otoritas sertifikasi yang menerbitkan sertifikat.

Cmdlet didukung

  • Item Baru

Plugin <> WS-Management plug-in 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

  • Item Baru

Port <> Bilangan Bulat Pendek Tidak Ditandatangani

Menentukan port TCP tempat pendengar ini dibuat. Anda dapat menentukan nilai apa pun dari 1 hingga 65535.

Cmdlet didukung

  • Item Baru

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

Cmdlet didukung

  • Item Baru

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

Cmdlet didukung

  • Item Baru

< String >SDKVersion

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

Cmdlet didukung

  • Item Baru

< String >Subjek

Menentukan entitas yang diidentifikasi oleh sertifikat.

Cmdlet didukung

  • Item Baru

< String >Transportasi

Menentukan transportasi yang akan digunakan untuk mengirim dan menerima permintaan dan respons protokol WS-Management. Nilai harus http atau https.

Catatan: Nilai Transportasi diatur saat membuat Listener.

Cmdlet didukung

  • Item Baru

< String >URI

Mengidentifikasi URI yang aksesnya diotorisasi berdasarkan nilai parameter Sddl.

Cmdlet didukung

  • Item Baru

< 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

  • Item Baru

< String >Nilai

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

Cmdlet didukung

  • Item Baru

< 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 PCWSTR buffer memori.
  • 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

  • Item Baru

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 parameter -PathGet-Help untuk menentukan drive sistem file.

Get-Help Get-ChildItem

Get-Help Get-ChildItem -Path WSMan:

Lihat juga

  • Terakhir diperbarui pada