about_WSMan_Provider

Providernaam

WSMan

Aandrijfeenheden

WSMan:

Korte beschrijving

Biedt toegang tot configuratiegegevens van Web Services for Management (WS-Management).

Gedetailleerde beschrijving

Deze informatie is alleen van toepassing op PowerShell dat wordt uitgevoerd op Windows.

Met de WSMan-provider voor PowerShell kunt u configuratiegegevens toevoegen, wijzigen, wissen en verwijderen WS-Management lokale of externe computers.

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

Vanaf Windows PowerShell versie 3.0 is de WSMan-provider bijgewerkt ter ondersteuning van nieuwe eigenschappen voor sessieconfiguraties, zoals OutputBufferingMode. De sessieconfiguraties worden weergegeven als items in de map Plugin WSMan: van het station en de eigenschappen worden weergegeven als items in elke sessieconfiguratie.

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

Notitie

U kunt opdrachten in het station WSMan: gebruiken om de waarden van de nieuwe eigenschappen te wijzigen. U kunt het station WSMan: in PowerShell 2.0 echter niet gebruiken om eigenschappen te wijzigen die zijn geïntroduceerd in Windows PowerShell 3.0. Hoewel er geen fout wordt gegenereerd, zijn de opdrachten niet effectief om deze instellingen te wijzigen, gebruikt u het WSMan-station in Windows PowerShell 3.0.

Organisatie van de WSMan: Station

  • Client: U kunt verschillende aspecten van de client WS-Management configureren. De configuratiegegevens worden opgeslagen in het register.

  • Service: U kunt verschillende aspecten van de WS-Management configureren. De configuratiegegevens worden opgeslagen in het register.

    Notitie

    Serviceconfiguratie wordt soms aangeduid als Serverconfiguratie.

  • 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 dat is toegestaan (MaxConcurrentUsers).

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

  • Invoegfunctie: invoegfuncties worden geladen en gebruikt door de WS-Management-service om verschillende functies te bieden. PowerShell biedt standaard drie in plug-ins:

    • De Event Forwarding-in plug-in.
    • De Microsoft.PowerShell-in plug-in.
    • De Windows WMI-provider(Management Instrumentation). Deze drie in plug-ins ondersteunen doorsturen van gebeurtenissen, configuratie en WMI-toegang.
  • ClientCertificate: u kunt een clientcertificaat maken en configureren. Een clientcertificaat wordt gebruikt wanneer de WS-Management client is geconfigureerd voor het gebruik van certificaatverificatie.

Maphiërarchie van de WSMan-provider

De maphië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 maphiërarchie van de WSMan-provider voor een externe computer is hetzelfde als een lokale computer. Voor toegang tot de configuratie-instellingen van een externe computer moet u echter verbinding maken met de externe computer met behulp van Verbinding maken-WSMan. Zodra er verbinding is gemaakt met een externe computer, wordt de naam van de externe computer in de provider weer gegeven.

WSMan:\<Remote_Computer_Name>

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

Set-Location WSMan:

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

Set-Location C:

Met deze opdracht gebruikt u de Set-Location opdracht om de huidige locatie te wijzigen in de hoofdlocatie in de externe systeemopslaglocatie. Gebruik een backslash \ of slash om / een niveau van het station aan te WSMan: geven.

Set-Location -Path  WSMan:\SERVER01

Notitie

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

De inhoud van de WSMan: Station weergeven

Met deze opdracht gebruikt u de Get-Childitem cmdlet om de WS-Management op de locatie van de Localhost Store weer te geven.

Get-ChildItem -path WSMan:\Localhost

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

Deze opdracht gebruikt de Get-Childitem cmdlet om weer te geven WS-Management winkels op de externe computer "SERVER01" opslaglocatie.

Get-ChildItem -path WSMan:\SERVER01

Notitie

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

De waarde van items in het station WSMAN: instellen

U kunt de Set-Item cmdlet gebruiken om de configuratie-instellingen in het station te WSMAN wijzigen. In het volgende voorbeeld wordt de waarde TrustedHosts zo dat alle hosts met het achtervoegsel 'contoso.com' worden geaccepteerd.

# 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 ondersteunt een extra parameter -Concatenate waarmee een waarde wordt toevoegen in plaats van deze te wijzigen. In het volgende voorbeeld wordt een nieuwe waarde '*.domain2.com' aan de oude waarde die is opgeslagen in TrustedHost:

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

Items maken in het station WSMAN:

Een nieuwe listener maken

De New-Item cmdlet maakt items binnen een providerstation. Elke provider heeft verschillende itemtypen die u kunt maken. In het WSMAN: station kunt u listeners maken die u configureert om externe aanvragen te ontvangen en hierop 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 in plug-in maken

Met deze opdracht maakt (registreert) u een in plug-in voor de WS-Management service.

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

Een nieuwe resource-vermelding maken

Met deze opdracht maakt u een resource-vermelding in de map Resources van een TestPlugin. Met deze opdracht wordt ervan uitgenomen dat 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 beveiligingsinvoer voor een resource maken

