about_WSMan_Provider

  • Cikk

Szolgáltató neve

WSMan

Meghajtók

WSMan:

Rövid leírás

Hozzáférést biztosít a Web Services for Management (WS-Management) konfigurációs adataihoz.

Részletes leírás

Ezek az információk csak a Windows rendszeren futó PowerShellre vonatkoznak.

A PowerShell WSMan-szolgáltatója lehetővé teszi a WS-Management konfigurációs adatainak hozzáadását, módosítását, törlését és törlését helyi vagy távoli számítógépeken.

A WSMan-szolgáltató a WS-Management konfigurációs beállítások logikai csoportosításának megfelelő címtárstruktúrával rendelkező PowerShell-meghajtót tesz elérhetővé. Ezeket a csoportosításokat tárolóknak nevezzük.

A Windows PowerShell 3.0-tól kezdve a WSMan-szolgáltató frissült, hogy támogassa a munkamenet-konfigurációk új tulajdonságait, például az OutputBufferingMode-t. A munkamenet-konfigurációk elemekként jelennek meg a WSMan: meghajtó beépülő modulkönyvtárában, a tulajdonságok pedig elemekként jelennek meg az egyes munkamenet-konfigurációkban.

A WSMan-szolgáltató az alábbi parancsmagokat támogatja, amelyekről ebben a cikkben szó van.

Feljegyzés

A meghajtó parancsaival WSMan: módosíthatja az új tulajdonságok értékeit. A PowerShell 2.0-s meghajtóját azonban nem használhatja WSMan: a Windows PowerShell 3.0-ban bevezetett tulajdonságok módosításához. Bár nem jön létre hiba, a parancsok nem hatékonyak A beállítások módosításához használja a WSMan meghajtót a Windows PowerShell 3.0-ban.

A WSMan: Drive szervezése

  • Ügyfél: A WS-Management ügyfél különböző aspektusait konfigurálhatja. A konfigurációs adatokat a beállításjegyzék tárolja.

  • Szolgáltatás: A WS-Management szolgáltatás különböző aspektusait konfigurálhatja. A konfigurációs adatokat a beállításjegyzék tárolja.

    Feljegyzés

    A szolgáltatáskonfigurációt néha kiszolgálókonfigurációnak is nevezik.

  • Shell: A WS-Management rendszerhéj különböző aspektusait konfigurálhatja, például a távoli rendszerhéj-hozzáférés engedélyezésének beállítását (AllowRemoteShellAccess) és az egyidejűleg engedélyezett felhasználók maximális számát (MaxConcurrentUsers).

  • Figyelő: Létrehozhat és konfigurálhat figyelőt. A figyelő egy olyan felügyeleti szolgáltatás, amely implementálja a WS-Management protokollt az üzenetek küldéséhez és fogadásához.

  • Beépülő modul: A beépülő modulokat a WS-Management szolgáltatás tölti be és használja különböző funkciók biztosítására. A PowerShell alapértelmezés szerint három beépülő modult biztosít:

    • Az Eseménytovábbítás beépülő modul.
    • A Microsoft.PowerShell beépülő modul.
    • A Windows Management Instrumentation (WMI) szolgáltató beépülő modulja. Ez a három beépülő modul támogatja az eseménytovábbítást, a konfigurációt és a WMI-hozzáférést.

  • ClientCertificate: Létrehozhat és konfigurálhat ügyféltanúsítványt. Az ügyféltanúsítvány akkor használatos, ha a WS-Management ügyfél tanúsítványhitelesítés használatára van konfigurálva.

A WSMan-szolgáltató címtárhierarchiája

A helyi számítógép WSMan-szolgáltatójának címtárhierarchiája a következő.

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

A távoli számítógépek WSMan-szolgáltatójának címtárhierarchiája megegyezik a helyi számítógépével. A távoli számítógép konfigurációs beállításainak eléréséhez azonban kapcsolatot kell létesítenie a távoli számítógéppel a Csatlakozás-WSMan használatával. Miután létrejött egy kapcsolat egy távoli számítógéppel, megjelenik a távoli számítógép neve a szolgáltatóban.

WSMan:\<Remote_Computer_Name>

Ez a parancs a Set-Location parancsmaggal módosítja az aktuális helyet a WSMan: meghajtóra.

