Delen via

about_WSMan_Provider

  • Artikel

Providernaam

WSMan

Stations

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 configuratiegegevens van WS-Management 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 echter niet gebruiken in PowerShell 2.0 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: 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 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 waarmee het WS-Management-protocol wordt geïmplementeerd voor het verzenden en ontvangen van berichten.

  • 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 WMI-provider (Windows Management Instrumentation). Deze drie invoegtoepassingen bieden ondersteuning voor 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.

DirectoryHië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. Als u echter toegang wilt krijgen tot de configuratie-instellingen van een externe computer, moet u een verbinding maken met de externe computer met behulp van Verbinding maken-WSMan. Zodra een verbinding met een externe computer is gemaakt, 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 locatie van het systeemarchief. 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 weergeven: Station

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

Get-ChildItem -path WSMan:\Localhost

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

Met deze opdracht wordt de Get-Childitem cmdlet gebruikt om de WS-Management-archieven 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 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 het WSMAN-station:

Een nieuwe listener maken

Met de New-Item cmdlet worden items binnen een providerstation gemaakt. 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. 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 beveiligingsvermelding voor een resource maken

Met deze opdracht maakt u een beveiligingsvermelding in de beveiligingsmap van Resource_5967683 (een specifieke resource). Bij 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. Het nieuwe ClientCertificate wordt weergegeven onder de map ClientCertificate als 'ClientCertificate_1234567890'. Alle parameters zijn verplicht. De uitgever moet een vingerafdruk van het certificaat van de uitgever 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 initialisatieparameterparameternaam 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 parameters zijn cmdlet-parameters die worden toegevoegd door een PowerShell-provider en zijn alleen beschikbaar wanneer de cmdlet wordt gebruikt in het station met provider.

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 (*) verbindt u de opdracht alle IP-adressen op alle netwerkadapters.)
  • De letterlijke tekenreeks 'IP:' gevolgd door een geldig IP-adres in IPv4-notatie met stippeltekens 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 deze 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 enumerate-bewerkingen en moet worden ingesteld op False.
    • Het kenmerk SupportFiltering is geldig en als de invoegtoepassing filtering 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 Onwaar.

    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 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: Abonneerbewerkingen worden 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 abonneerbewerkingen 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, worden intern 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.

Deze waarde vertegenwoordigt de tekenreeks van hexadecimale waarden in het veld Vingerafdruk van het certificaat. Hiermee geeft u het certificaat voor 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 operations-invoegtoepassing. 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 mag 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

<> WS-Management-invoegtoepassingen voor invoegtoepassingen zijn systeemeigen dynamic link libraries (DLL's)

die de functionaliteit van WS-Management kan uitbreiden en uitbreiden. De WSW-Management-invoegtoepassings-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 WS-Management-service (WinRM) 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-ondertekend kort geheel getal>

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

Ondersteunde cmdlets

Resourcetekenreeks <>

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 klasse Win32_LogicalDisk 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. Voorbeeld:

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

Resourcetekenreeks <>

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. Voorbeeld:

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

Transporttekenreeks <>

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 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 http://SampleMachine/URLPrefix de WS-Management-client op 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.

Hulp krijgen

Vanaf Windows PowerShell 3.0 kunt u aangepaste Help-onderwerpen krijgen voor provider-cmdlets die uitleggen hoe deze cmdlets zich gedragen in 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