Delen via

WSMan Provider

  • Artikel

Provider naam

WSMan

Aandrijfeenheden

WSMan:

Korte beschrijving

Biedt toegang tot de configuratie gegevens van webservices voor beheer (WS-Management).

Gedetailleerde beschrijving

Met de WSMan -provider voor Power shell kunt u configuratie gegevens van WS-Management op lokale of externe computers toevoegen, wijzigen, wissen en verwijderen.

De WSMan -provider geeft een Power Shell-station met een mapstructuur die overeenkomt met een logische groepering van configuratie-instellingen van WS-Management. Deze groeperingen worden containers genoemd.

Vanaf Windows Power Shell 3,0 is de WSMan -provider bijgewerkt ter ondersteuning van nieuwe eigenschappen voor sessie configuraties, zoals OutputBufferingMode. De sessie configuraties worden weer gegeven als items in de map voor de invoeg toepassing van het WSMan: station en de eigenschappen worden weer gegeven als items in elke sessie configuratie.

De WSMan -provider ondersteunt de volgende cmdlets, die in dit artikel worden besproken.

Notitie

U kunt opdrachten in het WSMan: station gebruiken om de waarden van de nieuwe eigenschappen te wijzigen. U kunt het WSMan: station in Power shell 2,0 echter niet gebruiken voor het wijzigen van eigenschappen die zijn geïntroduceerd in Windows Power shell 3,0. Hoewel er geen fout wordt gegenereerd, zijn de opdrachten niet effectief om deze instellingen te wijzigen. gebruik het WSMan -station in Windows power Shell 3,0.

Organisatie van het WSMan: station

  • Client: u kunt verschillende aspecten van de WS-Management-client configureren. De configuratie-informatie wordt opgeslagen in het REGI ster.

  • Service: u kunt verschillende aspecten van de WS-Management-service configureren. De configuratie-informatie wordt opgeslagen in het REGI ster.

    Notitie

    Service configuratie wordt soms ook wel server configuratie genoemd.

  • Shell: u kunt verschillende aspecten van de WS-Management-Shell configureren, zoals de instelling voor het toestaan van externe shell toegang (AllowRemoteShellAccess) en het maximum aantal gelijktijdige gebruikers toegestaan (MaxConcurrentUsers).

  • Listener: u kunt een listener maken en configureren. Een listener is een beheer service die het WS-Management-protocol implementeert voor het verzenden en ontvangen van berichten.

  • Invoeg toepassing: invoeg toepassingen worden geladen en gebruikt door de WS-Management-service om verschillende functies te bieden. Power shell biedt standaard drie invoeg toepassingen:

    • De invoeg toepassing voor het door sturen van gebeurtenissen.
    • De invoeg toepassing micro soft. Power shell.
    • De invoeg toepassing van de Windows Management Instrumentation provider (WMI). Deze drie invoeg toepassingen ondersteunen gebeurtenis door sturen, configureren en WMI-toegang.

  • ClientCertificate: u kunt een client certificaat maken en configureren. Er wordt een client certificaat gebruikt wanneer de WS-Management-client is geconfigureerd voor het gebruik van verificatie via een certificaat.

Directory-hiërarchie van de WSMan-provider

De Directory-hiërarchie van de WSMan-provider voor de lokale computer is als volgt.

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

De Directory-hiërarchie van de WSMan-provider voor een externe computer is hetzelfde als een lokale computer. Om toegang te krijgen tot de configuratie-instellingen van een externe computer, moet u echter verbinding maken met de externe computer via Connect-WSMan. Zodra een verbinding met een externe computer tot stand is gebracht, wordt de naam van de externe computer weer gegeven in de provider.

WSMan:\<Remote_Computer_Name>

Met deze opdracht wordt de Set-Location cmdlet gebruikt om de huidige locatie te wijzigen in het WSMan: station.

Set-Location WSMan:

Als u wilt terugkeren naar een bestandssysteem station, typt u de naam van het station. Typ bijvoorbeeld.

Set-Location C:

Met deze opdracht wordt de Set-Location opdracht voor het wijzigen van de huidige locatie naar de hoofd locatie in de externe systeem opslag locatie. Gebruik een back slash \ of slash / om een niveau van het station aan te geven WSMan: .

Set-Location -Path  WSMan:\SERVER01

Notitie

De bovenstaande opdracht gaat ervan uit dat er al een verbinding met het externe systeem bestaat.

De inhoud van het WSMan: station weer geven

Met deze opdracht wordt de Get-Childitem cmdlet gebruikt voor het weer geven van de WS-Management-archieven in de locatie van de localhost-opslag.

Get-ChildItem -path WSMan:\Localhost

Als u zich in het station bevindt WSMan: , kunt u de naam van het station weglaten.

Met deze opdracht wordt de Get-Childitem cmdlet gebruikt om de WS-Management-archieven weer te geven op de archief locatie van de externe computer "SERVER01".

Get-ChildItem -path WSMan:\SERVER01

Notitie

De bovenstaande opdracht gaat ervan uit dat er al een verbinding met het externe systeem bestaat.

De waarde van items instellen in WSMAN: station

U kunt de Set-Item cmdlet gebruiken om de configuratie-instellingen in het station te wijzigen WSMAN . In het volgende voor beeld wordt de TrustedHosts -waarde ingesteld om alle hosts met het achtervoegsel ' contoso.com ' te accepteren.

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

De Set-Item cmdlet biedt ondersteuning voor een extra para meter -Concatenate waarmee een waarde wordt toegevoegd in plaats van deze te wijzigen. In het volgende voor beeld wordt een nieuwe waarde ' *. domain2.com ' toegevoegd aan de oude waarde die is opgeslagen inTrustedHost:

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

Items maken in het WSMAN: station

Een nieuwe listener maken

Met de New-Item cmdlet worden items in een provider station gemaakt. Elke provider heeft verschillende item typen die u kunt maken. In het WSMAN: station kunt u listeners maken die u configureert om externe aanvragen te ontvangen en erop te reageren. Met de volgende opdracht maakt u een nieuwe HTTP-listener met behulp van de- New-Item cmdlet.

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

Een nieuwe invoeg toepassing maken

Met deze opdracht wordt een invoeg toepassing voor de WS-Management-service gemaakt (geregistreerd).

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

Nieuwe resource-invoer maken

Met deze opdracht maakt u een bron vermelding in de map resources van een TestPlugin. Bij deze opdracht wordt ervan uitgegaan dat er een TestPlugin is gemaakt met behulp van een afzonderlijke opdracht.

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

Een nieuwe beveiligings vermelding voor een resource maken

Met deze opdracht maakt u een beveiligings vermelding in de map Security van Resource_5967683 (een specifieke resource). Bij deze opdracht wordt ervan uitgegaan dat de bron vermelding is gemaakt met een afzonderlijke opdracht.

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

Een nieuw client certificaat maken

Met deze opdracht maakt u een item voor ClientCertificate dat kan worden gebruikt door de WS-Management-client. De nieuwe ClientCertificate wordt weer gegeven in de map ClientCertificate als "ClientCertificate_1234567890". Alle para meters zijn verplicht. De Uitgever moet een vinger afdruk van het certificaat van de certificerings instantie zijn.

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

Een nieuwe initialisatie parameter maken

Met deze opdracht maakt u een initialisatie parameter met de naam ' testparametername ' in de map ' InitializationParameters '. Bij deze opdracht wordt ervan uitgegaan dat de ' TestPlugin ' is gemaakt met behulp van een afzonderlijke opdracht.

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

Dynamische parameters

Dynamische para meters zijn cmdlet-para meters die worden toegevoegd door een Power shell-provider en zijn alleen beschikbaar wanneer de cmdlet wordt gebruikt in het station waarvoor de provider is ingeschakeld.

Help<String>