Set-Location WSMan:

Fájlrendszer-meghajtóra való visszatéréshez írja be a meghajtó nevét. Írja be például a szöveget.

Set-Location C:

Ez a parancs a Set-Location parancs használatával az aktuális helyet a távoli rendszertároló helyének gyökérhelyére módosítja. Használjon fordított perjelet \ vagy perjelet / a WSMan: meghajtó szintjének jelzéséhez.

Set-Location -Path  WSMan:\SERVER01

Feljegyzés

A fenti parancs feltételezi, hogy már létezik kapcsolat a távoli rendszerrel.

A WSMan: Meghajtó tartalmának megjelenítése

Ez a parancs a Get-Childitem parancsmaggal jeleníti meg a WS-Management tárolókat a Localhost-tároló helyén.

Get-ChildItem -path WSMan:\Localhost

Ha a WSMan: meghajtón van, kihagyhatja a meghajtó nevét.

Ez a parancs a Get-Childitem parancsmaggal jeleníti meg a WS-Management tárolókat a távoli számítógép "Standard kiadás RVER01" tárolóhelyén.

Get-ChildItem -path WSMan:\SERVER01

Feljegyzés

A fenti parancs feltételezi, hogy már létezik kapcsolat a távoli rendszerrel.

A WSMAN: meghajtó elemeinek értékének beállítása

A parancsmaggal módosíthatja a Set-ItemWSMAN meghajtó konfigurációs beállításait. Az alábbi példa a TrustedHosts értéket úgy állítja be, hogy az "contoso.com" utótaggal fogadja el az összes gazdagépet.

# You do not need to specify the -Path parameter name when using Set-Item.
PS WSMAN:\localhost\Client> Set-Item .\TrustedHosts -Value "*.contoso.com"

A Set-Item parancsmag egy további paramétert -Concatenate támogat, amely módosítás helyett hozzáfűz egy értéket. Az alábbi példa egy új "*.domain2.com" értéket fűz a régi értékhez, amely a következő helyen található: TrustedHost:

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

Elemek létrehozása a WSMAN: meghajtóban

Új figyelő létrehozása

A New-Item parancsmag egy szolgáltatói meghajtón belül hoz létre elemeket. Minden szolgáltató különböző elemtípusokkal rendelkezik, amelyeket létrehozhat. WSMAN: A meghajtón létrehozhat olyan figyelőket, amelyeket úgy konfigurál, hogy távoli kéréseket fogadjon és válaszoljon. Az alábbi parancs létrehoz egy új HTTP-figyelőt a New-Item parancsmag használatával.

New-Item -Path WSMan:\localhost\Listener -Address * -Transport HTTP -force

Új beépülő modul létrehozása

Ez a parancs létrehoz (regisztrál) egy beépülő modult a WS-Management szolgáltatáshoz.

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

Új erőforrás-bejegyzés létrehozása

Ez a parancs létrehoz egy erőforrás-bejegyzést egy TestPlugin Resources könyvtárában. Ez a parancs feltételezi, hogy egy TestPlugin egy külön paranccsal lett létrehozva.

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

Új biztonsági bejegyzés létrehozása egy erőforráshoz

Ez a parancs létrehoz egy biztonsági bejegyzést a Resource_5967683 (egy adott erőforrás) biztonsági könyvtárában. Ez a parancs feltételezi, hogy az erőforrás-bejegyzés egy külön paranccsal lett létrehozva.

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

Új ügyféltanúsítvány létrehozása

Ez a parancs létrehoz egy ClientCertificate bejegyzést, amelyet a WS-Management-ügyfél használhat. Az új ClientCertificate a ClientCertificate könyvtárban "ClientCertificate_1234567890" néven jelenik meg. Az összes paraméter kötelező. A kiállítónak a kiállítói tanúsítvány ujjlenyomatának kell lennie.

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

Új inicializálási paraméter létrehozása

Ez a parancs létrehoz egy "testparametername" nevű inicializálási paramétert az "InitializationParameters" könyvtárban. Ez a parancs feltételezi, hogy a "TestPlugin" egy külön paranccsal lett létrehozva.

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

Dinamikus paraméterek

