Aracılığıyla paylaş

about_WSMan_Provider

  • Makale

Sağlayıcı adı

WSMan

Sürücüler

WSMan:

Kısa açıklama

Yönetim için Web Hizmetleri (WS-Management) yapılandırma bilgilerine erişim sağlar.

Ayrıntılı açıklama

Bu bilgiler yalnızca Windows üzerinde çalışan PowerShell için geçerlidir.

PowerShell için WSMan sağlayıcısı yerel veya uzak bilgisayarlarda WS-Management yapılandırma verilerini eklemenize, değiştirmenize, temizlemenize ve silmenize olanak tanır.

WSMan sağlayıcısı, WS-Management yapılandırma ayarlarının mantıksal bir gruplandırmasına karşılık gelen dizin yapısına sahip bir PowerShell sürücüsünü kullanıma sunar. Bu gruplandırmalar kapsayıcı olarak bilinir.

Windows PowerShell 3.0'da başlayan WSMan sağlayıcısı, OutputBufferingMode gibi oturum yapılandırmaları için yeni özellikleri destekleyecek şekilde güncelleştirildi. Oturum yapılandırmaları sürücünün Eklenti dizininde WSMan: öğeler olarak, özellikler ise her oturum yapılandırmasında öğeler olarak görünür.

WSMan sağlayıcısı, bu makalede ele alınan aşağıdaki cmdlet'leri destekler.

Not

Yeni özelliklerin WSMan: değerlerini değiştirmek için sürücüdeki komutları kullanabilirsiniz. Ancak, Windows PowerShell 3.0'da sunulan özellikleri değiştirmek için PowerShell 2.0'daki sürücüyü kullanamazsınız WSMan: . Hata oluşturulmasa da, komutlar etkili değildir Bu ayarları değiştirmek için Windows PowerShell 3.0'da WSMan sürücüsünü kullanın.

WSMan' in Kuruluşu: Sürücü

  • İstemci: WS-Management istemcisinin çeşitli yönlerini yapılandırabilirsiniz. Yapılandırma bilgileri kayıt defterinde depolanır.

  • Hizmet: WS-Management hizmetinin çeşitli yönlerini yapılandırabilirsiniz. Yapılandırma bilgileri kayıt defterinde depolanır.

    Not

    Hizmet yapılandırması bazen Sunucu yapılandırması olarak adlandırılır.

  • Kabuk: Uzak kabuk erişimine (AllowRemoteShellAccess) izin verme ayarı ve izin verilen en fazla eşzamanlı kullanıcı sayısı (MaxConcurrentUsers) gibi WS-Management kabuğunun çeşitli yönlerini yapılandırabilirsiniz.

  • Dinleyici: Dinleyici oluşturabilir ve yapılandırabilirsiniz. Dinleyici, ileti göndermek ve almak için WS-Management protokolunu uygulayan bir yönetim hizmetidir.

  • Eklenti: Eklentiler WS-Management hizmeti tarafından çeşitli işlevler sağlamak için yüklenir ve kullanılır. PowerShell varsayılan olarak üç eklenti sağlar:

    • Olay İletme eklentisi.
    • Microsoft.PowerShell eklentisi.
    • Windows Yönetim Araçları (WMI) Sağlayıcısı eklentisi. Bu üç eklenti olay iletmeyi, yapılandırmayı ve WMI erişimini destekler.

  • ClientCertificate: İstemci sertifikası oluşturabilir ve yapılandırabilirsiniz. WS-Management istemcisi sertifika kimlik doğrulamasını kullanacak şekilde yapılandırıldığında bir istemci sertifikası kullanılır.

WSMan Sağlayıcısının Dizin Hiyerarşisi

Yerel bilgisayar için WSMan sağlayıcısının dizin hiyerarşisi aşağıdaki gibidir.

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

Uzak bir bilgisayar için WSMan sağlayıcısının dizin hiyerarşisi yerel bilgisayarla aynıdır. Ancak, uzak bilgisayarın yapılandırma ayarlarına erişmek için Connect-WSMan kullanarak uzak bilgisayara bağlantı kurmanız gerekir. Uzak bir bilgisayara bağlantı yapıldıktan sonra, uzak bilgisayarın adı sağlayıcıda gösterilir.

WSMan:\<Remote_Computer_Name>

Bu komut, geçerli konumu sürücüye Set-Location değiştirmek için cmdlet'ini WSMan: kullanır.

Set-Location WSMan:

Bir dosya sistemi sürücüsüne dönmek için sürücü adını yazın. Örneğin, yazın.

Set-Location C:

Bu komut, Set-Location geçerli konumu uzak sistem deposu konumundaki kök konumuna değiştirmek için komutunu kullanır. Sürücünün düzeyini \ belirtmek için ters eğik / çizgi veya eğik çizgi WSMan: kullanın.

Set-Location -Path  WSMan:\SERVER01

Not

Yukarıdaki komut, uzak sisteme bir bağlantının zaten mevcut olduğunu varsayar.

WSMan: Sürücüsünün İçeriğini Görüntüleme

Bu komut, WS-Management depolarını Localhost deposu konumunda görüntülemek için cmdlet'ini kullanır Get-ChildItem .

Get-ChildItem -Path WSMan:\Localhost

Sürücüdeyseniz WSMan: , sürücü adını atlayabilirsiniz.

Bu komut, uzak bilgisayar "SERVER01" depolama konumunda WS-Management depolarını görüntülemek için cmdlet'ini kullanır Get-ChildItem .

Get-ChildItem -Path WSMan:\SERVER01

Not

Yukarıdaki komut, uzak sisteme bir bağlantının zaten mevcut olduğunu varsayar.

WSMan: sürücüsündeki öğelerin değerini ayarlama

Sürücüdeki Set-Item yapılandırma ayarlarını değiştirmek için cmdlet'ini WSMan: kullanabilirsiniz. Aşağıdaki örnek, TrustedHosts değerini "contoso.com" son ekine sahip tüm konakları kabul etmek üzere ayarlar.

# 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, değiştirmek yerine bir değer ekleyen ek bir parametreyi -Concatenate destekler. Aşağıdaki örnek, içinde depolanan eski değere yeni bir "*.domain2.com" değeri ekler TrustedHost:

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

WSMan: sürücüsünde öğe oluşturma

Yeni dinleyici oluşturma

cmdlet'i New-Item bir sağlayıcı sürücüsü içinde öğeler oluşturur. Her sağlayıcının oluşturabileceğiniz farklı öğe türleri vardır. SürücüdeWSMan:, uzak istekleri almak ve yanıtlamak için yapılandırdığınız Dinleyiciler oluşturabilirsiniz. Aşağıdaki komut, cmdlet'ini kullanarak yeni bir HTTP dinleyicisi New-Item oluşturur.

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

Yeni eklenti oluşturma

Bu komut, WS-Management hizmeti için bir eklenti oluşturur (kaydeder).

New-Item -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

Yeni kaynak girişi oluşturma

Bu komut, TestPlugin'in Resources dizininde bir kaynak girdisi oluşturur. Bu komut, ayrı bir komut kullanılarak bir TestPlugin oluşturulduğunu varsayar.

New-Item -Path WSMan:\localhost\Plugin\TestPlugin\Resources `
         -ResourceUri http://schemas.dmtf.org/wbem/wscim/3/cim-schema `
         -Capability "Enumerate"

Kaynak için yeni bir güvenlik girdisi oluşturma

Bu komut, Resource_5967683 Güvenlik dizininde (belirli bir kaynak) bir güvenlik girdisi oluşturur. Bu komut, kaynak girişinin ayrı bir komut kullanılarak oluşturulduğunu varsayar.

$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)"

Yeni bir İstemci Sertifikası oluşturma

Bu komut, WS-Management istemcisi tarafından kullanılabilecek ClientCertificate girdisi oluşturur. Yeni ClientCertificate, ClientCertificate dizini altında "ClientCertificate_1234567890" olarak gösterilir. Tüm parametreler zorunlu. Verenin, verenler sertifikasının parmak izi olması gerekir.

$cred = Get-Credential
New-Item -Path WSMan:\localhost\ClientCertificate `
         -Issuer 1b3fd224d66c6413fe20d21e38b304226d192dfe `
         -Uri wmicimv2/* `
         -Credential $cred;

Yeni başlatma parametresi oluşturma

Bu komut, "InitializationParameters" dizininde "testparametername" adlı bir Başlatma parametresi oluşturur. Bu komut, "TestPlugin" öğesinin ayrı bir komut kullanılarak oluşturulduğunu varsayar.

New-Item -Path WSMan:\localhost\Plugin\TestPlugin\InitializationParameters `
         -ParamName testparametername `
         -ParamValue testparametervalue

Dinamik parametreler

Dinamik parametreler, bir PowerShell sağlayıcısı tarafından eklenen cmdlet parametreleridir ve yalnızca cmdlet sağlayıcı etkin sürücüde kullanıldığında kullanılabilir.

Adres <Dizesi>

Bu dinleyicinin oluşturulduğu adresi belirtir. Değer aşağıdakilerden biri olabilir:

  • Değişmez değer dizesi "*". (Joker karakter (*), komutun tüm ağ bağdaştırıcıları üzerindeki tüm IP adreslerini bağlamasını sağlar.)
  • "IP:" sabit dizesinin ardından IPv4 noktalı ondalık biçiminde veya IPv6 kopyalanmış onaltılık biçiminde geçerli bir IP adresi gelir.
  • "MAC:" değişmez dizesi ve ardından bağdaştırıcının MAC adresi. Örneğin: MAC:32-a3-58-90-be-cc.

Not

Dinleyici oluşturulurken Adres değeri ayarlanır.

Desteklenen cmdlet'ler

Yetenek Numaralandırması <>

Eklentilerle çalışırken bu parametre, bu Tekdüzen Kaynak Tanımlayıcısı'nda (URI) desteklenen bir işlemi belirtir. URI'nin desteklediği her işlem türü için bir giriş oluşturmanız gerekir. İşlem destekliyorsa, belirli bir işlem için geçerli öznitelikleri belirtebilirsiniz.

Bu öznitelikler SupportsFiltering ve SupportsFragment'ı içerir.

  • Oluşturma: Oluşturma işlemleri URI'de desteklenir.
    • Create işlemi kavramı destekliyorsa SupportFragment özniteliği kullanılır.
    • SupportFiltering özniteliği Oluşturma işlemleri için GEÇERLI DEĞİlDİ ve "False" olarak ayarlanmalıdır.

    Not

    Kabuk işlemleri de destekleniyorsa bu işlem URI için geçerli değildir.

  • Sil: Silme işlemleri URI'de desteklenir.
    • Delete işlemi kavramı destekliyorsa SupportFragment özniteliği kullanılır.
    • SupportFiltering özniteliği Silme işlemleri için GEÇERLI DEĞİlDİ ve "False" olarak ayarlanmalıdır.

    Not

    Kabuk işlemleri de destekleniyorsa bu işlem URI için geçerli değildir.

  • Numaralandırma: Numaralandırma işlemleri URI'de desteklenir.
    • Enumerate işlemleri için SupportFragment özniteliği DESTEKLENMEZ ve False olarak ayarlanmalıdır.
    • SupportFiltering özniteliği geçerlidir ve eklenti filtrelemeyi destekliyorsa, bu öznitelik "True" olarak ayarlanmalıdır.

    Not

    Kabuk işlemleri de destekleniyorsa bu işlem URI için geçerli değildir.

  • Alma: Alma işlemleri URI'de desteklenir.
    • Get işlemi kavramı destekliyorsa SupportFragment özniteliği kullanılır.
    • SupportFiltering özniteliği Get işlemleri için GEÇERLI DEĞİlDİ ve "False" olarak ayarlanmalıdır.

    Not

    Kabuk işlemleri de destekleniyorsa bu işlem URI için geçerli değildir.

  • Invoke: Çağırma işlemleri URI'de desteklenir.
    • SupportFragment özniteliği Invoke işlemleri için desteklenmez ve False olarak ayarlanmalıdır.
    • SupportFiltering özniteliği geçerli değil ve "False" olarak ayarlanmalıdır.

    Not

    Kabuk işlemleri de destekleniyorsa bu işlem URI için geçerli değildir.

  • Put: Put işlemleri URI'de desteklenir.
    • Put işlemi kavramı destekliyorsa SupportFragment özniteliği kullanılır.
    • SupportFiltering özniteliği Put işlemleri için geçerli değildir ve "False" olarak ayarlanmalıdır.

    Not

    Kabuk işlemleri de destekleniyorsa bu işlem URI için geçerli değildir.

  • Abone ol: Abone olma işlemleri URI'de desteklenir.
    • SupportFragment özniteliği Subscribe işlemleri için desteklenmez ve False olarak ayarlanmalıdır.
    • SupportFiltering özniteliği Subscribe işlemleri için geçerli değildir ve "False" olarak ayarlanmalıdır.

    Not

    Kabuk işlemleri de destekleniyorsa bu işlem URI için geçerli değildir.

  • Kabuk: Kabuk işlemleri URI'de desteklenir.
    • SupportFragment özniteliği Kabuk işlemleri için desteklenmez ve "False" olarak ayarlanmalıdır.
    • SupportFiltering özniteliği Kabuk işlemleri için geçerli değildir ve "False" olarak ayarlanmalıdır.

    Not

    Başka herhangi bir işlem de destekleniyorsa bu işlem URI için geçerli değildir.

    Not

    Kabuk işlemi bir URI için yapılandırılmışsa, kabukları yönetmek için WS-Management (WinRM) hizmeti içinde Alma, Yerleştirme, Oluşturma, Oluşturma, Silme, Çağırma ve Numaralandırma işlemleri dahili olarak işlenir. Sonuç olarak, eklenti işlemleri işleyemez.

Desteklenen cmdlet'ler

CertificateThumbprint <Dizesi>

Hizmet sertifikasının parmak izini belirtir.

Bu değer, sertifikanın Parmak İzi alanındaki iki basamaklı onaltılık değerlerin dizesini temsil eder. Bu eylemi gerçekleştirme izni olan bir kullanıcı hesabının dijital ortak anahtar sertifikasını (X509) belirtir. Sertifikalar, istemci sertifikası tabanlı kimlik doğrulamasında kullanılır. Bunlar yalnızca yerel kullanıcı hesaplarıyla eşlenebilir ve etki alanı hesaplarıyla çalışmaz. Sertifika parmak izi almak için PowerShell Get-Item sürücüsündeki Get-ChildItem veya Cert: cmdlet'lerini kullanın.

Desteklenen cmdlet'ler

Etkin <Boole değeri>

Dinleyicinin etkin mi yoksa devre dışı mı olduğunu belirtir. Varsayılan değer True'dur.

Desteklenen Cmdlet'ler

FileName (Eklenti) <Dizesi>

İşlem eklentisinin dosya adını belirtir. Bu girdiye yer alan tüm ortam değişkenleri, istek alındığında kullanıcıların bağlamında genişletilir. Her kullanıcının aynı ortam değişkeninin farklı bir sürümü olabileceğinden, her kullanıcının farklı bir eklentisi olabilir. Bu girdi boş olamaz ve geçerli bir eklentiye işaret etmelidir.

Desteklenen Cmdlet'ler

HostName <Dizesi>

WS-Management (WinRM) hizmetinin çalıştığı bilgisayarın ana bilgisayar adını belirtir.

Değer tam etki alanı adı, IPv4 veya IPv6 değişmez değer dizesi ya da joker karakter olmalıdır.

Desteklenen Cmdlet'ler

Veren <Dizesi>

Sertifikayı veren sertifika yetkilisinin adını belirtir.

Desteklenen Cmdlet'ler

Eklenti <> WS-Management eklentileri yerel dinamik bağlantı kitaplıklarıdır (DLL'ler)

WS-Management'a takıp işlevselliğini genişleten . WSW-Management Eklenti API'si, desteklenen kaynak URI'leri ve işlemleri için belirli API'leri uygulayarak kullanıcının eklenti yazmasına olanak tanıyan işlevler sağlar. Eklentiler WS-Management (WinRM) hizmeti veya Internet Information Services (IIS) için yapılandırıldıktan sonra, eklentiler sırasıyla WS-Management konağına veya IIS konağına yüklenir. Uzak istekler, işlemleri gerçekleştirmek için bu eklenti giriş noktalarına yönlendirilir.

Desteklenen Cmdlet'ler

Bağlantı Noktası <İşaretsiz Kısa Tamsayı>

Bu dinleyicinin oluşturulduğu TCP bağlantı noktasını belirtir. 1 ile 65535 arasında herhangi bir değer belirtebilirsiniz.

Desteklenen Cmdlet'ler

Kaynak <Dizesi>

Ayrı bir yönetim işlemi veya değeri türünü temsil eden bir uç nokta belirtir. Bir hizmet bir veya daha fazla kaynağı kullanıma sunar ve bazı kaynakların birden fazla örneği olabilir. Yönetim kaynağı WMI sınıfına veya veritabanı tablosuna benzer ve bir örnek de sınıfın örneğine veya tablodaki bir satıra benzer. Örneğin, Win32_LogicalDisk sınıfı bir kaynağı temsil eder. Win32_LogicalDisk="C:\\" kaynağın belirli bir örneğidir.

Tekdüzen Kaynak Tanımlayıcısı (URI), bir ön ek ve kaynağın yolunu içerir. Örneğin:

http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk

http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_NumericSensor

Desteklenen Cmdlet'ler

Kaynak <Dizesi>

Bilgisayardaki disk veya işlem gibi belirli bir kaynak türünü tanımlayan Tekdüzen Kaynak Tanımlayıcısı'nı (URI) belirtir.

URI bir ön ek ve kaynağın yolundan oluşur. Örneğin:

http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk

http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_NumericSensor

Desteklenen Cmdlet'ler

SDKVersion <Dizesi>

WS-Management eklenti SDK'sının sürümünü belirtir. Tek geçerli değer 1'dir.

Desteklenen Cmdlet'ler

Konu <Dizesi>

Sertifika tarafından tanımlanan varlığı belirtir.

Desteklenen Cmdlet'ler

Aktarım <Dizesi>

WS-Management protokol isteklerini ve yanıtlarını göndermek ve almak için kullanılacak aktarımı belirtir. Değer http veya https olmalıdır.

Not: Dinleyici oluşturulurken Aktarım değeri ayarlanır.

Desteklenen Cmdlet'ler

URI <Dizesi>

Erişimin yetkilendirildiği URI'yi Sddl parametresinin değerine göre tanımlar.

Desteklenen Cmdlet'ler

URLPrefix <Dizesi>

HTTP veya HTTPS isteklerinin kabul edildiği URL ön eki. Bu, yalnızca , , , [a-z][A-Z]alt çizgi () ve ters eğik çizgi ([9-0]_) karakterlerini /içeren bir dizedir. Dize, ters eğik çizgiyle (/) başlamamalı veya bitmemelidir. Örneğin, bilgisayar adı "SampleComputer" ise WS-Management istemcisi hedef adreste belirtir http://SampleMachine/URLPrefix .

Desteklenen Cmdlet'ler

Değer <Dizesi>

Yapılandırma seçeneklerini belirtmek için kullanılan eklentiye özgü bir değer olan başlatma parametresinin değerini belirtir.

Desteklenen Cmdlet'ler

XMLRenderingType <Dizesi>

XML'nin WSMAN_DATA nesnesi aracılığıyla eklentilere geçirildiği biçimi belirtir. Geçerli değerler şunlardır:

  • Metin: Gelen XML verileri, XML'yi PCWSTR bellek arabelleği olarak temsil eden WSMAN_DATA_TYPE_TEXT bir yapıda yer alır.
  • XMLReader: Gelen XML verileri, XML'yi "WebServices.h" üst bilgi dosyasında tanımlanan XmlReader nesnesi olarak temsil eden bir WSMAN_DATA_TYPE_WS_XML_READER yapısında yer alır.

Desteklenen Cmdlet'ler

İşlem hattını kullanma

Sağlayıcı cmdlet'leri işlem hattı girişini kabul eder. Bir cmdlet'ten başka bir sağlayıcı cmdlet'ine sağlayıcı verileri göndererek görevi basitleştirmek için işlem hattını kullanabilirsiniz. İşlem hattını sağlayıcı cmdlet'leriyle kullanma hakkında daha fazla bilgi edinmek için bu makalenin tamamında sağlanan cmdlet başvurularına bakın.

Yardım alma

Windows PowerShell 3.0'dan başlayarak, bu cmdlet'lerin bir dosya sistemi sürücüsünde nasıl davrandığını açıklayan sağlayıcı cmdlet'leri için özelleştirilmiş yardım konuları alabilirsiniz.

Dosya sistemi sürücüsü için özelleştirilmiş yardım konularını almak için bir dosya sistemi sürücüsünde Get-Help komutunu çalıştırın veya Get-Help parametresini kullanarak -Path bir dosya sistemi sürücüsü belirtin.

Get-Help Get-ChildItem

Get-Help Get-ChildItem -Path WSMan:

Ayrıca bkz.