Hiermee geeft u het adres op waarvoor deze listener is gemaakt. De waarde kan één van de volgende zijn:

  • De letterlijke teken reeks "*". (Met het Joker teken ( * ) wordt de opdracht alle IP-adressen op alle netwerk adapters gebonden.)
  • De letterlijke teken reeks ' IP: ' gevolgd door een geldig IP-adres in IPv4-decimale notatie of in een IPv6-gekloonde hexadecimale indeling.
  • De letterlijke teken reeks ' MAC: ' gevolgd door het MAC-adres van een adapter. Bijvoorbeeld: MAC: 32-a3-58 -90-CC.

Notitie

De adres waarde wordt ingesteld bij het maken van een listener.

Ondersteunde cmdlets

Voorzieningen<Enumeration>

Bij het werken met invoeg toepassingen geeft deze para meter een bewerking aan die wordt ondersteund voor deze URI (Uniform Resource Identifier). U moet één vermelding maken voor elk type bewerking dat door de URI wordt ondersteund. U kunt geldige kenmerken voor een bepaalde bewerking opgeven als de bewerking deze ondersteunt.

Deze kenmerken zijn onder andere SupportsFiltering en SupportsFragment.

  • Maken: Create-bewerkingen worden ondersteund op de URI.
    • Het kenmerk SupportFragment wordt gebruikt als de bewerking Create het concept ondersteunt.
    • Het kenmerk SupportFiltering is niet geldig voor Create-bewerkingen en moet worden ingesteld op ' false '.

    Notitie

    Deze bewerking is niet geldig voor een URI als shell bewerkingen ook worden ondersteund.

  • Verwijderen: Verwijder bewerkingen worden ondersteund op de URI.
    • Het kenmerk SupportFragment wordt gebruikt als de bewerking delete het concept ondersteunt.
    • Het kenmerk SupportFiltering is niet geldig voor Delete-bewerkingen en moet worden ingesteld op ' false '.

    Notitie

    Deze bewerking is niet geldig voor een URI als shell bewerkingen ook worden ondersteund.

  • Opsommen: opsommings bewerkingen worden ondersteund op de URI.
    • Het kenmerk SupportFragment wordt niet ondersteund voor opsommings bewerkingen en moet worden ingesteld op false.
    • Het kenmerk SupportFiltering is geldig en als de invoeg toepassing filteren ondersteunt, moet dit kenmerk worden ingesteld op ' True '.

    Notitie

    Deze bewerking is niet geldig voor een URI als shell bewerkingen ook worden ondersteund.

  • Get: Get-bewerkingen worden ondersteund op de URI.
    • Het kenmerk SupportFragment wordt gebruikt als de Get-bewerking het concept ondersteunt.
    • Het kenmerk SupportFiltering is niet geldig voor Get-bewerkingen en moet worden ingesteld op false.

    Notitie

    Deze bewerking is niet geldig voor een URI als shell bewerkingen ook worden ondersteund.

  • Invoke: bewerkingen aanroepen worden ondersteund op de URI.
    • Het kenmerk SupportFragment wordt niet ondersteund voor invoke-bewerkingen en moet worden ingesteld op false.
    • Het kenmerk SupportFiltering is ongeldig en moet worden ingesteld op ' false '.

    Notitie

    Deze bewerking is niet geldig voor een URI als shell bewerkingen ook worden ondersteund.

  • Put: put-bewerkingen worden ondersteund op de URI.
    • Het kenmerk SupportFragment wordt gebruikt als de put-bewerking het concept ondersteunt.
    • Het kenmerk SupportFiltering is niet geldig voor put-bewerkingen en moet worden ingesteld op ' false '.

    Notitie

    Deze bewerking is niet geldig voor een URI als shell bewerkingen ook worden ondersteund.

  • Abonneren: Abonneer bewerkingen worden ondersteund op de URI.
    • Het kenmerk SupportFragment wordt niet ondersteund voor Abonneer bewerkingen en moet worden ingesteld op false.
    • Het kenmerk SupportFiltering is niet geldig voor abonnements bewerkingen en moet worden ingesteld op ' false '.

    Notitie

    Deze bewerking is niet geldig voor een URI als shell bewerkingen ook worden ondersteund.

  • Shell: shell-bewerkingen worden ondersteund op de URI.
    • Het kenmerk SupportFragment wordt niet ondersteund voor shell-bewerkingen en moet worden ingesteld op ' false '.
    • Het kenmerk SupportFiltering is niet geldig voor shell-bewerkingen en moet worden ingesteld op ' false '.

    Notitie

    Deze bewerking is niet geldig voor een URI als een andere bewerking ook wordt ondersteund.

    Notitie

    Als een shell-bewerking is geconfigureerd voor een URI, worden de bewerkingen Get, put, Create, Delete, Invoke en Enumeratable intern verwerkt binnen de WS-Management-service (WinRM) voor het beheren van shells. Als gevolg hiervan kan de invoeg toepassing de bewerkingen niet afhandelen.

