Remove-WSManInstance
Tar bort en hanteringsresursinstans.
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
Cmdleten Remove-WSManInstance
tar bort en instans av en hanteringsresurs som anges i parametrarna ResourceURI och SelectorSet .
Den här cmdleten använder WinRM-anslutningstransportlagret för att ta bort hanteringsresursinstansen.
Exempel
Exempel 1: Ta bort en lyssnare
Remove-WSManInstance -ResourceUri winrm/config/Listener -SelectorSet @{
Address = 'test.fabrikam.com'
Transport = 'http'
}
Det här kommandot tar bort HTTP-lyssnaren för WS-Management på en dator.
Parametrar
-ApplicationName
Anger programnamnet i anslutningen. Standardvärdet för parametern ApplicationName är WSMAN. Den fullständiga identifieraren för fjärrslutpunkten är i följande format:
<Transport>://<Server>:<Port>/<ApplicationName>
Till exempel: http://server01:8080/WSMAN
Internet Information Services (IIS), som är värd för sessionen, vidarebefordrar begäranden med den här slutpunkten till det angivna programmet. Den här standardinställningen för WSMAN är lämplig för de flesta användningsområden. Den här parametern är utformad för att användas om många datorer upprättar fjärranslutningar till en dator som kör Windows PowerShell. I det här fallet är IIS värd för Web Services for Management (WS-Management) för effektivitet.
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-Authentication
Anger den autentiseringsmekanism som ska användas på servern. De acceptabla värdena för den här parametern är:
Basic
– Basic är ett schema där användarnamnet och lösenordet skickas i klartext till servern eller proxyn.Default
– Använd autentiseringsmetoden som implementeras av WS-Management-protokollet. Det här är standardinställningen.Digest
– Sammandrag är ett utmaningssvarsschema som använder en server angiven datasträng för utmaningen.Kerberos
– Klientdatorn och servern autentiseras ömsesidigt med hjälp av Kerberos-certifikat.Negotiate
– Negotiate är ett utmaningssvarsschema som förhandlar med servern eller proxyn för att fastställa vilket schema som ska användas för autentisering. Det här parametervärdet gör det till exempel möjligt att förhandla för att avgöra om Kerberos-protokollet eller NTLM används.CredSSP
– Använd CredSSP-autentisering (CredSSP) som låter användaren delegera autentiseringsuppgifter. Det här alternativet är utformat för kommandon som körs på en fjärrdator men som samlar in data från eller kör ytterligare kommandon på andra fjärrdatorer.
Varning
CredSSP delegerar användarautentiseringsuppgifterna från den lokala datorn till en fjärrdator. Den här metoden ökar säkerhetsrisken för fjärråtgärden. Om fjärrdatorn komprometteras, när autentiseringsuppgifter skickas till den, kan autentiseringsuppgifterna användas för att styra nätverkssessionen.
Typ: | AuthenticationMechanism |
Alias: | auth, am |
Godkända värden: | None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-CertificateThumbprint
Anger det digitala offentliga nyckelcertifikatet (X509) för ett användarkonto som har behörighet att utföra den här åtgärden. Ange certifikatets tumavtryck.
Certifikat används i klientcertifikatbaserad autentisering. De kan endast mappas till lokala användarkonton. Certifikat fungerar inte med domänkonton.
Om du vill hämta ett tumavtryck för certifikatet Get-Item
använder du kommandot eller Get-ChildItem
på PowerShell-enheten Cert:
.
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-ComputerName
Anger den dator som hanteringsåtgärden ska köras mot. Värdet kan vara ett fullständigt kvalificerat domännamn, ett NetBIOS-namn eller en IP-adress. Använd namnet på den lokala datorn, använd localhost eller använd en punkt (.
) för att ange den lokala datorn. Den lokala datorn är standard. När fjärrdatorn finns i en annan domän än användaren måste du använda ett fullständigt domännamn. Du kan skicka ett värde för den här parametern till cmdleten.
Typ: | String |
Alias: | cn |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-ConnectionURI
Anger anslutningsslutpunkten. Formatet för den här strängen är följande:
<Transport>://<Server>:<Port>/<ApplicationName>
Följande sträng är ett korrekt formaterat värde för den här parametern:
http://Server01:8080/WSMAN
URI:n måste vara fullständigt kvalificerad.
Typ: | Uri |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-Credential
Anger ett användarkonto som har behörighet att utföra den här åtgärden. Standard är den aktuella användaren. Skriv ett användarnamn, till exempel User01
, Domain01\User01
eller User@Domain.com
. Eller ange ett PSCredential-objekt , till exempel ett som returneras av cmdleten Get-Credential
. När du skriver ett användarnamn uppmanas du att ange ett lösenord i den här cmdleten.
Typ: | PSCredential |
Alias: | cred, c |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | False |
-OptionSet
Anger en uppsättning växlar till en tjänst för att ändra eller förfina typen av begäran. Dessa liknar växlar som används i kommandoradsgränssnitt eftersom de är tjänstspecifika. Valfritt antal alternativ kan anges.
I följande exempel visas syntaxen som skickar värdena 1, 2 och 3 för parametrarna a, b och c:
-OptionSet @{a=1;b=2;c=3}
Typ: | Hashtable |
Alias: | os |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-Port
Anger den port som ska användas när klienten ansluter till WinRM-tjänsten. När transporten är HTTP är standardporten 80. När transporten är HTTPS är standardporten 443.
När du använder HTTPS som transport måste värdet för parametern ComputerName matcha serverns gemensamma certifikatnamn (CN). Men om parametern SkipCNCheck anges som en del av parametern SessionOption behöver inte serverns gemensamma certifikatnamn matcha serverns värdnamn. Parametern SkipCNCheck ska endast användas för betrodda datorer.
Typ: | Int32 |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-ResourceURI
Anger URI för resursklassen eller instansen. URI:n används för att identifiera en specifik typ av resurs, till exempel diskar eller processer, på en dator.
En URI består av ett prefix och en sökväg till en resurs. Till exempel:
http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk
http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_NumericSensor
Typ: | Uri |
Alias: | ruri |
Position: | 0 |
Standardvärde: | None |
Obligatorisk: | True |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-SelectorSet
Anger en uppsättning värdepar som används för att välja specifika hanteringsresursinstanser. Parametern SelectorSet används när det finns fler än en instans av resursen. Värdet för SelectorSet måste vara en hash-tabell.
I följande exempel visas hur du anger ett värde för den här parametern:
-SelectorSet @{Name="WinRM";ID="yyy"}
Typ: | Hashtable |
Position: | 1 |
Standardvärde: | None |
Obligatorisk: | True |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | False |
-SessionOption
Anger utökade alternativ för WS-Management-sessionen. Ange ett SessionOption-objekt som du skapar med hjälp av cmdleten New-WSManSessionOption. Om du vill ha mer information om de tillgängliga alternativen skriver du Get-Help New-WSManSessionOption
.
Typ: | SessionOption |
Alias: | so |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-UseSSL
Anger att SSL-protokollet (Secure Sockets Layer) används för att upprätta en anslutning till fjärrdatorn. Som standard används inte SSL.
WS-Management krypterar allt Windows PowerShell-innehåll som överförs via nätverket. Med parametern UseSSL kan du ange ytterligare skydd för HTTPS i stället för HTTP. Om SSL inte är tillgängligt på porten som används för anslutningen och du anger den här parametern misslyckas kommandot.
Typ: | SwitchParameter |
Alias: | ssl |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
Indata
None
Du kan inte skicka objekt till den här cmdleten.
Utdata
None
Den här cmdleten returnerar inga utdata.
Kommentarer
Cmdletarna i CimCmdlets-modulen liknar dem. De använder DCOM-anslutnings-/transportskiktet för att skapa eller uppdatera WMI-instanser.