about_WSMan_Provider

  • Artikel

Providernamn

WSMan

Drivrutiner

WSMan:

Kort beskrivning

Ger åtkomst till konfigurationsinformation för Web Services for Management (WS-Management).

Detaljerad beskrivning

Den här informationen gäller endast för PowerShell som körs i Windows.

Med WSMan-providern för PowerShell kan du lägga till, ändra, rensa och ta bort WS-Management-konfigurationsdata på lokala eller fjärranslutna datorer.

WSMan-providern exponerar en PowerShell-enhet med en katalogstruktur som motsvarar en logisk gruppering av konfigurationsinställningar för WS-Management. Dessa grupper kallas containrar.

Från och med Windows PowerShell 3.0 har WSMan-providern uppdaterats för att stödja nya egenskaper för sessionskonfigurationer, till exempel OutputBufferingMode. Sessionskonfigurationerna visas som objekt i plugin-katalogen på WSMan: enheten och egenskaperna visas som objekt i varje sessionskonfiguration.

WSMan-providern stöder följande cmdletar som beskrivs i den här artikeln.

Kommentar

Du kan använda kommandon på WSMan: enheten för att ändra värdena för de nya egenskaperna. Du kan dock inte använda WSMan: enheten i PowerShell 2.0 för att ändra egenskaper som introduceras i Windows PowerShell 3.0. Även om inget fel genereras är kommandona inte effektiva Om du vill ändra de här inställningarna använder du WSMan-enheten i Windows PowerShell 3.0.

Organisation av WSMan: Drive

  • Klient: Du kan konfigurera olika aspekter av WS-Management-klienten. Konfigurationsinformationen lagras i registret.

  • Tjänst: Du kan konfigurera olika aspekter av WS-Management-tjänsten. Konfigurationsinformationen lagras i registret.

    Kommentar

    Tjänstkonfiguration kallas ibland serverkonfiguration.

  • Gränssnitt: Du kan konfigurera olika aspekter av WS-Management-gränssnittet, till exempel inställningen för att tillåta fjärrgränssnittsåtkomst (AllowRemoteShellAccess) och det maximala antalet samtidiga användare som tillåts (MaxConcurrentUsers).

  • Lyssnare: Du kan skapa och konfigurera en lyssnare. En lyssnare är en hanteringstjänst som implementerar WS-Management-protokollet för att skicka och ta emot meddelanden.

  • Plugin-program: Plugin-program läses in och används av WS-Management-tjänsten för att tillhandahålla olika funktioner. Som standard tillhandahåller PowerShell tre plugin-program:

    • Plugin-programmet Vidarebefordra händelse.
    • Plugin-programmet Microsoft.PowerShell.
    • Plugin-programmet för Windows Management Instrumentation (WMI) Provider. Dessa tre plugin-program stöder vidarebefordran av händelser, konfiguration och WMI-åtkomst.

  • ClientCertificate: Du kan skapa och konfigurera ett klientcertifikat. Ett klientcertifikat används när WS-Management-klienten har konfigurerats för att använda certifikatautentisering.

Kataloghierarki för WSMan-providern

Kataloghierarkin för WSMan-providern för den lokala datorn är följande.

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

Kataloghierarkin för WSMan-providern för en fjärrdator är samma som en lokal dator. För att få åtkomst till konfigurationsinställningarna för en fjärrdator måste du dock upprätta en anslutning till fjärrdatorn med hjälp av Anslut-WSMan. När en anslutning har upprättats till en fjärrdator visas namnet på fjärrdatorn i providern.

WSMan:\<Remote_Computer_Name>

Det här kommandot använder cmdleten Set-Location för att ändra den aktuella platsen till WSMan: enheten.

Set-Location WSMan:

Om du vill återgå till en filsystemenhet skriver du enhetsnamnet. Skriv till exempel.

Set-Location C:

Det här kommandot använder Set-Location kommandot för att ändra den aktuella platsen till rotplatsen på platsen för fjärrsystemarkivet. Använd ett snedstreck \ eller snedstreck / för att ange enhetens WSMan: nivå.

Set-Location -Path  WSMan:\SERVER01

Kommentar

Kommandot ovan förutsätter att det redan finns en anslutning till fjärrsystemet.

Visa innehållet i WSMan: Drive

Det här kommandot använder cmdleten Get-Childitem för att visa WS-Management-butikerna på platsen Localhost Store.