A dinamikus paraméterek olyan parancsmagparaméterek, amelyeket egy PowerShell-szolgáltató ad hozzá, és csak akkor érhetők el, ha a parancsmagot a szolgáltató által engedélyezett meghajtón használják.

Címsztring <>

Azt a címet adja meg, amelyhez a figyelőt létrehozták. Az érték a következők egyike lehet:

  • A "*" literál sztring. (A helyettesítő karakter (*) hatására a parancs az összes hálózati adapter összes IP-címét megköti.)
  • Az "IP:" literál sztring, amelyet egy érvényes IP-cím követ IPv4 pontozott decimális vagy IPv6 klónozott hexadecimális formátumban.
  • A "MAC:" literál sztring, majd egy adapter MAC-címe. Például: MAC:32-a3-58-90-be-cc.

Feljegyzés

A Cím érték a figyelő létrehozásakor van beállítva.

Támogatott parancsmagok

<Képesség számbavétele>

A beépülő modulok használatakor ez a paraméter egy olyan műveletet határoz meg, amely támogatott ezen az egységes erőforrás-azonosítón (URI). Minden olyan művelettípushoz, amelyet az URI támogat, létre kell hoznia egy bejegyzést. Ha a művelet támogatja, bármely érvényes attribútumot megadhat egy adott művelethez.

Ezek az attribútumok közé tartozik a SupportsFiltering és a SupportsFragment.

  • Létrehozás: A létrehozási műveletek támogatottak az URI-n.
    • A SupportFragment attribútumot akkor használja a rendszer, ha a Létrehozás művelet támogatja a koncepciót.
    • A SupportFiltering attribútum nem érvényes a létrehozási műveletekhez, ezért "False" (Hamis) értékre kell állítani.

    Feljegyzés

    Ez a művelet nem érvényes URI-ra, ha a Shell-műveletek is támogatottak.

  • Törlés: A törlési műveletek támogatottak az URI-n.
    • A SupportFragment attribútumot akkor használja a rendszer, ha a Törlés művelet támogatja a koncepciót.
    • A SupportFiltering attribútum érvénytelen a Törlési műveletekhez, ezért "False" (Hamis) értékre kell állítani.

    Feljegyzés

    Ez a művelet nem érvényes URI-ra, ha a Shell-műveletek is támogatottak.

  • Enumerate: Az enumerátumi műveletek támogatottak az URI-n.
    • A SupportFragment attribútum nem támogatott az Enumerate műveletek esetében, ezért False (Hamis) értékre kell állítani.
    • A SupportFiltering attribútum érvényes, és ha a beépülő modul támogatja a szűrést, ennek az attribútumnak "True" (Igaz) értékre kell állítania.

    Feljegyzés

    Ez a művelet nem érvényes URI-ra, ha a Shell-műveletek is támogatottak.

  • Get: A get operations támogatott az URI-n.
    • A SupportFragment attribútum akkor használatos, ha a Get művelet támogatja a koncepciót.
    • A SupportFiltering attribútum nem érvényes a Get műveletekhez, ezért "False" (Hamis) értékre kell állítani.

    Feljegyzés

    Ez a művelet nem érvényes URI-ra, ha a Shell-műveletek is támogatottak.

  • Meghívás: A meghívási műveletek támogatottak az URI-n.
    • A SupportFragment attribútum nem támogatott a meghívási műveletekhez, ezért False (Hamis) értékre kell állítani.
    • A SupportFiltering attribútum érvénytelen, ezért "False" (Hamis) értékre kell állítani.

    Feljegyzés

    Ez a művelet nem érvényes URI-ra, ha a Shell-műveletek is támogatottak.

  • Put: A put műveletek támogatottak az URI-n.
    • A SupportFragment attribútum akkor használatos, ha a Put művelet támogatja a koncepciót.
    • A SupportFiltering attribútum nem érvényes a Put műveletekhez, ezért "False" (Hamis) értékre kell állítani.

    Feljegyzés

    Ez a művelet nem érvényes URI-ra, ha a Shell-műveletek is támogatottak.

  • Feliratkozás: A feliratkozási műveletek támogatottak az URI-n.
    • A SupportFragment attribútum nem támogatott a feliratkozási műveletekhez, ezért False (Hamis) értékre kell állítani.
    • A SupportFiltering attribútum nem érvényes a Feliratkozási műveletekhez, ezért "False" (Hamis) értékre kell állítani.

    Feljegyzés

    Ez a művelet nem érvényes URI-ra, ha a Shell-műveletek is támogatottak.

  • Shell: A rendszerhéjműveletek támogatottak az URI-n.
    • A SupportFragment attribútum nem támogatott a Shell-műveletek esetében, ezért "False" (Hamis) értékre kell állítani.
    • A SupportFiltering attribútum nem érvényes a Shell-műveletekhez, ezért "False" (Hamis) értékre kell állítani.

    Feljegyzés

    Ez a művelet nem érvényes URI-ra, ha bármely más művelet is támogatott.

    Feljegyzés

    Ha egy Shell-művelet URI-hoz van konfigurálva, a Rendszerhéjak kezelése érdekében a Rendszerhéjak kezelése a WS-Management (WinRM) szolgáltatáson belül történik. Emiatt a beépülő modul nem tudja kezelni a műveleteket.

