Set-WSManInstance

  • Reference
Modul:
Microsoft.WSMan.Management

Upraví informace o správě, které souvisejí s prostředkem.

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

Rutina Set-WSManInstance upraví informace o správě, které souvisejí s prostředkem.

Tato rutina používá k úpravě informací vrstvu připojení nebo přenosu WinRM.

Příklady

Příklad 1: Zakázání naslouchacího procesu v místním počítači

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

Tento příkaz zakáže naslouchací proces HTTPS na místním počítači.

Důležité

Parametr ValueSet rozlišují malá a velká písmena při porovnávání zadaných vlastností.

Například v tomto příkazu

To se nezdaří: -ValueSet @{enabled="False"}

To je úspěšné: -ValueSet @{Enabled="False"}

Příklad 2: Nastavení maximální velikosti obálky v místním počítači

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

Tento příkaz nastaví hodnotu MaxEnvelopeSizekb na 200 v místním počítači.

Důležité

Parametr ValueSet rozlišují malá a velká písmena při porovnávání zadaných vlastností.

Například pomocí výše uvedeného příkazu.

To se nezdaří: -ValueSet @{MaxEnvelopeSizeKB ="200"}

To je úspěšné: -ValueSet @{MaxEnvelopeSizekb ="200"}

Příklad 3: Zakázání naslouchacího procesu ve vzdáleném počítači

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

Tento příkaz zakáže naslouchací proces HTTPS na vzdáleném počítači SERVER02.

Důležité

Parametr ValueSet rozlišují malá a velká písmena při porovnávání zadaných vlastností.

Například pomocí výše uvedeného příkazu.

To se nezdaří: -ValueSet @{enabled="False"}

To je úspěšné: -ValueSet @{Enabled="False"}

Parametry

-ApplicationName

Určuje název aplikace v připojení. Výchozí hodnota parametru ApplicationName je WSMAN. Úplný identifikátor vzdáleného koncového bodu je v následujícím formátu:

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

Příklad:

http://server01:8080/WSMAN

Internetová informační služba (IIS), která hostuje relaci, předává požadavky s tímto koncovým bodem do zadané aplikace. Toto výchozí nastavení WSMAN je vhodné pro většinu použití. Tento parametr je navržený tak, aby se používal, když mnoho počítačů navazuje vzdálená připojení k jednomu počítači, na kterém běží Windows PowerShell. V tomto případě služba IIS hostuje webové služby pro správu (WS-Management) kvůli efektivitě.

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

-Authentication

Určuje mechanismus ověřování, který se má použít na serveru. Možné hodnoty jsou:

  • Basic: Základní je schéma, ve kterém se uživatelské jméno a heslo odesílají na server nebo proxy server ve formátu prostého textu.
  • Default : Použijte metodu ověřování implementovanou protokolem WS-Management. Tato možnost je výchozí.
  • Digest: Digest je schéma odpovědí na výzvu, které pro výzvu používá datový řetězec určený serverem.
  • Kerberos: Klientský počítač a server se vzájemně ověřují pomocí certifikátů Kerberos.
  • Negotiate: Negotiate je schéma odezvy výzvy, které vyjednává se serverem nebo proxy serverem k určení schématu, které se má použít k ověřování. Tato hodnota parametru například umožňuje vyjednávání, zda se používá protokol Kerberos nebo NTLM.
  • CredSSP: Použijte ověřování zprostředkovatele podpory zabezpečení přihlašovacích údajů (CredSSP), které uživateli umožňuje delegovat přihlašovací údaje. Tato možnost je určená pro příkazy, které běží na jednom vzdáleném počítači, ale shromažďují data z jiných vzdálených počítačů nebo spouštějí další příkazy.

Upozornění

CredSSP deleguje přihlašovací údaje uživatele z místního počítače na vzdálený počítač. Tento postup zvyšuje riziko zabezpečení vzdálené operace. Pokud dojde k ohrožení zabezpečení vzdáleného počítače, lze při předání přihlašovacích údajů použít k řízení síťové relace.

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

-CertificateThumbprint

Určuje certifikát digitálního veřejného klíče (X509) uživatelského účtu, který má oprávnění k provedení této akce. Zadejte kryptografický otisk certifikátu.

Certifikáty se používají při ověřování na základě klientských certifikátů. Mohou být mapovány pouze na místní uživatelské účty; nefungují s doménovými účty.

Pokud chcete získat kryptografický otisk certifikátu, použijte příkaz nebo Get-ChildItem ho Get-Item použijte na jednotce PowerShelluCert:.

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

-ComputerName