Get-ChildItem -path WSMan:\Localhost

Om du är i WSMan: enheten kan du utelämna enhetsnamnet.

Det här kommandot använder cmdleten Get-Childitem för att visa WS-Management-butikerna på fjärrdatorns lagringsplats "SERVER01".

Get-ChildItem -path WSMan:\SERVER01

Kommentar

Kommandot ovan förutsätter att det redan finns en anslutning till fjärrsystemet.

Ange värdet för objekt i WSMAN:-enheten

Du kan använda cmdleten Set-Item för att ändra konfigurationsinställningarna på WSMAN enheten. I följande exempel anges värdet TrustedHosts för att acceptera alla värdar med suffixet "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"

Cmdleten Set-Item stöder ytterligare en parameter -Concatenate som lägger till ett värde i stället för att ändra det. I följande exempel läggs ett nytt värde "*.domain2.com" till det gamla värdet som lagras i TrustedHost:

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

Skapa objekt i WSMAN:-enheten

Skapa en ny lyssnare

Cmdleten New-Item skapar objekt inom en providerenhet. Varje leverantör har olika objekttyper som du kan skapa. WSMAN: På enheten kan du skapa lyssnare som du konfigurerar för att ta emot och svara på fjärrbegäranden. Följande kommando skapar en ny HTTP-lyssnare med hjälp av cmdleten New-Item .

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

Skapa ett nytt plugin-program

Det här kommandot skapar (registrerar) ett plugin-program för WS-Management-tjänsten.

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

Skapa en ny resurspost

Det här kommandot skapar en resurspost i resurskatalogen för en TestPlugin. Det här kommandot förutsätter att en TestPlugin har skapats med ett separat kommando.

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

Skapa en ny säkerhetspost för en resurs

Det här kommandot skapar en säkerhetspost i säkerhetskatalogen för Resource_5967683 (en specifik resurs). Det här kommandot förutsätter att resursposten har skapats med ett separat kommando.

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

Skapa ett nytt klientcertifikat

Det här kommandot skapar ClientCertificate-post som kan användas av WS-Management-klienten. Den nya ClientCertificate visas under katalogen ClientCertificate som "ClientCertificate_1234567890". Alla parametrar är obligatoriska. Utfärdaren måste vara tumavtryck för utfärdarcertifikatet.

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

Skapa en ny initieringsparameter

Det här kommandot skapar en initieringsparameter med namnet "testparametername" i katalogen "InitializationParameters". Det här kommandot förutsätter att "TestPlugin" har skapats med ett separat kommando.

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

Dynamiska parametrar

Dynamiska parametrar är cmdlet-parametrar som läggs till av en PowerShell-provider och är endast tillgängliga när cmdleten används på den provideraktiverade enheten.

Adresssträng <>

Anger adressen som lyssnaren skapades för. Värdet kan vara något av följande:

  • Den literala strängen "*". (Jokertecknet (*) gör att kommandot binder alla IP-adresser på alla nätverkskort.)
  • Den bokstavliga strängen "IP:" följt av en giltig IP-adress i antingen IPv4-streckat decimalformat eller i IPv6 cloned-hexadecimalt format.
  • Literalsträngen "MAC:" följt av MAC-adressen för ett kort. Exempel: MAC:32-a3-58-90-be-cc.

Kommentar

Värdet Adress anges när du skapar en lyssnare.

Cmdletar stöds

Kapacitetsuppräkning <>

När du arbetar med plugin-program anger den här parametern en åtgärd som stöds på den här URI:n (Uniform Resource Identifier). Du måste skapa en post för varje typ av åtgärd som URI:n stöder. Du kan ange giltiga attribut för en viss åtgärd, om åtgärden stöder den.