Támogatott parancsmagok

CertificateThumbprint sztring <>

A szolgáltatástanúsítvány ujjlenyomatát adja meg.

Ez az érték a tanúsítvány Ujjlenyomat mezőjében szereplő kétjegyű hexadecimális értékek sztringje. Megadja egy olyan felhasználói fiók digitális nyilvános kulcsú tanúsítványát (X509), amely jogosult a művelet végrehajtására. A tanúsítványok az ügyféltanúsítvány-alapú hitelesítésben használatosak. Ezek csak helyi felhasználói fiókokra képezhetők le, és nem működnek tartományi fiókokkal. Tanúsítvány ujjlenyomatának lekéréséhez használja a Get-ItemGet-ChildItem PowerShell-meghajtó Cert: parancsmagjait.

Támogatott parancsmagok

<Engedélyezett logikai érték>

Megadja, hogy a figyelő engedélyezve van-e vagy le van-e tiltva. Az alapértelmezett érték Igaz.

Támogatott parancsmagok

FileName (beépülő modul) <sztring>

Megadja a műveleti beépülő modul fájlnevét. Az ebben a bejegyzésben szereplő környezeti változók a kérések fogadásakor ki lesznek bontva a felhasználók környezetében. Mivel minden felhasználó rendelkezhet ugyanannak a környezeti változónak egy másik verziójával, minden felhasználónak más beépülő modulja lehet. Ez a bejegyzés nem lehet üres, és érvényes beépülő modulra kell mutatnia.

Támogatott parancsmagok

HostName sztring <>

Megadja annak a számítógépnek a gazdagépnevét, amelyen a WS-Management (WinRM) szolgáltatás fut.

Az értéknek teljes tartománynévnek, IPv4 vagy IPv6 literális sztringnek vagy helyettesítő karakternek kell lennie.

Támogatott parancsmagok

Kiállítói <sztring>

A tanúsítványt kiállító hitelesítésszolgáltató nevét adja meg.

Támogatott parancsmagok

A beépülő modul <> WS-Management beépülő moduljai natív dinamikus csatolási kódtárak (DLL-ek)

A beépülő modul a WS-Management funkcióinak bővítéséhez és bővítéséhez. A WSW-Management beépülő modul API olyan funkciókat biztosít, amelyek lehetővé teszik, hogy a felhasználó beépülő modulokat írjon bizonyos API-k támogatott erőforrás-URI-khoz és műveletekhez való implementálásával. Miután a beépülő modulok a WS-Management (WinRM) szolgáltatáshoz vagy az Internet Information Serviceshez (IIS) lettek konfigurálva, a beépülő modulok a WS-Management gazdagépre vagy az IIS-gazdagépre töltődnek be. A távoli kéréseket a rendszer ezekre a beépülő modulok belépési pontjaira irányítja a műveletek végrehajtásához.

Támogatott parancsmagok

Port <aláíratlan rövid egész szám>

Azt a TCP-portot adja meg, amelyhez a figyelő létrejön. Bármilyen értéket megadhat 1 és 65535 között.

Támogatott parancsmagok

Erőforrás-sztring <>

