Remove-CimInstance
Odebere instanci CIM z počítače.
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
Tato rutina je dostupná jenom na platformě Windows.
Tato rutina odebere instanci CIM ze serveru CIM. Instanci CIM, kterou chcete odebrat, můžete zadat buď 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, tato rutina funguje v místní službě WMI (Windows Management Instrumentation) pomocí relace modelu COM (Component Object Model).
- Pokud je zadán parametr ComputerName nebo parametr CimSession, tato rutina pracuje se serverem CIM určený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 s názvem Win32_Environment , které začínají znakem string 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 Query 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 rutinyNew-CimSession
.Get-CimSession
Další informace najdete v tématu about_CimSession.
Type: | CimSession[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | String[] |
Aliases: | CN, ServerName |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Před spuštěním rutiny zobrazí výzvu k potvrzení.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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
Type: | CimInstance |
Aliases: | CimInstance |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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ů.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-OperationTimeoutSec
Určuje dobu, po kterou rutina čeká na odpověď z počítače. Ve výchozím nastavení je 0
hodnota tohoto parametru , 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, chyby sítě, které trvaly více než hodnota parametru OperationTimeoutSec, se nedají obnovit, protože operace na serveru vyprší, než se klient může znovu připojit.
Type: | UInt32 |
Aliases: | OT |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 (\
), musíte tyto znaky uvozit před znakem zpětného lomítka (\
). Pokud zadaná hodnota používá operátor WQLLIKE
, musíte uvozit následující znaky tak, že je uzavřete do hranatých závorek (): percent ([]
), podtržítko (%
_
) nebo levá hranatá závorka ([
).
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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
.
Type: | String |
Position: | Named |
Default value: | WQL |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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. Pří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 http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/
prostředku DMTF 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, parametr Filter se ignoruje.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Související odkazy
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro