about_WSMan_Provider

  • Artikel

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 die wordt uitgevoerd in Windows.

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

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

Vanaf Windows PowerShell 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 Invoegtoepassing van het WSMan: 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 WSMan: station gebruiken om de waarden van de nieuwe eigenschappen te wijzigen. U kunt het WSMan: station in PowerShell 2.0 echter niet gebruiken om eigenschappen te wijzigen die worden 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: Drive

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

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

    Notitie

    Serviceconfiguratie wordt soms serverconfiguratie genoemd.

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

  • Listener: U kunt een listener maken en configureren. Een listener is een beheerservice waarmee het WS-Management protocol wordt geïmplementeerd om berichten te verzenden en te ontvangen.

  • Invoegtoepassing: Invoegtoepassingen worden geladen en gebruikt door de WS-Management-service om verschillende functies te bieden. PowerShell biedt standaard drie invoegtoepassingen:

    • De Event Forwarding-invoegtoepassing.
    • De invoegtoepassing Microsoft.PowerShell.
    • De invoegtoepassing Windows Management Instrumentation (WMI) Provider. Deze drie invoegtoepassingen ondersteunen het doorsturen van gebeurtenissen, configuratie en WMI-toegang.

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

Adreslijsthiërarchie van de WSMan-provider

De adreslijsthië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 adreslijsthië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 Connect-WSMan. Zodra er verbinding is gemaakt met een externe computer, wordt de naam van de externe computer weergegeven 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 bestandssysteemstation, typt u de naam van het station. Typ bijvoorbeeld.

Set-Location C:

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

Set-Location -Path  WSMan:\SERVER01

Notitie

Bij de bovenstaande opdracht wordt ervan uitgegaan dat er al een verbinding met het externe systeem bestaat.

De inhoud van de WSMan: Drive weergeven

Met deze opdracht wordt de Get-Childitem cmdlet gebruikt om de WS-Management winkels weer te geven in de localhost store-locatie.

Get-ChildItem -path WSMan:\Localhost

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

Met deze opdracht wordt de Get-Childitem cmdlet gebruikt om de WS-Management winkels weer te geven op de externe computer 'SERVER01'-archieflocatie.

Get-ChildItem -path WSMan:\SERVER01

Notitie

Bij de bovenstaande opdracht wordt ervan uitgegaan dat er al een verbinding met het externe systeem bestaat.

De waarde van items instellen in de WSMAN: station

U kunt de Set-Item cmdlet gebruiken om configuratie-instellingen in het WSMAN station te wijzigen. In het volgende voorbeeld wordt de waarde TrustedHosts ingesteld om alle hosts te accepteren met het achtervoegsel '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"

De Set-Item cmdlet ondersteunt een extra parameter -Concatenate die een waarde toevoegt in plaats van deze te wijzigen. In het volgende voorbeeld wordt een nieuwe waarde *.domain2.com toegevoegd aan de oude waarde die is opgeslagen in TrustedHost:

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

Items maken in de WSMAN: station

Een nieuwe listener maken

De New-Item cmdlet maakt items in 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 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 invoegtoepassing maken

Met deze opdracht maakt (registreert) u een invoegtoepassing 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 resourcevermelding maken

Met deze opdracht maakt u een resourcevermelding in de map Resources van een TestPlugin. Met 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 beveiligingsvermelding voor een resource maken

Met deze opdracht maakt u een beveiligingsvermelding in de beveiligingsmap van Resource_5967683 (een specifieke resource). Met deze opdracht wordt ervan uitgegaan dat de resourcevermelding 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 ClientCertificate-vermelding die kan worden gebruikt door de WS-Management-client. De nieuwe ClientCertificate wordt weergegeven onder de map ClientCertificate als 'ClientCertificate_1234567890'. Alle parameters zijn verplicht. De uitgever moet de vingerafdruk van het certificaat van de verlener 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 initialisatieparameterparameter met de naam testparametername in de map InitializationParameters. Met 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 parameters zijn cmdlet-parameters die worden toegevoegd door een PowerShell-provider en zijn alleen beschikbaar wanneer de cmdlet wordt gebruikt in het station met providerfunctie.

Adresreeks <>

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

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

Notitie

De adreswaarde wordt ingesteld bij het maken van een listener.

Ondersteunde cmdlets

Opsomming van mogelijkheden <>

Wanneer u met invoegtoepassingen werkt, geeft deze parameter een bewerking op die wordt ondersteund op deze URI (Uniform Resource Identifier). U moet één vermelding maken voor elk type bewerking dat door de URI wordt ondersteund. U kunt eventuele geldige kenmerken voor een bepaalde bewerking opgeven als de bewerking dit ondersteunt.

