Invoke-WSManAction

Modul:

Microsoft.WSMan.Management

Meghív egy műveletet az erőforrás URI-ja és a választók által megadott objektumon.

Syntax

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

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

Description

Ez a parancsmag csak a Windows platformon érhető el.

A Invoke-WSManAction a RESOURCE_URI által megadott objektumon futtat egy műveletet, ahol a paramétereket kulcsértékpárok határozzák meg.

Ez a parancsmag a WSMan kapcsolati/átviteli réteget használja a művelet futtatásához.

Példák

1. példa: Metódus meghívása

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

Ez a parancs meghívja a Spooler szolgáltatásnak megfelelő Win32_Service WMI-osztálypéldány StartService metódusát.

A visszatérési érték azt jelzi, hogy a művelet sikeres volt-e. Ebben az esetben a 0 visszatérési érték sikerességet jelez. Az 5-ös visszatérési érték azt jelzi, hogy a szolgáltatás már elindult.

2. példa: Metódus meghívása

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

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

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

3. példa: Metódus meghívása megadott paraméterértékekkel

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

Ez a parancs meghívja a Win32_Process osztály Create metódusát. Két paraméterértéket ad át a metódusnak, Notepad.exe és C:\. Ennek eredményeképpen egy új folyamat jön létre a Jegyzettömb futtatásához, és az új folyamat aktuális könyvtára C:\.

4. példa: Metódus meghívása távoli számítógépen

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

Ez a parancs meghívja a Spooler szolgáltatásnak megfelelő Win32_Service WMI-osztálypéldány StartService metódusát. Mivel a ComputerName paraméter meg van adva, a parancs a távoli kiszolgáló01 számítógépen fut.

A visszatérési érték azt jelzi, hogy a művelet sikeres volt-e. Ebben az esetben a 0 visszatérési érték sikerességet jelez. Az 5-ös visszatérési érték azt jelzi, hogy a szolgáltatás már elindult.

Paraméterek

-Action

Megadja a ResourceURI és a választók által megadott felügyeleti objektumon futtatandó metódust.

Típus:	String
Position:	1
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-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éldául:

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

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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 érték.
• 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 – Credential Security Support Provider (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.

Figyelmeztet

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.

Típus:	AuthenticationMechanism
Aliasok:	auth, am
Elfogadott értékek:	None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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 Windows PowerShell Cert: meghajtó Get-Item vagy Get-ChildItem parancsát.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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. Használja a helyi számítógép nevét, használja a localhost parancsot, vagy használjon egy pont (.) lehetőséget a helyi számítógép megadásához. 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.

Típus:	String
Aliasok:	cn
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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.

Típus:	Uri
Aliasok:	CURI, CU
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Credential

A művelet végrehajtásához engedéllyel rendelkező felhasználói fiókot ad meg. Az alapértelmezett az aktuális felhasználó. Írjon be egy felhasználónevet, például "User01", "Domain01\User01" vagy User@Domain.com. Vagy írjon be egy PSCredential objektumot, például a Get-Credential parancsmag által visszaadott objektumot. Amikor beír egy felhasználónevet, a rendszer kérni fogja a jelszót.

Típus:	PSCredential
Aliasok:	cred, c
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	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 Input.xmlfájl a következő tartalmat tartalmazza:

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

Típus:	String
Aliasok:	Path
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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 az a, b és c paraméterek 1, 2 és 3 értékeit adja át:

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

Típus:	Hashtable
Aliasok:	os
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	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ó.

Típus:	Int32
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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éldául:

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

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

Típus:	Uri
Aliasok:	ruri
Position:	0
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	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. SelectorSet akkor használatos, ha az erőforrás több példánya is létezik. A SelectorSet é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"}

Típus:	Hashtable
Position:	2
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	False

-SessionOption

A WS-Management munkamenet kibővített beállításait határozza meg. Adjon meg egy SessionOption objektumot, amelyet a New-WSManSessionOption parancsmaggal hoz létre. Az elérhető beállításokkal kapcsolatos további információkért lásd: New-WSManSessionOption.

Típus:	SessionOption
Aliasok:	so
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-UseSSL

Megadja, hogy a secure Sockets Layer (SSL) protokoll használatával létesítsen kapcsolatot a távoli számítógéppel. Alapértelmezés szerint az SSL nem használatos.

WS-Management titkosítja a hálózaton keresztül továbbított összes PowerShell-tartalmat. 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.

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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 és SelectorSet paraméterekkel adhatja meg. A ValueSet paraméter értékének kivonattáblának kell lennie.

Típus:	Hashtable
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

Bevitelek

None

Ehhez a parancsmaghoz nem lehet objektumokat csövezni.

Kimenetek

XmlElement

Ez a parancsmag XmlElement objektumként adja vissza a művelet eredményét.

Kapcsolódó hivatkozások

• Connect-WSMan
• Disable-WSManCredSSP
• Disconnect-WSMan
• Enable-WSManCredSSP
• Get-WSManCredSSP
• Get-WSManInstance
• New-WSManInstance
• New-WSManSessionOption
• Remove-WSManInstance
• Set-WSManInstance
• Set-WSManQuickConfig
• Test-WSMan