Set-WSManInstance
Hiermee wijzigt u de beheergegevens die betrekking hebben op een resource.
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
De Set-WSManInstance cmdlet wijzigt de beheergegevens die betrekking hebben op een resource.
Deze cmdlet maakt gebruik van de WinRM-verbindings-/transportlaag om de informatie te wijzigen.
Voorbeelden
Voorbeeld 1: Een listener uitschakelen op de lokale computer
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...}Met deze opdracht wordt de HTTPS-listener op de lokale computer uitgeschakeld.
Belangrijk
De parameter ValueSet is hoofdlettergevoelig wanneer deze overeenkomt met de opgegeven eigenschappen.
Bijvoorbeeld in deze opdracht:
Dit mislukt: -ValueSet @{enabled="False"}
Dit lukt: -ValueSet @{Enabled="False"}
Voorbeeld 2: Het maximale envelopformaat instellen op de lokale computer
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 : WinrsMet deze opdracht stelt u de waarde MaxEnvelopeSizekb in op 200 op de lokale computer.
Belangrijk
De parameter ValueSet is hoofdlettergevoelig wanneer deze overeenkomt met de opgegeven eigenschappen.
Gebruik bijvoorbeeld de bovenstaande opdracht.
Dit mislukt: -ValueSet @{MaxEnvelopeSizeKB ="200"}
Dit lukt: -ValueSet @{MaxEnvelopeSizekb ="200"}
Voorbeeld 3: Een listener uitschakelen op een externe computer
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...}Met deze opdracht wordt de HTTPS-listener op de externe computer SERVER02 uitgeschakeld.
Belangrijk
De parameter ValueSet is hoofdlettergevoelig wanneer deze overeenkomt met de opgegeven eigenschappen.
Gebruik bijvoorbeeld de bovenstaande opdracht.
Dit mislukt: -ValueSet @{enabled="False"}
Dit lukt: -ValueSet @{Enabled="False"}
Parameters
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>
Bijvoorbeeld:
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 is WSMAN geschikt voor de meeste toepassingen. Deze parameter is ontworpen om te worden gebruikt wanneer meerdere computers externe verbindingen tot stand brengen met één computer waarop Windows PowerShell wordt uitgevoerd. In dit geval host IIS Web Services for Management (WS-Management) voor efficiëntie.
| Type: | String |
| Position: | Named |
| Default value: | Wsman |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Hiermee geeft u het verificatiemechanisme op 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 wederzijds 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 worden uitgevoerd op één externe computer, maar gegevens verzamelen van of aanvullende opdrachten uitvoeren op andere externe computers.
Waarschuwing
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 is gecompromitteerd, kunnen de referenties worden gebruikt om de netwerksessie te beheren wanneer er referenties aan worden doorgegeven.
| Type: | Microsoft.WSMan.Management.AuthenticationMechanism |
| Aliases: | auth, am |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
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 opdracht of Get-ChildItem de Get-Item opdracht in het PowerShell-stationCert:.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
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 of localhosteen 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 |
| Aliases: | cn |
| Position: | Named |
| Default value: | Localhost |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Hiermee geeft u het verbindingseindpunt op. De indeling 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 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
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\User01of 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 |
| Aliases: | cred, c |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Hiermee geeft u het dialect te gebruiken in het filterpredicaat. Dit kan elk dialect zijn dat wordt ondersteund door de externe service. De volgende aliassen kunnen worden gebruikt voor de dialect-URI:
WQL:http://schemas.microsoft.com/wbem/wsman/1/WQLSelector:http://schemas.microsoft.com/wbem/wsman/1/wsman/SelectorFilterAssociation:http://schemas.dmtf.org/wbem/wsman/1/cimbinding/associationFilter
| Type: | Uri |
| Position: | Named |
| Default value: | http://schemas.microsoft.com/wbem/wsman/1/WQL |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
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 parameter ResourceURI 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 StopService-methode in de Spooler-service aangeroepen met behulp van invoer uit een bestand.
Het bestand Input.xml, bevat de volgende inhoud:
<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 |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Hiermee geeft u een sectie in het exemplaar op dat moet worden bijgewerkt of opgehaald voor de opgegeven bewerking. Als u bijvoorbeeld de status van een spoolerservice wilt ophalen, geeft u -Fragment Statusop.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Hiermee wordt een set switches doorgegeven aan een service om de aard van de aanvraag te wijzigen of te verfijnen. Deze zijn vergelijkbaar met schakelopties die worden gebruikt in opdrachtregelshells, omdat ze servicespecifiek zijn. Er kan een willekeurig aantal opties worden opgegeven.
In het volgende voorbeeld ziet u de syntaxis waarmee de waarden1, 2en 3 voor de baparameters en c parameters worden doorgegeven:
-OptionSet @{a=1;b=2;c=3}
| Type: | Hashtable |
| Aliases: | os |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
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 van het certificaat van de server (CN). Als de parameter SkipCNCheck echter is opgegeven als onderdeel van de parameter SessionOption , hoeft de algemene naam van het certificaat 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 |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
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. Bijvoorbeeld:
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 |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Hiermee geeft u een set waardeparen op die worden gebruikt om bepaalde beheerresource-exemplaren te selecteren. De parameter SelectorSet wordt gebruikt wanneer er meer dan één exemplaar van de resource bestaat. De waarde van de parameter 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: | 1 |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Hiermee definieert u een set uitgebreide opties voor de WS-Management sessie. Voer een SessionOption-object in dat u met de New-WSManSessionOption cmdlet maakt. Zie New-WSManSessionOption voor meer informatie over de beschikbare opties.
| Type: | Microsoft.WSMan.Management.SessionOption |
| Aliases: | so |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Hiermee geeft u op dat het SSL-protocol (Secure Sockets Layer) moet worden gebruikt om een verbinding met de externe computer tot stand te brengen. Standaard wordt SSL niet gebruikt.
WS-Management versleutelt alle Windows 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 |
| Aliases: | ssl |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Hiermee geeft u een hash-tabel op waarmee u een beheerresource kunt wijzigen. U geeft de beheerresource op met behulp van de parameter ResourceURI en de parameter SelectorSet . De waarde van de parameter ValueSet moet een hash-tabel zijn.
| Type: | Hashtable |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Invoerwaarden
None
Deze cmdlet accepteert geen invoer.
Uitvoerwaarden
None
Met deze cmdlet wordt geen uitvoer gegenereerd.
Verwante koppelingen
Feedback
Feedback verzenden en weergeven voor