Set-WSManInstance

Referens

Modul:: Microsoft.WSMan.Management

Ändrar hanteringsinformationen som är relaterad till en resurs.

Syntax

Set-WSManInstance
   [-ApplicationName <String>]
   [-ComputerName <String>]
   [-Dialect <Uri>]
   [-FilePath <String>]
   [-Fragment <String>]
   [-OptionSet <Hashtable>]
   [-Port <Int32>]
   [-ResourceURI] <Uri>
   [[-SelectorSet] <Hashtable>]
   [-SessionOption <SessionOption>]
   [-UseSSL]
   [-ValueSet <Hashtable>]
   [-Credential <PSCredential>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <String>]
   [<CommonParameters>]

Set-WSManInstance
   [-ConnectionURI <Uri>]
   [-Dialect <Uri>]
   [-FilePath <String>]
   [-Fragment <String>]
   [-OptionSet <Hashtable>]
   [-ResourceURI] <Uri>
   [[-SelectorSet] <Hashtable>]
   [-SessionOption <SessionOption>]
   [-ValueSet <Hashtable>]
   [-Credential <PSCredential>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <String>]
   [<CommonParameters>]

Description

Den här cmdleten är endast tillgänglig på Windows-plattformen.

Cmdleten Set-WSManInstance ändrar hanteringsinformationen som är relaterad till en resurs.

Den här cmdleten använder WinRM-anslutnings-/transportlagret för att ändra informationen.

Exempel

Exempel 1: Inaktivera en lyssnare på den lokala datorn

Set-WSManInstance -ResourceURI winrm/config/listener -SelectorSet @{address="*";transport="https"} -ValueSet @{Enabled="false"}

cfg                   : http://schemas.microsoft.com/wbem/wsman/1/config/listener
xsi                   : http://www.w3.org/2001/XMLSchema-instance
lang                  : en-US
Address               : *
Transport             : HTTPS
Port                  : 443
Hostname              :
Enabled               : false
URLPrefix             : wsman
CertificateThumbprint :
ListeningOn           : {127.0.0.1, 172.30.168.171, ::1, 2001:4898:0:fff:0:5efe:172.30.168.171...}

Det här kommandot inaktiverar HTTPS-lyssnaren på den lokala datorn.

Viktigt

Parametern ValueSet är skiftlägeskänslig när den matchar de angivna egenskaperna.

I det här kommandot kan du till exempel

Detta misslyckas: -ValueSet @{enabled="False"}

Detta lyckas: -ValueSet @{Enabled="False"}

Exempel 2: Ange den maximala kuvertstorleken på den lokala datorn

Set-WSManInstance -ResourceURI winrm/config -ValueSet @{MaxEnvelopeSizekb = "200"}

cfg                 : http://schemas.microsoft.com/wbem/wsman/1/config
lang                : en-US
MaxEnvelopeSizekb   : 200
MaxTimeoutms        : 60000
MaxBatchItems       : 32000
MaxProviderRequests : 4294967295
Client              : Client
Service             : Service
Winrs               : Winrs

Det här kommandot anger värdet MaxEnvelopeSizekb till 200 på den lokala datorn.

Viktigt

Parametern ValueSet är skiftlägeskänslig när den matchar de angivna egenskaperna.

Du kan till exempel använda kommandot ovan.

Detta misslyckas: -ValueSet @{MaxEnvelopeSizeKB ="200"}

Detta lyckas: -ValueSet @{MaxEnvelopeSizekb ="200"}

Exempel 3: Inaktivera en lyssnare på en fjärrdator

Set-WSManInstance -ResourceURI winrm/config/listener -ComputerName SERVER02 -SelectorSet @{address="*";transport="https"} -ValueSet @{Enabled="false"}

cfg                   : http://schemas.microsoft.com/wbem/wsman/1/config/listener
xsi                   : http://www.w3.org/2001/XMLSchema-instance
lang                  : en-US
Address               : *
Transport             : HTTPS
Port                  : 443
Hostname              :
Enabled               : false
URLPrefix             : wsman
CertificateThumbprint :
ListeningOn           : {127.0.0.1, 172.30.168.172, ::1, 2001:4898:0:fff:0:5efe:172.30.168.172...}

Det här kommandot inaktiverar HTTPS-lyssnaren på fjärrdatorn SERVER02.

Viktigt

Parametern ValueSet är skiftlägeskänslig när den matchar de angivna egenskaperna.

Du kan till exempel använda kommandot ovan.

Detta misslyckas: -ValueSet @{enabled="False"}

Detta lyckas: -ValueSet @{Enabled="False"}