Met deze opdracht maakt u een beveiligingsinvoer in de map Beveiliging van Resource_5967683 (een specifieke resource). Met deze opdracht wordt ervan uitgenomen dat de resource-vermelding is gemaakt met behulp van 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 clientcertificaat maken

Met deze opdracht maakt u de vermelding ClientCertificate die kan worden gebruikt door WS-Management client. Het nieuwe ClientCertificate wordt in de map ClientCertificate als 'ClientCertificate_1234567890' (ClientCertificate) weer te geven. Alle parameters zijn verplicht. De vergever moet de vingerafdruk van het certificaat van de vergever zijn.

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

Een nieuwe initialisatieparameter maken

Met deze opdracht maakt u een initialisatieparameter met de naam 'testparametername' in de map InitializationParameters. Met deze opdracht wordt ervan uitgenomen 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 parameters zijn cmdlet-parameters die worden toegevoegd door een PowerShell-provider en die alleen beschikbaar zijn wanneer de cmdlet wordt gebruikt in het station met provider ingeschakeld.

Adres <String>

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

  • De letterlijke tekenreeks "*". (Het jokerteken (*) zorgt ervoor dat de opdracht alle IP-adressen op alle netwerkadapters verbindt.)
  • De letterlijke tekenreeks 'IP:', gevolgd door een geldig IP-adres in IPv4-decimale notatie of in IPv6 gekloonde-hexadecimale indeling.
  • De letterlijke tekenreeks 'MAC:' gevolgd door het MAC-adres van een adapter. Bijvoorbeeld: MAC:32-a3-58-90-be-cc.

Notitie

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

Ondersteunde cmdlets

Vermogen <Enumeration>

Wanneer u met in plug-ins werkt, geeft deze parameter een bewerking op die wordt ondersteund op deze Uniform Resource Identifier (URI). 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 dit ondersteunt.

Deze kenmerken omvatten SupportsFiltering en SupportsFragment.

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

    Notitie

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

  • Verwijderen: verwijderbewerkingen worden ondersteund op de URI.
    • Het kenmerk SupportFragment wordt gebruikt als de bewerking Delete het concept ondersteunt.
    • Het kenmerk SupportFiltering is NIET geldig voor verwijderbewerkingen en moet worden ingesteld op 'False'.

    Notitie

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

  • Opsnoemen: opseerbewerkingen worden ondersteund op de URI.
    • Het kenmerk SupportFragment wordt NIET ondersteund voor het opsnoemen van bewerkingen en moet worden ingesteld op False.
    • Het kenmerk SupportFiltering is geldig. Als de in plug-in filteren ondersteunt, moet dit kenmerk worden ingesteld op Waar.

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

  • Aanroepen: Aanroepbewerkingen worden ondersteund op de URI.
    • Het kenmerk SupportFragment wordt niet ondersteund voor Aanroepbewerkingen 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 putbewerking 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: Bewerkingen voor abonneren worden ondersteund op de URI.
    • Het kenmerk SupportFragment wordt niet ondersteund voor Subscribe-bewerkingen en moet worden ingesteld op False.
    • Het kenmerk SupportFiltering is niet geldig voor Subscribe-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 Enumerate intern verwerkt in de WS-Management-service (WinRM) om shells te beheren. Als gevolg hiervan kan de in plug-in de bewerkingen niet verwerken.

Ondersteunde cmdlets

CertificateThumbprint <String>

Hiermee geeft u de vingerafdruk van het servicecertificaat op.

Deze waarde vertegenwoordigt de tekenreeks van hexadecimale waarden van twee cijfers in het veld Vingerafdruk van het certificaat. Hiermee geeft u het digitale openbare-sleutelcertificaat (X509) op van een gebruikersaccount dat is machtigingen heeft om deze actie uit te voeren. Certificaten worden gebruikt in verificatie op basis van clientcertificaten. Ze kunnen alleen worden toe te staan aan lokale gebruikersaccounts en ze werken niet met domeinaccounts. Gebruik de cmdlets of in het PowerShell-station Get-Item Get-ChildItem om een vingerafdruk van het certificaat op te Cert: halen.

Ondersteunde cmdlets

Ingeschakeld <Boolean>

Hiermee geeft u op of de listener is ingeschakeld of uitgeschakeld. De standaardwaarde is Waar.

Ondersteunde cmdlets

FileName (invoeg-app) <String>

Hiermee geeft u de bestandsnaam van de operations-in plug-in op. Alle omgevingsvariabelen die in deze vermelding worden geplaatst, worden in de context van de gebruiker uitgebreid wanneer een aanvraag wordt ontvangen. Omdat elke gebruiker een andere versie van dezelfde omgevingsvariabele kan hebben, kan elke gebruiker een andere in plug-in hebben. Deze vermelding mag niet leeg zijn en moet naar een geldige in plug-in wijzen.

Ondersteunde cmdlets

Hostname <String>

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

