Megosztás a következőn keresztül:

Set-WSManInstance

  • Referencia
Modul:
Microsoft.WSMan.Management

Módosítja az erőforráshoz kapcsolódó felügyeleti információkat.

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

A Set-WSManInstance parancsmag módosítja az erőforráshoz kapcsolódó felügyeleti információkat.

Ez a parancsmag a WinRM kapcsolati/átviteli réteget használja az információk módosításához.

Példák

1. példa: Figyelő letiltása a helyi számítógépen

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

Ez a parancs letiltja a HTTPS-figyelőt a helyi számítógépen.

Fontos

A ValueSet paraméter megkülönbözteti a kis- és nagybetűket, ha megfelel a megadott tulajdonságoknak.

Ebben a parancsban például

Ez nem sikerül: -ValueSet @{enabled="False"}

Ez a következő sikeres: -ValueSet @{Enabled="False"}

2. példa: A boríték maximális méretének beállítása a helyi számítógépen

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

Ez a parancs a MaxEnvelopeSizekb értéket 200-ra állítja a helyi számítógépen.

Fontos

A ValueSet paraméter megkülönbözteti a kis- és nagybetűket, ha megfelel a megadott tulajdonságoknak.

Használja például a fenti parancsot.

Ez nem sikerül: -ValueSet @{MaxEnvelopeSizeKB ="200"}

Ez a következő sikeres: -ValueSet @{MaxEnvelopeSizekb ="200"}

3. példa: Figyelő letiltása távoli számítógépen

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

Ez a parancs letiltja a HTTPS-figyelőt a távoli számítógépen Standard kiadás RVER02.

Fontos

A ValueSet paraméter megkülönbözteti a kis- és nagybetűket, ha megfelel a megadott tulajdonságoknak.

Használja például a fenti parancsot.

Ez nem sikerül: -ValueSet @{enabled="False"}

Ez a következő sikeres: -ValueSet @{Enabled="False"}

Paraméterek

-ApplicationName

Megadja az alkalmazás nevét a kapcsolatban. Az ApplicationName paraméter alapértelmezett értéke a "WSMAN". A távoli végpont teljes azonosítója a következő formátumban van:

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

Példa:

http://server01:8080/WSMAN

A munkamenetet üzemeltető Internet Information Services (IIS) továbbítja a végponttal kapcsolatos kérelmeket a megadott alkalmazásnak. Ez az WSMAN alapértelmezett beállítás a legtöbb használathoz megfelelő. Ez a paraméter akkor használható, ha számos számítógép létesít távoli kapcsolatot egy Windows PowerShellt futtató számítógéppel. Ebben az esetben az IIS a Web Services for Management (WS-Management) szolgáltatást üzemelteti a hatékonyság érdekében.

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

-Authentication

Megadja a kiszolgálón használandó hitelesítési mechanizmust. A lehetséges értékek a következők:

  • Basic: Az alapszintű séma egy olyan séma, amelyben a rendszer a felhasználónevet és a jelszót világos szövegben küldi el a kiszolgálónak vagy a proxynak.
  • Default : Használja a WS-Management protokoll által implementált hitelesítési módszert. Ez az alapértelmezett beállítás.
  • Digest: A kivonatolás egy kihívás-válasz séma, amely egy kiszolgáló által megadott adatsztringet használ a feladathoz.
  • Kerberos: Az ügyfélszámítógép és a kiszolgáló Kerberos-tanúsítványokkal kölcsönösen hitelesítik egymást.
  • Negotiate: Az egyeztetés egy kihívás-válasz séma, amely egyeztet a kiszolgálóval vagy a proxyval a hitelesítéshez használni kívánt séma meghatározásához. Ez a paraméterérték például lehetővé teszi a egyeztetést annak megállapítására, hogy a Kerberos protokoll vagy az NTLM van-e használatban.
  • CredSSP: Hitelesítőadat-biztonsági támogatási szolgáltató (CredSSP) hitelesítés használata, amely lehetővé teszi, hogy a felhasználó hitelesítő adatokat delegáljon. Ez a beállítás olyan parancsokhoz készült, amelyek egy távoli számítógépen futnak, de adatokat gyűjtenek más távoli számítógépekről, vagy további parancsokat futtatnak.

Figyelemfelhívás

A CredSSP a felhasználó hitelesítő adatait a helyi számítógépről egy távoli számítógépre delegálja. Ez a gyakorlat növeli a távoli művelet biztonsági kockázatát. Ha a távoli számítógép biztonsága sérül, a hitelesítő adatok átadásakor a hitelesítő adatokkal szabályozható a hálózati munkamenet.

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

-CertificateThumbprint

Egy olyan felhasználói fiók digitális nyilvános kulcsú tanúsítványát (X509) adja meg, amely jogosult a művelet végrehajtására. Adja meg a tanúsítvány ujjlenyomatát.

A tanúsítványok az ügyféltanúsítvány-alapú hitelesítésben használatosak. Ezek csak helyi felhasználói fiókokra képezhetők le; nem működnek tartományi fiókokkal.

Tanúsítvány ujjlenyomatának lekéréséhez használja a Get-Item PowerShell-meghajtón Cert: található parancsot.Get-ChildItem

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

-ComputerName