Parametrar

-ApplicationName

Anger programnamnet i anslutningen. Standardvärdet för parametern ApplicationName är "WSMAN". Den fullständiga identifieraren för fjärrslutpunkten har följande format:

<transport>://<server>:<port>/<ApplicationName>

Exempel:

http://server01:8080/WSMAN

Internet Information Services (IIS), som är värd för sessionen, vidarebefordrar begäranden med den här slutpunkten till det angivna programmet. Den här standardinställningen WSMAN för är lämplig för de flesta användningsområden. Den här parametern är avsedd att användas när flera datorer upprättar fjärranslutningar till en dator som kör Windows PowerShell. I det här fallet är IIS värd för Web Services for Management (WS-Management) för effektivitet.

Type:	String
Position:	Named
Default value:	Wsman
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Authentication

Anger vilken autentiseringsmekanism som ska användas på servern. Möjliga värden:

Basic: Basic är ett schema där användarnamnet och lösenordet skickas i klartext till servern eller proxyn.
Default : Använd autentiseringsmetoden som implementeras av protokollet WS-Management. Det här är standardinställningen.
Digest: Digest är ett utmaningssvarsschema som använder en server angiven datasträng för utmaningen.
Kerberos: Klientdatorn och servern autentiseras ömsesidigt med hjälp av Kerberos-certifikat.
Negotiate: Negotiate är ett svarsschema som förhandlar med servern eller proxyservern för att fastställa vilket schema som ska användas för autentisering. Till exempel tillåter det här parametervärdet förhandling för att avgöra om Kerberos-protokollet eller NTLM används.
CredSSP: Använd CredSSP-autentisering (Credential Security Support Provider), vilket gör att användaren kan delegera autentiseringsuppgifter. Det här alternativet är utformat för kommandon som körs på en fjärrdator men samlar in data från eller kör ytterligare kommandon på andra fjärrdatorer.

Varning

CredSSP delegerar användarens autentiseringsuppgifter från den lokala datorn till en fjärrdator. Den här metoden ökar säkerhetsrisken för fjärråtgärden. Om fjärrdatorn komprometteras kan autentiseringsuppgifterna användas för att styra nätverkssessionen när autentiseringsuppgifterna skickas till den.

Type:	AuthenticationMechanism
Aliases:	auth, am
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CertificateThumbprint

Anger certifikatet för den digitala offentliga nyckeln (X509) för ett användarkonto som har behörighet att utföra den här åtgärden. Ange certifikatets tumavtryck.

Certifikat används i klientcertifikatbaserad autentisering. De kan endast mappas till lokala användarkonton. de fungerar inte med domänkonton.

Om du vill hämta ett tumavtryck för certifikatet Get-Item använder du kommandot eller Get-ChildItem på PowerShell-enheten Cert: .

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ComputerName

Anger den dator som du vill köra hanteringsåtgärden mot. Värdet kan vara ett fullständigt kvalificerat domännamn, ett NetBIOS-namn eller en IP-adress. Använd namnet på den lokala datorn, localhost, eller en punkt (.) för att ange den lokala datorn. Den lokala datorn är standard.

När fjärrdatorn finns i en annan domän än användaren måste du använda ett fullständigt kvalificerat domännamn. Du kan skicka ett värde för den här parametern till cmdleten .

Type:	String
Aliases:	cn
Position:	Named
Default value:	Localhost
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConnectionURI

Anger anslutningsslutpunkten. Formatet för den här strängen är:

<Transport>://<Server>:<Port>/<ApplicationName>

Följande sträng är ett korrekt formaterat värde för den här parametern:

http://Server01:8080/WSMAN

URI:n måste vara fullständigt kvalificerad.

Type:	Uri
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

Anger ett användarkonto som har behörighet att utföra den här åtgärden. Standard är den aktuella användaren. Ange ett användarnamn, till exempel User01, Domain01\User01eller User@Domain.com. Alternativt kan du ange ett PSCredential-objekt , till exempel ett objekt som returneras av cmdleten Get-Credential . När du skriver ett användarnamn uppmanas du att ange ett lösenord.

Type:	PSCredential
Aliases:	cred, c
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Dialect

Anger vilken dialekt som ska användas i filterpredikatet. Detta kan vara vilken dialekt som helst som stöds av fjärrtjänsten. Följande alias kan användas för dialektens URI:

WQL: http://schemas.microsoft.com/wbem/wsman/1/WQL
Selector: http://schemas.microsoft.com/wbem/wsman/1/wsman/SelectorFilter
Association: http://schemas.dmtf.org/wbem/wsman/1/cimbinding/associationFilter

