Invoke-WSManAction

Module:

Microsoft.WSMan.Management

Roept een actie aan op het object dat is opgegeven door de resource-URI en door de selectors.

Syntaxis

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

Deze cmdlet is alleen beschikbaar op het Windows-platform.

Er Invoke-WSManAction wordt een actie uitgevoerd op het object dat is opgegeven door RESOURCE_URI, waarbij parameters worden opgegeven door sleutel-waardeparen.

Deze cmdlet maakt gebruik van de WSMan-verbindings-/transportlaag om de actie uit te voeren.

Voorbeelden

Voorbeeld 1: Een methode aanroepen

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

Met deze opdracht wordt de StartService-methode aangeroepen van het Win32_Service WMI-klasse-exemplaar dat overeenkomt met de Spooler-service.

De retourwaarde geeft aan of de actie is geslaagd. In dit geval geeft een retourwaarde van 0 aan dat de waarde is geslaagd. Een retourwaarde van 5 geeft aan dat de service al is gestart.

Voorbeeld 2: Een methode aanroepen

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

Met deze opdracht wordt de Methode StopService in de Spooler-service aangeroepen met behulp van invoer uit een bestand. Het bestand bevat Input.xmlde volgende inhoud:

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

Voorbeeld 3: Een methode aanroepen met opgegeven parameterwaarden

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

Met deze opdracht wordt de methode Create van de klasse Win32_Process aangeroepen. Hiermee worden de methode twee parameterwaarden doorgegeven, Notepad.exe en C:\. Als gevolg hiervan wordt een nieuw proces gemaakt om Kladblok uit te voeren en wordt de huidige map van het nieuwe proces ingesteld op C:\.

Voorbeeld 4: Een methode aanroepen op een externe computer

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

Met deze opdracht wordt de StartService-methode aangeroepen van het Win32_Service WMI-klasse-exemplaar dat overeenkomt met de Spooler-service. Omdat de parameter ComputerName is opgegeven, wordt de opdracht uitgevoerd op de externe server01-computer.

De retourwaarde geeft aan of de actie is geslaagd. In dit geval geeft een retourwaarde van 0 aan dat de waarde is geslaagd. Een retourwaarde van 5 geeft aan dat de service al is gestart.

Parameters

-Action

Hiermee geeft u de methode op die moet worden uitgevoerd op het beheerobject dat is opgegeven door de ResourceURI en selectors.

Type:	String
Position:	1
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ApplicationName

Hiermee geeft u de naam van de toepassing in de verbinding. De standaardwaarde van de parameter ApplicationName is WSMAN. De volledige id voor het externe eindpunt heeft de volgende indeling:

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

Voorbeeld:

http://server01:8080/WSMAN

Internet Information Services (IIS), die als host fungeert voor de sessie, stuurt aanvragen met dit eindpunt door naar de opgegeven toepassing. Deze standaardinstelling van WSMAN is geschikt voor de meeste toepassingen. Deze parameter is ontworpen om te worden gebruikt wanneer meerdere computers externe verbindingen tot stand brengen met één computer met Windows PowerShell. In dit geval host IIS Web Services for Management (WS-Management) voor efficiëntie.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Authentication

Hiermee geeft u het verificatiemechanisme dat moet worden gebruikt op de server. Mogelijke waarden zijn:

• Basic - Basic is een schema waarin de gebruikersnaam en het wachtwoord in duidelijke tekst naar de server of proxy worden verzonden.
• Default - Gebruik de verificatiemethode die is geïmplementeerd door het WS-Management-protocol. Dit is de standaardinstelling.
• Digest - Digest is een challenge-response-schema dat gebruikmaakt van een door de server opgegeven gegevensreeks voor de uitdaging.
• Kerberos - De clientcomputer en de server verifiëren elkaar met behulp van Kerberos-certificaten.
• Negotiate - Onderhandelen is een challenge-response-schema dat onderhandelt met de server of proxy om het schema te bepalen dat moet worden gebruikt voor verificatie. Met deze parameterwaarde kunt u bijvoorbeeld onderhandelen om te bepalen of het Kerberos-protocol of NTLM wordt gebruikt.
• CredSSP - Gebruik CredSSP-verificatie (Credential Security Support Provider), waarmee de gebruiker referenties kan delegeren. Deze optie is ontworpen voor opdrachten die op één externe computer worden uitgevoerd, maar gegevens verzamelen van of aanvullende opdrachten uitvoeren op andere externe computers.

Let op

CredSSP delegeert de referenties van de gebruiker van de lokale computer naar een externe computer. Deze praktijk verhoogt het beveiligingsrisico van de externe bewerking. Als de externe computer wordt aangetast, kunnen de referenties worden gebruikt om de netwerksessie te beheren wanneer er referenties aan worden doorgegeven.

Type:	AuthenticationMechanism
Aliassen:	auth, am
Geaccepteerde waarden:	None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-CertificateThumbprint

Hiermee geeft u het certificaat van de digitale openbare sleutel (X509) van een gebruikersaccount dat gemachtigd is om deze actie uit te voeren. Voer de vingerafdruk van het certificaat in.

Certificaten worden gebruikt in verificatie op basis van clientcertificaten. Ze kunnen alleen worden toegewezen aan lokale gebruikersaccounts; ze werken niet met domeinaccounts.

Als u een vingerafdruk van een certificaat wilt ophalen, gebruikt u de Get-Item of Get-ChildItem opdracht in het Windows PowerShell-certificaat: station.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ComputerName