Deze kenmerken omvatten SupportsFiltering en SupportsFragment.

  • Maken: Bewerkingen maken worden ondersteund op de URI.
    • Het kenmerk SupportFragment wordt gebruikt als de bewerking Maken het concept ondersteunt.
    • Het kenmerk SupportFiltering is NIET geldig voor bewerkingen maken en moet worden ingesteld op Onwaar.

    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 verwijderbewerking het concept ondersteunt.
    • Het kenmerk SupportFiltering is NIET geldig voor verwijderingsbewerkingen en moet worden ingesteld op Onwaar.

    Notitie

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

  • Opsomming: Opsommingsbewerkingen worden ondersteund op de URI.
    • Het kenmerk SupportFragment wordt NIET ondersteund voor opsommingsbewerkingen en moet worden ingesteld op False.
    • Het kenmerk SupportFiltering is geldig en als de invoegtoepassing ondersteuning biedt voor filteren, 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 Onwaar.

    Notitie

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

  • Aanroepen: aanroepen 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 Onwaar.

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

    Notitie

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

  • Abonneren: Abonneren wordt ondersteund op de URI.
    • Het kenmerk SupportFragment wordt niet ondersteund voor abonneerbewerkingen en moet worden ingesteld op False.
    • Het kenmerk SupportFiltering is niet geldig voor de bewerkingen Abonneren en moet worden ingesteld op Onwaar.

    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 Onwaar.
    • Het kenmerk SupportFiltering is niet geldig voor Shell-bewerkingen en moet worden ingesteld op Onwaar.

    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, Get, Put, Create, Delete, Invoke en Enumerate-bewerkingen intern worden verwerkt binnen de winRM-service (WS-Management) om shells te beheren. Als gevolg hiervan kan de invoegtoepassing de bewerkingen niet verwerken.

Ondersteunde cmdlets

CertificateThumbprint-tekenreeks <>

Hiermee geeft u de vingerafdruk van het servicecertificaat op.

Deze waarde vertegenwoordigt de tekenreeks van hexadecimale waarden in het veld Vingerafdruk van het certificaat. Hiermee geeft u het certificaat van de digitale openbare sleutel (X509) van een gebruikersaccount op dat is gemachtigd om deze actie uit te voeren. Certificaten worden gebruikt in verificatie op basis van clientcertificaten. Ze kunnen alleen worden toegewezen aan lokale gebruikersaccounts en ze werken niet met domeinaccounts. Als u een vingerafdruk van een certificaat wilt ophalen, gebruikt u de Get-Item of Get-ChildItem cmdlets in het PowerShell-station Cert: .

Ondersteunde cmdlets

Booleaanse waarde ingeschakeld <>

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

Ondersteunde cmdlets

FileName -tekenreeks (invoegtoepassing) <>

Hiermee geeft u de bestandsnaam van de invoegtoepassing bewerkingen. Omgevingsvariabelen die in deze vermelding worden geplaatst, worden uitgebreid in de context van de gebruikers wanneer een aanvraag wordt ontvangen. Omdat elke gebruiker een andere versie van dezelfde omgevingsvariabele kan hebben, kan elke gebruiker een andere invoegtoepassing hebben. Deze vermelding kan niet leeg zijn en moet verwijzen naar een geldige invoegtoepassing.

Ondersteunde cmdlets

HostName-tekenreeks <>

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

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

Ondersteunde cmdlets

Tekenreeks voor verlener <>

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

Ondersteunde cmdlets

Invoegtoepassingen <> WS-Management invoegtoepassingen zijn systeemeigen DLL's (Dynamic Link Libraries)

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

Ondersteunde cmdlets

<Niet-ondertekende korte integer van poort>

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

Ondersteunde cmdlets

Resourcereeks <>

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 meerdere exemplaren 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 Win32_LogicalDisk klasse vertegenwoordigt bijvoorbeeld een resource. Win32_LogicalDisk="C:\\" is een specifiek exemplaar van de resource.

Een URI (Uniform Resource Identifier) 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

Resourcereeks <>

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

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

Ondersteunde cmdlets

Onderwerptekenreeks <>

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

Ondersteunde cmdlets

Transportreeks <>

Hiermee geeft u het transport dat moet worden gebruikt voor het verzenden en ontvangen van WS-Management protocolaanvragen en -antwoorden. De waarde moet HTTP of HTTPS zijn.

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

Ondersteunde cmdlets

URI-tekenreeks <>

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

Ondersteunde cmdlets

URLPrefix-tekenreeks <>

Een URL-voorvoegsel voor het accepteren van HTTP- of HTTPS-aanvragen. Dit is een tekenreeks die alleen de tekens[a-z], [9-0][A-Z]onderstrepingstekens (_) en backslash (/) bevat. De tekenreeks mag niet beginnen met of eindigen met een backslash (/). Als de computernaam bijvoorbeeld SampleComputer is, zou de WS-Management-client opgeven http://SampleMachine/URLPrefix in het doeladres.

Ondersteunde cmdlets

Waardetekenreeks <>

Hiermee geeft u de waarde van een initialisatieparameter op. Dit is een invoegtoepassingsspecifieke waarde die wordt gebruikt om configuratieopties op te geven.

Ondersteunde cmdlets

XMLRenderingType-tekenreeks <>

Hiermee geeft u de indeling op waarin XML wordt doorgegeven aan invoegtoepassingen 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 bevinden zich 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 een 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 die uitleggen hoe deze cmdlets zich gedragen op een bestandssysteemstation.

Als u de Help-onderwerpen wilt ophalen die zijn aangepast voor het bestandssysteemstation, voert u een Get-Help-opdracht uit op een bestandssysteemstation of gebruikt u de -Path parameter Get-Help om een bestandssysteemstation op te geven.

Get-Help Get-ChildItem

Get-Help Get-ChildItem -Path wsman:

Zie ook