Ondersteunde cmdlets

CertificateThumbprint<String>

Hiermee geeft u de vinger afdruk van het service certificaat.

Deze waarde vertegenwoordigt de reeks hexadecimale waarden van twee cijfers in het veld vinger afdruk van het certificaat. Hiermee geeft u het digitale open bare-sleutel certificaat (x509) op van een gebruikers account dat is gemachtigd om deze actie uit te voeren. Certificaten worden gebruikt in authenticatie op basis van client certificaten. Ze kunnen alleen worden toegewezen aan lokale gebruikers accounts en ze werken niet met domein accounts. Gebruik de Get-Item Get-ChildItem cmdlets in het Power Shell-station om een certificaat vingerafdruk te verkrijgen Cert: .

Ondersteunde cmdlets

Ingeschakeld<Boolean>

Hiermee geeft u op of de listener is in-of uitgeschakeld. De standaard waarde is True.

Ondersteunde cmdlets

Bestands naam (invoeg toepassing)<String>

Hiermee geeft u de bestands naam van de invoeg toepassing voor bewerkingen. Alle omgevings variabelen die in dit item worden geplaatst, worden uitgevouwen in de context van de gebruiker wanneer een aanvraag wordt ontvangen. Omdat elke gebruiker een andere versie van dezelfde omgevings variabele kan hebben, kan elke gebruiker een andere invoeg toepassing hebben. Deze vermelding mag niet leeg zijn en moet verwijzen naar een geldige invoeg toepassing.

Ondersteunde cmdlets

Hostnaam<String>

Hiermee geeft u de hostnaam op van de computer waarop de WS-Management-service (WinRM) wordt uitgevoerd.

De waarde moet een Fully Qualified Domain Name, een letterlijke IPv4-of een IPv6-teken reeks of een Joker teken zijn.

Ondersteunde cmdlets

Verlener<String>

Hiermee geeft u de naam van de certificerings instantie die het certificaat heeft uitgegeven.

Ondersteunde cmdlets