Dessa attribut är SupportsFiltering och SupportsFragment.

  • Skapa: Skapa åtgärder stöds på URI:n.
    • Attributet SupportFragment används om åtgärden Skapa stöder konceptet.
    • Attributet SupportFiltering är INTE giltigt för Skapa-åtgärder och ska vara inställt på "False".

    Kommentar

    Den här åtgärden är inte giltig för en URI om Shell-åtgärder också stöds.

  • Ta bort: Borttagningsåtgärder stöds på URI:n.
    • Attributet SupportFragment används om åtgärden Ta bort stöder konceptet.
    • Attributet SupportFiltering är INTE giltigt för borttagningsåtgärder och ska vara inställt på "False".

    Kommentar

    Den här åtgärden är inte giltig för en URI om Shell-åtgärder också stöds.

  • Uppräkning: Uppräkningsåtgärder stöds på URI:n.
    • Attributet SupportFragment stöds INTE för uppräkningsåtgärder och ska vara inställt på False.
    • Attributet SupportFiltering är giltigt och om plugin-programmet stöder filtrering bör det här attributet anges till "True".

    Kommentar

    Den här åtgärden är inte giltig för en URI om Shell-åtgärder också stöds.

  • Hämta: Hämta åtgärder stöds på URI:n.
    • Attributet SupportFragment används om åtgärden Get stöder konceptet.
    • Attributet SupportFiltering är INTE giltigt för Get-åtgärder och ska vara inställt på "False".

    Kommentar

    Den här åtgärden är inte giltig för en URI om Shell-åtgärder också stöds.

  • Anropa: Anropa åtgärder stöds på URI:n.
    • Attributet SupportFragment stöds inte för invoke-åtgärder och ska vara inställt på False.
    • Attributet SupportFiltering är inte giltigt och ska vara inställt på "False".

    Kommentar

    Den här åtgärden är inte giltig för en URI om Shell-åtgärder också stöds.

  • Sätt: Put-åtgärder stöds på URI:n.
    • Attributet SupportFragment används om put-åtgärden stöder konceptet.
    • Attributet SupportFiltering är inte giltigt för Put-åtgärder och ska vara inställt på "False".

    Kommentar

    Den här åtgärden är inte giltig för en URI om Shell-åtgärder också stöds.

  • Prenumerera: Prenumerationsåtgärder stöds på URI:n.
    • Attributet SupportFragment stöds inte för prenumerationsåtgärder och ska vara inställt på False.
    • Attributet SupportFiltering är inte giltigt för prenumerationsåtgärder och ska vara inställt på "False".

    Kommentar

    Den här åtgärden är inte giltig för en URI om Shell-åtgärder också stöds.

  • Gränssnitt: Shell-åtgärder stöds på URI:n.
    • Attributet SupportFragment stöds inte för Shell-åtgärder och bör anges till "False".
    • Attributet SupportFiltering är inte giltigt för Shell-åtgärder och ska vara inställt på "False".

    Kommentar

    Den här åtgärden är inte giltig för en URI om någon annan åtgärd också stöds.

    Kommentar

    Om en Shell-åtgärd har konfigurerats för en URI bearbetas åtgärderna Get, Put, Create, Delete, Invoke och Enumerate internt i tjänsten WS-Management (WinRM) för att hantera gränssnitt. Därför kan plugin-programmet inte hantera åtgärderna.

Cmdletar stöds

CertificateThumbprint <String>

Anger tumavtrycket för tjänstcertifikatet.

Det här värdet representerar strängen med tvåsiffriga hexadecimala värden i fältet Tumavtryck i certifikatet. Det anger det digitala offentliga nyckelcertifikatet (X509) för ett användarkonto som har behörighet att utföra den här åtgärden. Certifikat används i klientcertifikatbaserad autentisering. De kan endast mappas till lokala användarkonton och de fungerar inte med domänkonton. Om du vill hämta ett tumavtryck för certifikat använder Get-Item du cmdletarna eller Get-ChildItem i PowerShell-enheten Cert: .

Cmdletar stöds

Aktiverat booleskt <värde>

Anger om lyssnaren är aktiverad eller inaktiverad. Standardvärdet är Sant.

Cmdletar stöds

Filnamnssträng (plugin) <>

Anger filnamnet för plugin-programmet för åtgärder. Alla miljövariabler som placeras i den här posten utökas i användarnas kontext när en begäran tas emot. Eftersom varje användare kan ha en annan version av samma miljövariabel kan varje användare ha ett annat plugin-program. Den här posten får inte vara tom och måste peka på ett giltigt plugin-program.

Cmdletar stöds

HostName-sträng <>

Anger värdnamnet för den dator där tjänsten WS-Management (WinRM) körs.

Värdet måste vara ett fullständigt kvalificerat domännamn, en IPv4- eller IPv6-literalsträng eller ett jokertecken.

Cmdletar stöds

<Utfärdarsträng>

Anger namnet på certifikatutfärdare som utfärdade certifikatet.

Cmdletar stöds

Plugin-plugin-plugin-program <> för WS-Management är interna dynamiska länkbibliotek (DLL:er)

