Feedback

Remove-WSManInstance

  • Referentie
Module:
Microsoft.WSMan.Management

Hiermee verwijdert u een beheerresource-exemplaar.

Syntax

Remove-WSManInstance
      [-ApplicationName <String>]
      [-ComputerName <String>]
      [-OptionSet <Hashtable>]
      [-Port <Int32>]
      [-ResourceURI] <Uri>
      [-SelectorSet] <Hashtable>
      [-SessionOption <SessionOption>]
      [-UseSSL]
      [-Credential <PSCredential>]
      [-Authentication <AuthenticationMechanism>]
      [-CertificateThumbprint <String>]
      [<CommonParameters>]
Remove-WSManInstance
      [-ConnectionURI <Uri>]
      [-OptionSet <Hashtable>]
      [-ResourceURI] <Uri>
      [-SelectorSet] <Hashtable>
      [-SessionOption <SessionOption>]
      [-Credential <PSCredential>]
      [-Authentication <AuthenticationMechanism>]
      [-CertificateThumbprint <String>]
      [<CommonParameters>]

Description

Deze cmdlet is alleen beschikbaar op het Windows-platform.

De Remove-WSManInstance cmdlet verwijdert een exemplaar van een beheerresource die is opgegeven in de parameters ResourceURI en SelectorSet .

Deze cmdlet maakt gebruik van de WinRM-verbindings-/transportlaag om het beheerresource-exemplaar te verwijderen.

Voorbeelden

Voorbeeld 1: Een listener verwijderen

Remove-WSManInstance -ResourceUri winrm/config/Listener -SelectorSet Address=test.fabrikam.com;Transport=http

Met deze opdracht verwijdert u de WS-Management HTTP-listener op een computer.

Parameters

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

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 van WSMAN is geschikt voor de meeste toepassingen. Deze parameter is ontworpen om te worden gebruikt als veel 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:None
Accept pipeline input:False
Accept wildcard characters:False
-Authentication

Hiermee geeft u het verificatiemechanisme op dat moet worden gebruikt op de server. De aanvaardbare waarden voor deze parameter 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 - Samenvatting 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 kan bijvoorbeeld worden onderhandeld of het Kerberos-protocol of NTLM wordt gebruikt.
  • CredSSP - Verificatie van referentiebeveiligingsondersteuningsprovider (CredSSP) gebruiken, 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 gebruikersreferenties 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
Accepted values:None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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 opdracht Get-Item of Get-ChildItem in het station Windows PowerShell Certificaat: station.

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

Hiermee geeft u de computer waarmee de beheerbewerking moet worden uitgevoerd. 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
Aliases:cn
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ConnectionURI

Hiermee geeft u het verbindingseindpunt op. De indeling van deze tekenreeks is als volgt:

<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
-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\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 met deze cmdlet gevraagd om een wachtwoord.

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

Hiermee geeft u een set switches naar een service om de aard van de aanvraag te wijzigen of te verfijnen. Deze lijken op 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 die de waarden 1, 2 en 3 doorgeeft voor de parameters a, b en c:

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

Type:Hashtable
Aliases:os
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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 de servercertificaat. 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 computers.

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

Hiermee geeft u de URI van de resourceklasse of het exemplaar op. 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 van 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
-SelectorSet

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

Hiermee geeft u uitgebreide opties voor de WS-Management sessie. Voer een SessionOption-object in dat u maakt met behulp van de New-WSManSessionOption cmdlet. Typ voor meer informatie over de beschikbare Get-Help New-WSManSessionOptionopties.

Type:Microsoft.WSMan.Management.SessionOption
Aliases:so
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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 alle Windows PowerShell inhoud versleutelt 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

Invoerwaarden

None

Deze cmdlet accepteert geen invoer.

Uitvoerwaarden

None

Met deze cmdlet wordt geen uitvoer gegenereerd.

Notities

De cmdlets in de CimCmdlets-module zijn vergelijkbaar. Ze gebruiken de DCOM-verbindings-/transportlaag om WMI-exemplaren te maken of bij te werken.