Olyan végpontot ad meg, amely a felügyeleti művelet vagy érték eltérő típusát jelöli. Egy szolgáltatás egy vagy több erőforrást tesz elérhetővé, és egyes erőforrások több példányt is tartalmazhatnak. A felügyeleti erőforrás hasonlít egy WMI-osztályhoz vagy egy adatbázistáblához, a példányok pedig az osztály egy példányához vagy a tábla egy sorához. A Win32_LogicalDisk osztály például egy erőforrást jelöl. Win32_LogicalDisk="C:\\" az erőforrás egy adott példánya.

Az egységes erőforrás-azonosító (URI) egy előtagot és egy erőforrás elérési útját tartalmazza. Példa:

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

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

Támogatott parancsmagok

Erőforrás-sztring <>

Megadja az egységes erőforrás-azonosítót (URI), amely egy adott típusú erőforrást( például lemezt vagy folyamatot) azonosít a számítógépen.

Az URI egy előtagból és egy erőforrás elérési útból áll. Példa:

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

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

Támogatott parancsmagok

SDKVersion sztring <>

A WS-Management beépülő modul SDK-jának verzióját adja meg. Az egyetlen érvényes érték az 1.

Támogatott parancsmagok

Tárgysztring <>

A tanúsítvány által azonosított entitást adja meg.

Támogatott parancsmagok

Átviteli <sztring>

Megadja a WS-Management protokoll kéréseinek és válaszainak küldéséhez és fogadásához használandó átvitelt. Az értéknek HTTP-nek vagy HTTPS-nek kell lennie.

Megjegyzés: Az átviteli érték a figyelő létrehozásakor van beállítva.

Támogatott parancsmagok

URI-sztring <>

Az Sddl paraméter értéke alapján azonosítja azt az URI-t, amelyhez a hozzáférés engedélyezve van.

Támogatott parancsmagok

URL-címelőtag sztringje <>

EGY URL-előtag, amelyen HTTP- vagy HTTPS-kéréseket fogad el. Ez a sztring csak a karaktereket [a-z], [A-Z], [9-0]aláhúzásjelet (_) és fordított perjelet (/) tartalmazza. A sztring nem kezdődhet fordított perjellel (/). Ha például a számítógép neve "SampleComputer", a WS-Management ügyfél a célcímben adja meg http://SampleMachine/URLPrefix .

Támogatott parancsmagok

Értéksztring <>

Megadja az inicializálási paraméter értékét, amely egy beépülő modulspecifikus érték, amely a konfigurációs beállítások megadására szolgál.

Támogatott parancsmagok

XMLRenderingType karakterlánc <>

Azt a formátumot adja meg, amelyben az XML-t a beépülő modulok a WSMAN_DATA objektumon keresztül továbbítják. Az alábbi értékek érvényesek:

  • Szöveg: A bejövő XML-adatok egy WSMAN_DATA_TYPE_TEXT struktúrában találhatók, amely az XML-t PCWSTR memóriapufferként jelöli.
  • XMLReader: A bejövő XML-adatok egy WSMAN_DATA_TYPE_WS_XML_READER struktúrában találhatók, amely az XML-t XmlReader-objektumként jelöli, amely a "WebServices.h" fejlécfájlban van definiálva.

Támogatott parancsmagok

A folyamat használata

A szolgáltatói parancsmagok elfogadják a folyamatbemenetet. A folyamat használatával egyszerűsítheti a feladatokat, ha szolgáltatói adatokat küld egy parancsmagból egy másik szolgáltatói parancsmagnak. A folyamat szolgáltatói parancsmagokkal való használatával kapcsolatos további információkért tekintse meg a cikkben található parancsmag-hivatkozásokat.

Segítség kérése

A Windows PowerShell 3.0-tól kezdve testre szabott súgótémaköröket kaphat a szolgáltatói parancsmagokhoz, amelyek ismertetik, hogyan viselkednek ezek a parancsmagok a fájlrendszer-meghajtókon.

A fájlrendszer-meghajtóra szabott súgótémakörök lekéréséhez futtasson egy Get-Help parancsot egy fájlrendszer-meghajtón, vagy a -Path Get-Help paraméterrel adjon meg egy fájlrendszer-meghajtót.

Get-Help Get-ChildItem

Get-Help Get-ChildItem -Path wsman:

Lásd még