Určuje počítač, pro který chcete spustit operaci správy. Hodnota může být plně kvalifikovaný název domény, název NetBIOS nebo IP adresa. K určení místního počítače použijte název localhostmístního počítače nebo tečku (.). Místní počítač je výchozí.

Pokud je vzdálený počítač v jiné doméně než uživatel, musíte použít plně kvalifikovaný název domény. Do rutiny můžete zadat hodnotu tohoto parametru.

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

-ConnectionURI

Určuje koncový bod připojení. Formát tohoto řetězce je:

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

Následující řetězec je správně naformátovaná hodnota pro tento parametr:

http://Server01:8080/WSMAN

Identifikátor URI musí být plně kvalifikovaný .

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

-Credential

Určuje uživatelský účet, který má oprávnění k provedení této akce. Ve výchozím nastavení je to aktuální uživatel. Zadejte uživatelské jméno, například User01, Domain01\User01nebo User@Domain.com. Případně zadejte objekt PSCredential , například objekt vrácený rutinou Get-Credential . Když zadáte uživatelské jméno, zobrazí se výzva k zadání hesla.

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

-Dialect

Určuje dialekt, který se má použít v predikátu filtru. Může to být jakýkoli dialekt, který vzdálená služba podporuje. Pro identifikátor URI dialektu je možné použít následující aliasy:

  • 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

Určuje cestu k souboru, který se používá k aktualizaci prostředku správy. Prostředek správy zadáte pomocí parametru ResourceURI a parametru SelectorSet . Například následující příkaz používá parametr FilePath :

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

Tento příkaz volá metodu StopService ve službě zařazování pomocí vstupu ze souboru. Soubor obsahuje Input.xmlnásledující obsah:

<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

Určuje oddíl uvnitř instance, která se má aktualizovat nebo načíst pro zadanou operaci. Pokud například chcete získat stav služby zařazování, zadejte -Fragment Status.

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

-OptionSet

Předá sadu přepínačů službě, která upraví nebo upřesní povahu požadavku. Jsou podobné přepínačům používaným v prostředích příkazového řádku, protože jsou specifické pro službu. Můžete zadat libovolný počet možností.

Následující příklad ukazuje syntaxi, která předává hodnoty 1, 2a 3 pro a, ba c parametry:

-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

Určuje port, který se má použít, když se klient připojí ke službě WinRM. Pokud je přenos HTTP, výchozí port je 80. Když je přenos HTTPS, výchozí port je 443.

Při použití PROTOKOLU HTTPS jako přenosu musí hodnota parametru ComputerName odpovídat běžnému názvu certifikátu serveru (CN). Pokud je však parametr SkipCNCheck zadán jako součást parametru SessionOption , nemusí běžný název certifikátu serveru odpovídat názvu hostitele serveru. Parametr SkipCNCheck by se měl používat jenom pro důvěryhodné počítače.

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

-ResourceURI

Obsahuje identifikátor URI (Uniform Resource Identifier) třídy prostředků nebo instance. Identifikátor URI slouží k identifikaci konkrétního typu prostředku, jako jsou disky nebo procesy, v počítači.

Identifikátor URI se skládá z předpony a cesty k prostředku. Příklad:

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

Určuje sadu párů hodnot, které se používají k výběru konkrétních instancí prostředků správy. Parametr SelectorSet se používá, pokud existuje více instancí prostředku. Hodnota parametru SelectorSet musí být tabulka hash. Následující příklad ukazuje, jak zadat hodnotu pro tento parametr:

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

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

-SessionOption

Definuje sadu rozšířených možností pro relaci WS-Management. Zadejte objekt SessionOption, který vytvoříte pomocí rutinyNew-WSManSessionOption. Další informace o dostupných možnostech naleznete v tématu New-WSManSessionOption.

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

-UseSSL

Určuje, že protokol SSL (Secure Sockets Layer) by se měl použít k navázání připojení ke vzdálenému počítači. Ve výchozím nastavení se ssl nepoužívá.

WS-Management šifruje veškerý obsah Windows PowerShellu přenášený přes síť. Parametr UseSSL umožňuje zadat další ochranu HTTPS místo protokolu HTTP. Pokud protokol SSL není k dispozici na portu, který se používá pro připojení, a zadáte tento parametr, příkaz selže.

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

-ValueSet

Určuje hashovací tabulku, která pomáhá upravit prostředek správy. Prostředek správy zadáte pomocí parametru ResourceURI a parametru SelectorSet . Hodnota parametru ValueSet musí být tabulka hash.

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

Vstupy

None

Do této rutiny nemůžete roušit objekty.

Výstupy

None

Tato rutina nevrátí žádný výstup.