De waarde moet een volledig gekwalificeerde domeinnaam, een IPv4- of IPv6-letterlijke tekenreeks of een jokerteken zijn.

Ondersteunde cmdlets

Uitgevende instelling <String>

Hiermee geeft u de naam op van de certificeringsinstantie die het certificaat heeft uitgegeven.

Ondersteunde cmdlets

die worden toegevoegd aan en de functionaliteit van WS-Management. De WSW-Management Plug-in-API biedt functionaliteit waarmee een gebruiker in plug-ins kan schrijven door bepaalde API's te implementeren voor ondersteunde resource-URI's en bewerkingen. Nadat de in plug-ins zijn geconfigureerd voor de WS-Management-service (WinRM) of voor Internet Information Services (IIS), worden de in plug-ins respectievelijk geladen in de WS-Management-host of in de IIS-host. Externe aanvragen worden doorgeleid naar deze in plug-in-toegangspunten om bewerkingen uit te voeren.

Ondersteunde cmdlets

Poort <Unsigned Short Integer>

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

Ondersteunde cmdlets

Resource <String>

Hiermee geeft u een eindpunt op dat een uniek type beheerbewerking of -waarde vertegenwoordigt. Een service maakt een of meer resources beschikbaar en sommige resources kunnen meer dan één exemplaar hebben. Een beheerresource is vergelijkbaar met een WMI-klasse of een databasetabel en een exemplaar is vergelijkbaar met een exemplaar van de klasse of een rij in de tabel. De klasse Win32_LogicalDisk vertegenwoordigt bijvoorbeeld een resource. Win32_LogicalDisk="C:\\" is een specifiek exemplaar van de resource.

Een Uniform Resource Identifier (URI) bevat een voorvoegsel 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 Uniform Resource Identifier (URI) op die een specifiek type resource, zoals een schijf of een proces, op een computer identificeert.

Een URI bestaat uit een voorvoegsel 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

SDKVersion <String>

Hiermee geeft u de versie van de WS-Management plug-in SDK op. De enige geldige waarde is 1.

Ondersteunde cmdlets

Onderwerp <String>

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

Ondersteunde cmdlets

Vervoer <String>

Hiermee geeft u het transport te gebruiken voor het verzenden en ontvangen WS-Management protocolaanvragen en antwoorden. De waarde moet HTTP of HTTPS zijn.

Opmerking: de waarde Transport wordt ingesteld bij het maken van een listener.

Ondersteunde cmdlets

URI <String>

Identificeert de URI waarvoor toegang is geautoriseerd op basis van de waarde van de Sddl-parameter.

Ondersteunde cmdlets

URLPrefix <String>

Een URL-voorvoegsel waarop HTTP- of HTTPS-aanvragen moeten worden geaccepteerd. Dit is een tekenreeks die alleen de tekens [a-z], [A-Z], , [9-0]onderstrepingsteken (_) en backslash () bevat/. De tekenreeks mag niet beginnen met of eindigen met een backslash (/). Als de computernaam bijvoorbeeld 'SampleComputer' is, geeft WS-Management client op http://SampleMachine/URLPrefix in het doeladres.

Ondersteunde cmdlets

Waarde <String>

Hiermee geeft u de waarde van een initialisatieparameter op. Dit is een in plug-in-specifieke waarde die wordt gebruikt om configuratieopties op te geven.

Ondersteunde cmdlets

XMLRenderingType <String>

Hiermee geeft u de indeling op waarin XML wordt doorgegeven aan in plug-ins via het WSMAN_DATA object. Hier volgen geldige waarden:

  • Tekst: Binnenkomende XML-gegevens bevinden zich in een WSMAN_DATA_TYPE_TEXT structuur, die de XML vertegenwoordigt als een PCWSTR-geheugenbuffer .
  • XMLReader: Binnenkomende XML-gegevens zijn opgenomen in een WSMAN_DATA_TYPE_WS_XML_READER-structuur , die de XML vertegenwoordigt als een XmlReader-object , dat is gedefinieerd in het headerbestand WebServices.h.

Ondersteunde cmdlets

De pijplijn gebruiken

Provider-cmdlets accepteren pijplijninvoer. U kunt de pijplijn gebruiken om de taak te vereenvoudigen door providergegevens van de ene cmdlet naar de andere provider-cmdlet te verzenden. Zie de cmdlet-verwijzingen in dit artikel voor meer informatie over het gebruik van de pijplijn met provider-cmdlets.

Ondersteuning vragen

Vanaf Windows PowerShell 3.0 kunt u aangepaste Help-onderwerpen krijgen voor provider-cmdlets waarin wordt uitgelegd hoe deze cmdlets zich gedragen in een bestandssysteemstation.

Als u de Help-onderwerpen wilt krijgen die zijn aangepast voor het bestandssysteemstation, moet u een Get-Help-opdracht uitvoeren in -Path een bestandssysteemstation of de parameter Get-Help gebruiken om een bestandssysteemstation op te geven.

Get-Help Get-ChildItem
Get-Help Get-ChildItem -Path wsman:

Zie ook