Hiermee geeft u de computer waarop u de beheerbewerking wilt uitvoeren. De waarde kan een volledig gekwalificeerde domeinnaam, een NetBIOS-naam of een IP-adres zijn. Gebruik de naam van de lokale computer, gebruik localhost of gebruik een punt (.) om de lokale computer op te geven. De lokale computer is de standaardinstelling. Wanneer de externe computer zich in een ander domein bevindt dan de gebruiker, moet u een volledig gekwalificeerde domeinnaam gebruiken. U kunt een waarde voor deze parameter doorsluisen naar de cmdlet.

Type:	String
Aliassen:	cn
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ConnectionURI

Hiermee geeft u het verbindingseindpunt op. De notatie van deze tekenreeks is:

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

De volgende tekenreeks is een correct opgemaakte waarde voor deze parameter:

http://Server01:8080/WSMAN

De URI moet volledig gekwalificeerd zijn.

Type:	Uri
Aliassen:	CURI, CU
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Credential

Hiermee geeft u een gebruikersaccount op dat gemachtigd is om deze actie uit te voeren. Standaard is dit de huidige gebruiker. Typ een gebruikersnaam, zoals 'User01', 'Domain01\User01', of User@Domain.com. U kunt ook een PSCredential-object invoeren, zoals een object dat wordt geretourneerd door de Get-Credential cmdlet. Wanneer u een gebruikersnaam typt, wordt u gevraagd om een wachtwoord.

Type:	PSCredential
Aliassen:	cred, c
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-FilePath

Hiermee geeft u het pad op van een bestand dat wordt gebruikt om een beheerresource bij te werken. U geeft de beheerresource op met behulp van de resourceURI-parameter en de parameter SelectorSet. Met de volgende opdracht wordt bijvoorbeeld de parameter FilePath gebruikt:

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

Met deze opdracht wordt de Methode StopService in de Spooler-service aangeroepen met behulp van invoer uit een bestand. Het bestand bevat Input.xmlde volgende inhoud:

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

Type:	String
Aliassen:	Path
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-OptionSet

Hiermee wordt een set switches doorgegeven aan een service om de aard van de aanvraag te wijzigen of te verfijnen. Deze zijn vergelijkbaar met switches die worden gebruikt in opdrachtregelshells omdat ze specifiek zijn voor de service. U kunt een willekeurig aantal opties opgeven.

In het volgende voorbeeld ziet u de syntaxis die de waarden 1, 2 en 3 doorgeeft voor de parameters a, b en c:

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

Type:	Hashtable
Aliassen:	os
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Port

Hiermee geeft u de poort op die moet worden gebruikt wanneer de client verbinding maakt met de WinRM-service. Wanneer het transport HTTP is, is de standaardpoort 80. Wanneer het transport HTTPS is, is de standaardpoort 443. Wanneer u HTTPS als transport gebruikt, moet de waarde van de parameter ComputerName overeenkomen met de algemene naam (CN) van het certificaat van de server. Als de parameter SkipCNCheck echter is opgegeven als onderdeel van de parameter SessionOption, hoeft de algemene certificaatnaam van de server niet overeen te komen met de hostnaam van de server. De parameter SkipCNCheck mag alleen worden gebruikt voor vertrouwde machines.

Type:	Int32
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ResourceURI

Bevat de URI (Uniform Resource Identifier) van de resourceklasse of het exemplaar. De URI wordt gebruikt om een specifiek type resource, zoals schijven of processen, op een computer te identificeren.

Een URI bestaat uit een voorvoegsel en een pad naar een resource. Voorbeeld:

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
Aliassen:	ruri
Position:	0
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-SelectorSet

Hiermee geeft u een set waardeparen op die worden gebruikt om bepaalde beheerresource-exemplaren te selecteren. SelectorSet wordt gebruikt wanneer er meer dan één exemplaar van de resource bestaat. De waarde van SelectorSet moet een hash-tabel zijn.

In het volgende voorbeeld ziet u hoe u een waarde voor deze parameter invoert:

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

Type:	Hashtable
Position:	2
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-SessionOption

Definieert een set uitgebreide opties voor de WS-Management-sessie. Voer een SessionOption-object in dat u maakt met behulp van de New-WSManSessionOption cmdlet. Zie voor meer informatie over de beschikbare opties New-WSManSessionOption.

Type:	SessionOption
Aliassen:	so
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-UseSSL

Hiermee geeft u op dat het SSL-protocol (Secure Sockets Layer) wordt gebruikt om een verbinding met de externe computer tot stand te brengen. Standaard wordt SSL niet gebruikt.

WS-Management versleutelt alle PowerShell-inhoud die via het netwerk wordt verzonden. Met de parameter UseSSL kunt u de extra beveiliging van HTTPS opgeven in plaats van HTTP. Als SSL niet beschikbaar is op de poort die wordt gebruikt voor de verbinding en u deze parameter opgeeft, mislukt de opdracht.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ValueSet

Hiermee geeft u een hash-tabel op waarmee u een beheerresource kunt wijzigen. U geeft de beheerresource op met behulp van de parameters ResourceURI en SelectorSet . De waarde van de parameter ValueSet moet een hash-tabel zijn.

Type:	Hashtable
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

Invoerwaarden

None

U kunt geen objecten doorsluisen naar deze cmdlet.

Uitvoerwaarden

XmlElement

Deze cmdlet retourneert het resultaat van de bewerking als een XmlElement-object .

Verwante koppelingen

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