Dela via

Remove-CimInstance

  • Referens
Modul:
CimCmdlets

Tar bort en CIM-instans från en dator.

Syntax

Remove-CimInstance
      [-ResourceUri <Uri>]
      [-ComputerName <String[]>]
      [-OperationTimeoutSec <UInt32>]
      [-InputObject] <CimInstance>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CimInstance
      -CimSession <CimSession[]>
      [-ResourceUri <Uri>]
      [-OperationTimeoutSec <UInt32>]
      [-InputObject] <CimInstance>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CimInstance
      -CimSession <CimSession[]>
      [[-Namespace] <String>]
      [-OperationTimeoutSec <UInt32>]
      [-Query] <String>
      [-QueryDialect <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CimInstance
      [-ComputerName <String[]>]
      [[-Namespace] <String>]
      [-OperationTimeoutSec <UInt32>]
      [-Query] <String>
      [-QueryDialect <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Den här cmdleten tar bort en CIM-instans från en CIM-server. Du kan ange den CIM-instans som du vill ta bort genom att antingen använda ett CIM-instansobjekt som hämtats av cmdleten Get-CimInstance eller genom att ange en fråga.

Om parametern InputObject inte anges fungerar cmdleten på något av följande sätt:

  • Om varken parametern ComputerName eller parametern CimSession anges, fungerar den här cmdleten på den lokala Windows Management Instrumentation (WMI) med hjälp av en COM-session (Component Object Model).
  • Om parametern ComputerName eller parametern CimSession anges, fungerar den här cmdleten mot den CIM-server som anges av parametern ComputerName eller parametern CimSession.

Exempel

Exempel 1: Ta bort CIM-instansen

I det här exemplet använder du parametern Query för att ta bort CIM-instanser från klassen med namnet Win32_Environment som börjar med teckensträngen testvar .

Remove-CimInstance -Query 'Select * from Win32_Environment where name LIKE "testvar%"'

Exempel 2: Ta bort CIM-instansen med CIM-instansobjektet

Det här exemplet hämtar CIM-instansobjekt som filtrerats efter parametern Query och lagrar dem i variabeln $var med hjälp av cmdleten Get-CimInstance. Innehållet i variabeln skickas sedan till cmdleten Remove-CimInstance som tar bort CIM-instanserna.

notepad.exe
$var = Get-CimInstance -Query 'Select * from Win32_Process where name LIKE "notepad%"'
Remove-CimInstance -InputObject $var

Parametrar

-CimSession

Kör kommandot med den angivna CIM-sessionen. Ange en variabel som innehåller CIM-sessionen eller ett kommando som skapar eller hämtar CIM-sessionen, till exempel cmdletarna New-CimSession eller Get-CimSession. Mer information finns i about_CimSession.

Typ:CimSession[]
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ComputerName

Anger namnet på den dator där du vill köra CIM-åtgärden. Du kan ange ett fullständigt kvalificerat domännamn (FQDN) eller ett NetBIOS-namn.

Om du anger den här parametern skapar cmdleten en tillfällig session till den angivna datorn med hjälp av WsMan-protokollet.

Om du inte anger den här parametern utför cmdleten åtgärden på den lokala datorn med hjälp av Komponentobjektmodell (COM).

Om flera åtgärder utförs på samma dator ger anslutning med en CIM-session bättre prestanda.

Typ:String[]
Alias:CN, ServerName
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-InputObject

Anger ett CIM-instansobjekt som ska tas bort från CIM-servern. Objektet som skickas till cmdleten ändras inte, bara instansen på CIM-servern tas bort.

Parametern InputObject räknas inte upp över samlingar. Om en samling skickas utlöses ett fel. När du arbetar med samlingar kan du skicka indata för att räkna upp värdena.

Typ:CimInstance
Alias:CimInstance
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Namespace

Anger namnområdet för CIM-åtgärden. Standardnamnområdet är root/cimv2. Du kan använda tabbavslut för att bläddra i listan över namnområden, eftersom PowerShell hämtar en lista över namnområden från den lokala WMI-servern för att tillhandahålla listan över namnområden.

Typ:String
Position:2
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-OperationTimeoutSec

Anger hur lång tid cmdleten väntar på ett svar från datorn. Som standard är värdet för den här parametern 0, vilket innebär att cmdleten använder standardvärdet för timeout för servern.

Om parametern OperationTimeoutSec anges till ett värde som är mindre än den robusta tidsgränsen för återförsök på 3 minuter kan nätverksfel som varar mer än värdet för parametern OperationTimeoutSec inte återställas eftersom åtgärden på servern överskrider tidsgränsen innan klienten kan återansluta.

Typ:UInt32
Alias:OT
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Query

Anger en fråga som ska köras på CIM-servern. Du kan ange frågedialekten med parametern QueryDialect.

Om det angivna värdet innehåller dubbla citattecken ("), enkla citattecken ('), eller ett omvänt snedstreck (\), måste du undvika dessa tecken genom att prefixera dem med tecknet omvänt snedstreck (\). Om det angivna värdet använder operatorn WQL LIKE måste du undvika följande tecken genom att omsluta dem inom hakparenteser ([]): percent (%), understreck (_), eller öppna hakparentes ([).

Typ:String
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-QueryDialect

Anger det frågespråk som används för frågeparametern. De godtagbara värdena för den här parametern är: WQL eller CQL. Standardvärdet är WQL.

Typ:String
Position:Named
Standardvärde:WQL
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ResourceUri

Anger resursens enhetliga resursidentifierare (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://intel.com/wbem/wscim/1/amt-schema/1/AMT_GeneralSettings

Om du inte anger den här parametern används som standard URI för DMTF-standardresursen http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ och klassnamnet läggs till i den.

ResourceURI kan endast användas med CIM-sessioner som skapats med hjälp av WSMan-protokollet, eller när du anger parametern ComputerName, som skapar en CIM-session med hjälp av WSMan. Om du anger den här parametern utan att ange parametern ComputerName, eller om du anger en CIM-session som skapats med DCOM-protokollet, får du ett fel eftersom DCOM-protokollet inte stöder parametern ResourceURI.

Om både parametern ResourceUri och parametern Filter anges ignoreras parametern Filter.

Typ:Uri
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
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.