Azt a számítógépet adja meg, amelyen futtatni szeretné a felügyeleti műveletet. Az érték lehet teljes tartománynév, NetBIOS-név vagy IP-cím. A helyi számítógép nevét localhostvagy pontját (.) használva adja meg a helyi számítógépet. A helyi számítógép az alapértelmezett.

Ha a távoli számítógép a felhasználótól eltérő tartományban van, teljes tartománynevet kell használnia. Ennek a paraméternek az értékét a parancsmagba is be lehet csövezni.

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

-ConnectionURI

Megadja a kapcsolati végpontot. A sztring formátuma a következő:

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

A következő sztring a paraméter megfelelő formázott értéke:

http://Server01:8080/WSMAN

Az URI-nak teljes mértékben minősítettnek kell lennie.

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

-Credential

A művelet végrehajtásához engedéllyel rendelkező felhasználói fiókot ad meg. Alapértelmezés szerint az aktuális felhasználó. Írjon be egy felhasználónevet, például User01: , Domain01\User01vagy User@Domain.com. Másik lehetőségként írjon be egy PSCredential objektumot, például a parancsmag által Get-Credential visszaadott objektumot. Amikor beír egy felhasználónevet, a rendszer kérni fogja a jelszót.

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

-Dialect

Megadja a szűrő predikátumban használni kívánt dialektust. Ez bármely olyan dialektus lehet, amelyet a távoli szolgáltatás támogat. A dialektus URI-hoz a következő aliasok használhatók:

  • 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

A felügyeleti erőforrás frissítéséhez használt fájl elérési útját adja meg. A felügyeleti erőforrást a ResourceURI paraméterrel és a SelectorSet paraméterrel adhatja meg. A következő parancs például a FilePath paramétert használja:

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

Ez a parancs meghívja a StopService metódust a Spooler szolgáltatásban egy fájl bemenetének használatával. A fájl a Input.xmlkövetkező tartalmat tartalmazza:

<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

Megadja a példány azon szakaszát, amelyet frissíteni vagy le kell kérni a megadott művelethez. Egy sorkezelő szolgáltatás állapotának lekéréséhez például adja meg -Fragment Statusa elemet.

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

-OptionSet

A kérés jellegének módosításához vagy finomításához kapcsolókat ad át egy szolgáltatásra. Ezek hasonlóak a parancssori rendszerhéjakban használt kapcsolókhoz, mert szolgáltatásspecifikusak. Tetszőleges számú beállítás adható meg.

Az alábbi példa azt a szintaxist mutatja be, amely megfelel az értékeknek1, 2valamint 3 a paramétereknek bés c a aparamétereknek:

-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

Megadja azt a portot, amelyet az ügyfél a WinRM szolgáltatáshoz való csatlakozáskor használ. Ha az átvitel HTTP, az alapértelmezett port 80. Ha az átvitel HTTPS, az alapértelmezett port a 443.

Ha HTTPS-t használ átvitelként, a ComputerName paraméter értékének meg kell egyeznie a kiszolgáló tanúsítványának köznapi nevével (CN). Ha azonban a SkipCNCheck paraméter a SessionOption paraméter részeként van megadva, akkor a kiszolgáló tanúsítványának köznapi nevének nem kell megegyeznie a kiszolgáló gazdagépnevével. A SkipCNCheck paraméter csak megbízható gépekhez használható.

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

-ResourceURI

Az erőforrásosztály vagy -példány egységes erőforrás-azonosítóját (URI) tartalmazza. Az URI egy adott típusú erőforrás, például lemezek vagy folyamatok azonosítására szolgál a számítógépen.

Az URI egy előtagból és egy erőforrás elérési útból áll. Példa:

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

Az adott felügyeleti erőforráspéldányok kiválasztásához használt értékpárok készletét adja meg. A SelectorSet paraméter akkor használatos, ha az erőforrás több példánya is létezik. A SelectorSet paraméter értékének kivonattáblának kell lennie. Az alábbi példa bemutatja, hogyan adhat meg értéket ehhez a paraméterhez:

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

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

-SessionOption

A WS-Management munkamenet kiterjesztett beállításait határozza meg. Adjon meg egy SessionOption objektumot, amelyet a New-WSManSessionOption parancsmaggal hoz létre. Az elérhető lehetőségekről további információt a New-WSManSessionOption című témakörben talál.

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

-UseSSL

Meghatározza, hogy a távoli számítógéphez való csatlakozáshoz a Secure Sockets Layer (SSL) protokollt kell használni. Alapértelmezés szerint az SSL nem használatos.

A WS-Management a hálózaton keresztül továbbított összes Windows PowerShell-tartalmat titkosítja. A UseSSL paraméterrel a HTTP helyett a HTTPS további védelmét adhatja meg. Ha az SSL nem érhető el a kapcsolathoz használt porton, és ezt a paramétert adja meg, a parancs meghiúsul.

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

-ValueSet

Egy kivonattáblát ad meg, amely segít módosítani egy felügyeleti erőforrást. A felügyeleti erőforrást a ResourceURI paraméterrel és a SelectorSet paraméterrel adhatja meg. A ValueSet paraméter értékének kivonattáblának kell lennie.

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

Bevitelek

None

Ehhez a parancsmaghoz nem lehet objektumokat csövezni.

Kimenetek

XmlElement

Ez a parancsmag a frissített WSMan-példányt Adja vissza XmlElement-objektumként.