Invoeg toepassingen voor de invoeg toepassing <> WS-Management zijn systeem eigen Dynamic Link Libraries (dll's)

waarmee u de functionaliteit van WS-Management insluit en uitbreidt. De WSW-API voor het beheer van invoeg toepassingen biedt functionaliteit waarmee een gebruiker plug-ins kan schrijven door bepaalde Api's te implementeren voor ondersteunde bron-Uri's en bewerkingen. Nadat de invoeg toepassingen zijn geconfigureerd voor de WinRM-service (WS-Management) of voor Internet Information Services (IIS), worden de invoeg toepassingen respectievelijk geladen in de WS-Management-host of in de IIS-host. Externe aanvragen worden doorgestuurd naar deze invoer punten om bewerkingen uit te voeren.

Ondersteunde cmdlets

Importeer<Unsigned Short Integer>

Hiermee geeft u de TCP-poort waarvoor deze listener is gemaakt. U kunt een waarde van 1 tot en met 65535 opgeven.

Ondersteunde cmdlets

Resource<String>

Hiermee geeft u een eind punt op dat een afzonderlijk type beheer bewerking of-waarde vertegenwoordigt. Een service stelt een of meer resources beschikbaar en sommige resources kunnen meer dan één exemplaar hebben. Een beheer bron is vergelijkbaar met een WMI-klasse of een database tabel, en een exemplaar is vergelijkbaar met een instantie van de klasse of van een rij in de tabel. De klasse Win32_LogicalDisk vertegenwoordigt bijvoorbeeld een resource. Win32_LogicalDisk="C:\\"is een specifiek exemplaar van de resource.

Een URI (Uniform Resource Identifier) bevat een voor voegsel en een pad naar een resource. Bijvoorbeeld:

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

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

Ondersteunde cmdlets

Resource<String>

Hiermee geeft u de URI (Uniform Resource Identifier) op die een specifiek type resource identificeert, zoals een schijf of een proces, op een computer.

Een URI bestaat uit een voor voegsel en een pad naar een bron. Bijvoorbeeld:

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

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

Ondersteunde cmdlets

SDKVersion<String>

Hiermee geeft u de versie van de SDK voor WS-Management-invoeg toepassingen op. De enige geldige waarde is 1.

Ondersteunde cmdlets

Onderwerp<String>

Hiermee geeft u de entiteit op die wordt geïdentificeerd door het certificaat.

Ondersteunde cmdlets

Portmap<String>

Hiermee geeft u het Trans Port op dat moet worden gebruikt voor het verzenden en ontvangen van aanvragen en antwoorden van het WS-Management-Protocol. De waarde moet HTTP of HTTPS zijn.

Opmerking: de transport waarde is ingesteld bij het maken van een listener.

Ondersteunde cmdlets

URI<String>

Hiermee wordt de URI aangegeven waarvoor toegang is toegestaan op basis van de waarde van de SDDL-para meter.

Ondersteunde cmdlets

URLPrefix<String>

Een URL-voor voegsel voor het accepteren van HTTP-of HTTPS-aanvragen. Dit is een teken reeks met alleen de tekens [a-z] , [A-Z] ,, [9-0] onderstrepen ( _ ) en back slash ( / ). De teken reeks mag niet beginnen met of eindigen op een back slash ( / ). Als de computer naam bijvoorbeeld ' SampleComputer ' is, geeft de WS-Management-client http://SampleMachine/URLPrefix in het doel adres op.

Ondersteunde cmdlets

Value<String>

Hiermee geeft u de waarde van een initialisatie parameter op, een waarde die specifiek is voor een invoeg toepassing die wordt gebruikt om configuratie opties op te geven.

Ondersteunde cmdlets

XMLRenderingType<String>

Hiermee geeft u de indeling op waarin XML wordt door gegeven aan invoeg toepassingen via het WSMAN_DATA -object. De volgende waarden zijn geldig:

  • Tekst: inkomende XML-gegevens bevinden zich in een WSMAN_DATA_TYPE_TEXT structuur, die de XML vertegenwoordigt als een PCWSTR -geheugen buffer.
  • XMLReader: inkomende XML-gegevens bevinden zich in een WSMAN_DATA_TYPE_WS_XML_READER -structuur, die de XML vertegenwoordigt als een XmlReader -object, dat is gedefinieerd in het header-bestand ' webservices. h '.

Ondersteunde cmdlets

De pijp lijn gebruiken

Provider-cmdlets accepteren de invoer van de pijp lijn. U kunt de pijp lijn gebruiken om de taak te vereenvoudigen door provider gegevens van de ene cmdlet naar een andere provider-cmdlet te verzenden. Zie de cmdlet-verwijzingen die in dit artikel worden vermeld voor meer informatie over het gebruik van de pijp lijn met provider-cmdlets.

Ondersteuning vragen

Vanaf Windows Power Shell 3,0 kunt u aangepaste Help-onderwerpen voor provider-cmdlets krijgen waarin wordt uitgelegd hoe deze cmdlets zich gedragen in een bestandssysteem station.

Als u de Help-onderwerpen wilt ophalen die zijn aangepast voor het bestandssysteem station, voert u de opdracht Get-Help uit in een bestandssysteem station of gebruikt -Path u de para meter Get-Help om een bestandssysteem station op te geven.

Get-Help Get-ChildItem

Get-Help Get-ChildItem -Path wsman:

Zie ook

about_Providers