WSMan-provider

  • Artikel

Providernamn

WSMan

Enheter

WSMan:

Kort beskrivning

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

Detaljerad beskrivning

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

WSMan-providern exponerar en PowerShell-enhet med en katalogstruktur som motsvarar en logisk gruppering av WS-Management konfigurationsinställningar. Dessa grupperingar 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 katalogen WSMan: Plugin på enheten och egenskaperna visas som objekt i varje sessionskonfiguration.

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

Anteckning

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. Inga fel genereras, men kommandona är inte effektiva Om du vill ändra 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.

    Anteckning

    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 protokoll 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 vidarebefordran av händelser.
    • Plugin-programmet Microsoft.PowerShell.
    • Plugin-programmet för WMI-providern (Windows Management Instrumentation). 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 är konfigurerad 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. Men för att få åtkomst till konfigurationsinställningarna för en fjärrdator måste du upprätta en anslutning till fjärrdatorn med Connect-WSMan. När en anslutning görs 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 namnet på enheten. Skriv till exempel.

Set-Location C:

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

Set-Location -Path  WSMan:\SERVER01

Anteckning

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 butiker på platsen för Localhost-arkivet.

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 butiker på fjärrdatorns lagringsplats "SERVER01".

Get-ChildItem -path WSMan:\SERVER01

Anteckning

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 WSMAN på 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 i 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 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 katalogen Resurser 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. Det 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:

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

Anteckning

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 omfattar SupportsFiltering och SupportsFragment.

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

    Anteckning

    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 Delete stöder konceptet.
    • Attributet SupportFiltering är INTE giltigt för borttagningsåtgärder och ska vara inställt på "False".

    Anteckning

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

  • Räkna upp: Uppräkningsåtgärder stöds på URI:n.
    • Attributet SupportFragment stöds INTE för uppräkningsåtgärder och bör anges till Falskt.
    • Attributet SupportFiltering är giltigt och om plugin-programmet stöder filtrering bör det här attributet anges till "Sant".

    Anteckning

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

    Anteckning

    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 Anropa åtgärder och bör anges till Falskt.
    • Attributet SupportFiltering är inte giltigt och ska vara inställt på "False".

    Anteckning

    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 bör anges till "False".

    Anteckning

    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 bör anges till Falskt.
    • Attributet SupportFiltering är inte giltigt för prenumerationsåtgärder och bör anges till "False".

    Anteckning

    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 bör anges till "False".

    Anteckning

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

    Anteckning

    Om en Shell-åtgärd har konfigurerats för en URI bearbetas åtgärderna Get, Put, Skapa, 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. Den anger certifikatet för digital offentlig nyckel (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 certifikattumavtryck använder du Get-Item 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

FileName-sträng (plugin) <>

Anger filnamnet för åtgärds-plugin-programmet. 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 olika 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 winrm-tjänsten (WS-Management) körs.

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

Cmdletar stöds

<Utfärdarsträng>

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

Cmdletar stöds

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

som ansluter till och utökar funktionerna i WS-Management . WSW-Management Plugin-API:et tillhandahå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 respektive IIS-värden. Fjärrbegäranden dirigeras till de här plugin-startpunkterna 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. Exempel:

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

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

Cmdletar som 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. Exempel:

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

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

Cmdletar som stöds

SDKVersion-sträng <>

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

Cmdletar som stöds

Ämnessträng <>

Anger den entitet som identifieras av certifikatet.

Cmdletar som 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 som stöds

URI-sträng <>

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

Cmdletar som 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 den WS-Management klienten i måladressen.

Cmdletar som 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 som 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 som 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 fungerar 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

about_Providers