som ansluter till och utökar funktionerna i WS-Management . Plugin-API:et för WSW-Management innehåller funktioner som gör det möjligt för en användare att skriva plugin-program genom att implementera vissa API:er för resurs-URI:er och åtgärder som stöds. När plugin-programmen har konfigurerats för antingen WS-Management-tjänsten (WinRM) eller för Internet Information Services (IIS) läses plugin-programmen in i WS-Management-värden eller i IIS-värden. Fjärrbegäranden dirigeras till dessa plugin-startpunkter för att utföra åtgärder.

Cmdletar stöds

Port <osignerat kort heltal>

Anger den TCP-port som lyssnaren skapas för. Du kan ange valfritt värde från 1 till 65535.

Cmdletar stöds

Resurssträng <>

Anger en slutpunkt som representerar en distinkt typ av hanteringsåtgärd eller värde. En tjänst exponerar en eller flera resurser och vissa resurser kan ha fler än en instans. En hanteringsresurs liknar en WMI-klass eller en databastabell och en instans liknar en instans av klassen eller en rad i tabellen. Till exempel representerar klassen Win32_LogicalDisk en resurs. Win32_LogicalDisk="C:\\" är en specifik instans av resursen.

En URI (Uniform Resource Identifier) innehåller ett prefix och en sökväg till en resurs. Till exempel:

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

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

Cmdletar stöds

Resurssträng <>

Anger den URI (Uniform Resource Identifier) som identifierar en viss typ av resurs, till exempel en disk eller en process, på en dator.

En URI består av ett prefix och en sökväg till en resurs. Till exempel:

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

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

Cmdletar stöds

SDKVersion-sträng <>

Anger versionen av WS-Management-plugin-programmet SDK. Det enda giltiga värdet är 1.

Cmdletar stöds

Ämnessträng <>

Anger den entitet som identifieras av certifikatet.

Cmdletar stöds

Transportsträng <>

Anger vilken transport som ska användas för att skicka och ta emot WS-Management-protokollbegäranden och svar. Värdet måste vara antingen HTTP eller HTTPS.

Obs! Transportvärdet anges när du skapar en lyssnare.

Cmdletar stöds

URI-sträng <>

Identifierar den URI som åtkomsten är auktoriserad för baserat på värdet för Sddl-parametern.

Cmdletar stöds

URLPrefix-sträng <>

Ett URL-prefix som HTTP- eller HTTPS-begäranden ska accepteras på. Det här är en sträng som bara innehåller tecknen , , , understreck (_) och omvänt snedstreck (/). [9-0][A-Z][a-z] Strängen får inte börja med eller sluta med ett omvänt snedstreck (/). Om datornamnet till exempel är "SampleComputer" anger http://SampleMachine/URLPrefix WS-Management-klienten i måladressen.

Cmdletar stöds

Värdesträng <>

Anger värdet för en initieringsparameter, vilket är ett plugin-specifikt värde som används för att ange konfigurationsalternativ.

Cmdletar stöds

XMLRenderingType-sträng <>

Anger i vilket format XML skickas till plugin-program via WSMAN_DATA-objektet. Följande är giltiga värden:

  • Text: Inkommande XML-data finns i en WSMAN_DATA_TYPE_TEXT struktur, som representerar XML som en PCWSTR-minnesbuffert .
  • XMLReader: Inkommande XML-data finns i en WSMAN_DATA_TYPE_WS_XML_READER struktur, som representerar XML som ett XmlReader-objekt , som definieras i huvudfilen "WebServices.h".

Cmdletar stöds

Använda pipelinen

Provider-cmdletar accepterar pipelineindata. Du kan använda pipelinen för att förenkla uppgiften genom att skicka providerdata från en cmdlet till en annan provider-cmdlet. Mer information om hur du använder pipelinen med provider-cmdletar finns i cmdlet-referenserna i den här artikeln.

Få hjälp

Från och med Windows PowerShell 3.0 kan du få anpassade hjälpavsnitt för provider-cmdletar som förklarar hur dessa cmdletar beter sig på en filsystemenhet.

Om du vill få hjälpavsnitt som är anpassade för filsystemenheten kör du ett Get-Help-kommando på en filsystemenhet eller använder parametern -PathGet-Help för att ange en filsystemenhet.

Get-Help Get-ChildItem

Get-Help Get-ChildItem -Path wsman:

Se även