Type:	Uri
Position:	Named
Default value:	http://schemas.microsoft.com/wbem/wsman/1/WQL
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FilePath

Anger sökvägen till en fil som används för att uppdatera en hanteringsresurs. Du anger hanteringsresursen med hjälp av parametern ResourceURI och parametern SelectorSet . Följande kommando använder till exempel Parametern FilePath :

Invoke-WSManAction -Action StopService -ResourceUri wmicimv2/Win32_Service -SelectorSet @{Name="spooler"} -FilePath:c:\input.xml -authentication default

Det här kommandot anropar metoden StopService på Spooler-tjänsten med hjälp av indata från en fil. Filen, Input.xml, innehåller följande innehåll:

<p:StopService_INPUT xmlns:p="http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service" />

Type:	String
Aliases:	Path
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Fragment

Anger ett avsnitt i instansen som ska uppdateras eller hämtas för den angivna åtgärden. Om du till exempel vill hämta status för en bufferttjänst anger du -Fragment Status.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-OptionSet

Skickar en uppsättning växlar till en tjänst för att ändra eller förfina typen av begäran. Dessa liknar växlar som används i kommandoradsgränssnitt eftersom de är tjänstspecifika. Valfritt antal alternativ kan anges.

I följande exempel visas den syntax som skickar värdena 1, 2och 3 för parametrarna a, boch c :

-OptionSet @{a=1;b=2;c=3}

Type:	Hashtable
Aliases:	os
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Port

Anger vilken port som ska användas när klienten ansluter till WinRM-tjänsten. När transporten är HTTP är standardporten 80. När transporten är HTTPS är standardporten 443.

När du använder HTTPS som transport måste värdet för parametern ComputerName matcha serverns certifikatnamn (CN). Men om parametern SkipCNCheck anges som en del av parametern SessionOption behöver certifikatets gemensamma namn på servern inte matcha serverns värdnamn. Parametern SkipCNCheck ska endast användas för betrodda datorer.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceURI

Innehåller URI (Uniform Resource Identifier) för resursklassen eller instansen. URI:n används för att identifiera en viss typ av resurs, till exempel diskar eller processer, på en dator.

En URI består av ett prefix och en sökväg till en resurs. 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

Type:	Uri
Aliases:	ruri
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-SelectorSet

Anger en uppsättning värdepar som används för att välja specifika hanteringsresursinstanser. Parametern SelectorSet används när det finns fler än en instans av resursen. Värdet för parametern SelectorSet måste vara en hash-tabell. I följande exempel visas hur du anger ett värde för den här parametern:

-SelectorSet @{Name="WinRM";ID="yyy"}

Type:	Hashtable
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-SessionOption

Definierar en uppsättning utökade alternativ för den WS-Management sessionen. Ange ett SessionOption-objekt som du skapar med cmdleten New-WSManSessionOption . Mer information om vilka alternativ som är tillgängliga finns i New-WSManSessionOption.

Type:	SessionOption
Aliases:	so
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UseSSL

Anger att SSL-protokollet (Secure Sockets Layer) ska användas för att upprätta en anslutning till fjärrdatorn. Som standard används inte SSL.

WS-Management krypterar allt Windows PowerShell innehåll som överförs via nätverket. Med parametern UseSSL kan du ange ytterligare skydd för HTTPS i stället för HTTP. Om SSL inte är tillgängligt på porten som används för anslutningen och du anger den här parametern misslyckas kommandot.

Type:	SwitchParameter
Aliases:	ssl
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ValueSet

Anger en hash-tabell som hjälper dig att ändra en hanteringsresurs. Du anger hanteringsresursen med hjälp av parametern ResourceURI och parametern SelectorSet . Värdet för parametern ValueSet måste vara en hash-tabell.

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

Indata

None

Denna cmdlet accepterar inga indata.

Utdata

None

Denna cmdlet genererar inga utdata.

Set-WSManInstance

Syntax

Description

Exempel

Exempel 1: Inaktivera en lyssnare på den lokala datorn

Exempel 2: Ange den maximala kuvertstorleken på den lokala datorn

Exempel 3: Inaktivera en lyssnare på en fjärrdator

Parametrar

-ApplicationName

-Authentication

-CertificateThumbprint

-ComputerName

-ConnectionURI

-Credential

-Dialect

-FilePath

-Fragment

-OptionSet

-Port

-ResourceURI

-SelectorSet

-SessionOption

-UseSSL

-ValueSet

Indata

Utdata

Relaterade länkar

Ytterligare resurser