Invoke-WSManAction

Modul:

Microsoft.WSMan.Management Module

Vyvolá akci objektu určeného identifikátorem URI prostředku a selektory.

Syntax

URI (Výchozí)

Invoke-WSManAction
    [-Action] <String>
    [[-SelectorSet] <Hashtable>]
    [-ResourceURI] <Uri>
    [-ConnectionURI <Uri>]
    [-FilePath <String>]
    [-OptionSet <Hashtable>]
    [-SessionOption <SessionOption>]
    [-ValueSet <Hashtable>]
    [-Credential <PSCredential>]
    [-Authentication <AuthenticationMechanism>]
    [-CertificateThumbprint <String>]
    [<CommonParameters>]

ComputerName

Invoke-WSManAction
    [-Action] <String>
    [[-SelectorSet] <Hashtable>]
    [-ResourceURI] <Uri>
    [-ApplicationName <String>]
    [-ComputerName <String>]
    [-FilePath <String>]
    [-OptionSet <Hashtable>]
    [-Port <Int32>]
    [-SessionOption <SessionOption>]
    [-UseSSL]
    [-ValueSet <Hashtable>]
    [-Credential <PSCredential>]
    [-Authentication <AuthenticationMechanism>]
    [-CertificateThumbprint <String>]
    [<CommonParameters>]

Description

Tato rutina je dostupná jenom na platformě Windows.

Spustí Invoke-WSManAction akci na objektu, který je určen RESOURCE_URI, kde parametry jsou určeny páry klíč hodnota.

Tato rutina ke spuštění akce používá vrstvu připojení nebo přenosu WSMan.

Příklady

Příklad 1: Vyvolání metody

Invoke-WSManAction -Action startservice -ResourceURI wmicimv2/win32_service  -SelectorSet @{name="spooler"} -Authentication default

xsi         : http://www.w3.org/2001/XMLSchema-instance
p           : http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service
cim         : http://schemas.dmtf.org/wbem/wscim/1/common
lang        : en-US
ReturnValue : 0

Tento příkaz volá metodu StartService instance třídy služby WMI Win32_Service, která odpovídá službě zařazování.

Vrácená hodnota označuje, jestli byla akce úspěšná. V tomto případě návratová hodnota 0 označuje úspěch. Vrácená hodnota 5 označuje, že služba je již spuštěna.

Příklad 2: Vyvolání metody

Invoke-WSManAction -Action stopservice -ResourceURI wmicimv2/Win32_Service -SelectorSet @{Name="spooler"} -FilePath:input.xml -Authentication default

xsi         : http://www.w3.org/2001/XMLSchema-instance
p           : http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service
cim         : http://schemas.dmtf.org/wbem/wscim/1/common
lang        : en-US
ReturnValue : 0

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

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

Příklad 3: Vyvolání metody se zadanými hodnotami parametrů

Invoke-WSManAction -Action create -ResourceURI wmicimv2/win32_process -ValueSet @{commandline="notepad.exe";currentdirectory="C:\"}

xsi         : http://www.w3.org/2001/XMLSchema-instance
p           : http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Process
cim         : http://schemas.dmtf.org/wbem/wscim/1/common
lang        : en-US
ProcessId   : 6356
ReturnValue : 0

Tento příkaz volá metodu Create třídy Win32_Process. Předá metodu dvě hodnoty Notepad.exe parametrů a C:\. V důsledku toho se vytvoří nový proces pro spuštění Poznámkového bloku a aktuální adresář nového procesu je nastaven na C:\.

Příklad 4: Vyvolání metody ve vzdáleném počítači

Invoke-WSManAction -Action startservice -ResourceURI wmicimv2/win32_service  -SelectorSet @{name="spooler"} -ComputerName server01 -Authentication default

xsi         : http://www.w3.org/2001/XMLSchema-instance
p           : http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service
cim         : http://schemas.dmtf.org/wbem/wscim/1/common
lang        : en-US
ReturnValue : 0

Tento příkaz volá metodu StartService instance třídy služby WMI Win32_Service, která odpovídá službě zařazování. Protože je zadaný parametr ComputerName, příkaz se spustí na vzdáleném počítači serveru01.

Vrácená hodnota označuje, jestli byla akce úspěšná. V tomto případě návratová hodnota 0 označuje úspěch. Vrácená hodnota 5 označuje, že služba je již spuštěna.

Parametry

-Action

Určuje metodu, která se má spustit na objektu správy určeném identifikátorem ResourceURI a selektory.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	1
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

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

Napří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 s Windows PowerShellem. V tomto případě služba IIS hostuje webové služby pro správu (WS-Management) kvůli efektivitě.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

ComputerName

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Authentication

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

• 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. Toto je výchozí hodnota.
• Digest – Digest je schéma výzvy a odpovědi, které používá datový řetězec určený serverem pro výzvu.
• 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 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.

Vlastnosti parametru

Typ:	AuthenticationMechanism
Default value:	None
Přípustné hodnoty:	None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	autentizace, ráno

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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 Get-Item nebo Get-ChildItem příkaz v jednotce Cert Windows PowerShellu:

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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 místního počítače, použijte localhost nebo použijte 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.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	cn

Sady parametrů

ComputerName

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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ý.

Vlastnosti parametru

Typ:	Uri
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	CURI, CU

Sady parametrů

URI

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Credential

Určuje uživatelský účet, který má oprávnění k provedení této akce. Výchozí hodnota je aktuální uživatel. Zadejte uživatelské jméno, například User01, Domain01\User01 nebo User@Domain.com. Nebo 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.

Vlastnosti parametru

Typ:	PSCredential
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	cred, c

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	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 Input.xmlobsahuje následující obsah:

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Cesta

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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, 2 a 3 pro parametry a, b a c:

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

Vlastnosti parametru

Typ:	Hashtable
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	OS

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	Int32
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

ComputerName

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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. Napří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

Vlastnosti parametru

Typ:	Uri
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Identifikátor rURI

Sady parametrů

(All)

Position:	0
Povinné:	True
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-SelectorSet

Určuje sadu párů hodnot, které se používají k výběru konkrétních instancí prostředků správy. SelectorSet se používá, pokud existuje více instancí prostředku. Hodnota SelectorSet musí být tabulka hash.

Následující příklad ukazuje, jak zadat hodnotu pro tento parametr:

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

Vlastnosti parametru

Typ:	Hashtable
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	2
Povinné:	False
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-SessionOption

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

Vlastnosti parametru

Typ:	SessionOption
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	tak

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-UseSSL

Určuje, že protokol SSL (Secure Sockets Layer) slouží 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 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.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

ComputerName

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ValueSet

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

Vlastnosti parametru

Typ:	Hashtable
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

None

Do tohoto cmdletu nemůžete předávat objekty.

Výstupy

XmlElement

Tato rutina vrátí výsledek operace jako objekt XmlElement .

Související odkazy

• Connect-WSMan
• Disable-WSManCredSSP
• Disconnect-WSMan (odhlásit WSMan)
• Enable-WSManCredSSP
• Get-WSManCredSSP
• Get-WSManInstance
• New-WSManInstance
• New-WSManSessionOption
• Remove-WSManInstance
• Set-WSManInstance
• Set-WSManQuickConfig
• Test-WSMan