Sdílet prostřednictvím

Remove-CimInstance

  • Reference
Modul:
CimCmdlets

Odebere instanci CIM z počítače.

Syntaxe

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

Tato rutina je dostupná jenom na platformě Windows.

Tato rutina odebere instanci CIM ze serveru CIM. Instanci CIM, kterou chcete odebrat, můžete zadat pomocí objektu instance CIM načteného rutinou Get-CimInstance nebo zadáním dotazu.

Pokud není zadaný parametr InputObject, rutina funguje jedním z následujících způsobů:

  • Pokud není zadán parametr ComputerName ani parametr CimSession, bude tato rutina fungovat v místní relaci rozhraní WMI (Windows Management Instrumentation) pomocí relace modelu COM (Component Object Model).
  • Pokud je zadán parametr ComputerName nebo parametr CimSession, bude tato rutina fungovat se serverem CIM zadaným parametrem ComputerName nebo parametrem CimSession.

Příklady

Příklad 1: Odebrání instance CIM

Tento příklad používá parametr query k odebrání instancí CIM z třídy pojmenované Win32_Environment, které začínají řetězcem znaků testvar .

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

Příklad 2: Odebrání instance CIM pomocí objektu instance CIM

Tento příklad načte objekty instance CIM filtrované pomocí parametru dotazu a uloží je do proměnné pojmenované $var pomocí rutiny Get-CimInstance. Obsah proměnné se pak předá rutině Remove-CimInstance, která odebere instance CIM.

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

Parametry

-CimSession

Spustí příkaz pomocí zadané relace CIM. Zadejte proměnnou, která obsahuje relaci CIM, nebo příkaz, který vytvoří nebo získá relaci CIM, například New-CimSession nebo Get-CimSession rutiny. Další informace naleznete v tématu about_CimSession.

Typ:CimSession[]
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ComputerName

Určuje název počítače, na kterém chcete spustit operaci CIM. Můžete zadat plně kvalifikovaný název domény (FQDN) nebo název rozhraní NetBIOS.

Pokud zadáte tento parametr, rutina vytvoří dočasnou relaci k zadanému počítači pomocí protokolu WsMan.

Pokud tento parametr nezadáte, rutina provede operaci na místním počítači pomocí modelu COM (Component Object Model).

Pokud se na stejném počítači provádí více operací, poskytuje připojení pomocí relace CIM lepší výkon.

Typ:String[]
Aliasy:CN, ServerName
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-InputObject

Určuje objekt instance CIM, který se má odebrat ze serveru CIM. Objekt předaný rutině se nezmění, odebere se pouze instance na serveru CIM.

Parametr InputObject nevypíše výčet kolekcí. Pokud je kolekce předána, vyvolá se chyba. Při prácisch

Typ:CimInstance
Aliasy:CimInstance
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Namespace

Určuje obor názvů pro operaci CIM. Výchozí obor názvů je root/cimv2. Pomocí dokončování tabulátoru můžete procházet seznam oborů názvů, protože PowerShell získá seznam oborů názvů z místního serveru WMI a poskytne seznam oborů názvů.

Typ:String
Position:2
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-OperationTimeoutSec

Určuje dobu, po kterou rutina čeká na odpověď z počítače. Ve výchozím nastavení je hodnota tohoto parametru 0, což znamená, že rutina používá výchozí hodnotu časového limitu pro server.

Pokud je parametr OperationTimeoutSec nastaven na hodnotu menší než robustní časový limit opakování připojení 3 minuty, selhání sítě, která trvala více než hodnota parametru OperationTimeoutSec, není možné obnovit, protože operace na serveru vyprší, než se klient může znovu připojit.

Typ:UInt32
Aliasy:OT
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Query

Určuje dotaz, který se má spustit na serveru CIM. Dialekt dotazu můžete zadat pomocí parametru QueryDialect.

Pokud zadaná hodnota obsahuje dvojité uvozovky ("), jednoduché uvozovky (') nebo zpětné lomítko (\), je nutné uvozit znaky předponou zpětného lomítka (\). Pokud zadaná hodnota používá operátor LIKE jazyka WQL, je nutné uvozit následující znaky tak, že je uzavřete do hranatých závorek ([]): percent (%), podtržítka (_) nebo levá hranatá závorka ([).

Typ:String
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-QueryDialect

Určuje dotazovací jazyk použitý pro parametr Dotazu. Přijatelné hodnoty pro tento parametr jsou: WQL nebo CQL. Výchozí hodnota je WQL.

Typ:String
Position:Named
Default value:WQL
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ResourceUri

Určuje identifikátor URI (Uniform Resource Identifier) prostředku třídy prostředků nebo instance. Identifikátor URI slouží k identifikaci konkrétního typu prostředku, jako jsou disky nebo procesy, v počítači.

Identifikátor URI se skládá z předpony a cesty k prostředku. Například:

  • http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk
  • http://intel.com/wbem/wscim/1/amt-schema/1/AMT_GeneralSettings

Pokud tento parametr nezadáte, použije se standardní identifikátor URI prostředku DMTF http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ a název třídy se k němu připojí.

Identifikátor ResourceURI lze použít pouze s relacemi CIM vytvořenými pomocí protokolu WSMan nebo při zadávání parametru ComputerName, který vytvoří relaci CIM pomocí WSManu. Pokud tento parametr zadáte bez zadání parametru ComputerName nebo zadáte relaci CIM vytvořenou pomocí protokolu DCOM, zobrazí se chyba, protože protokol DCOM nepodporuje parametr ResourceURI.

Pokud je zadán parametr ResourceUri i parametr Filter, bude parametr filtru ignorován.

Typ:Uri
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

None

Do této rutiny nemůžete roušit objekty.

Výstupy

None

Tato rutina nevrátí žádný výstup.

Poznámky

PowerShell obsahuje následující aliasy pro Remove-CimInstance:

  • Windows:
    • rcim

Tato rutina je dostupná jenom na platformách Windows.