Share via

Remove-CimInstance

  • Referencia
Modul:
CimCmdlets

Eltávolít egy CIM-példányt a számítógépről.

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

Ez a parancsmag csak a Windows platformon érhető el.

Ez a parancsmag eltávolít egy CIM-példányt egy CIM-kiszolgálóról. Megadhatja az eltávolítandó CIM-példányt a parancsmag által Get-CimInstance lekért CIM-példányobjektum használatával, vagy egy lekérdezés megadásával.

Ha az InputObject paraméter nincs megadva, a parancsmag az alábbi módok egyikével működik:

  • Ha sem a ComputerName paraméter, sem a CimSession paraméter nincs megadva, akkor ez a parancsmag a helyi Windows Management Instrumentation (WMI) rendszeren működik egy komponensobjektum-modell (COM) munkamenettel.
  • Ha a ComputerName paraméter vagy a CimSession paraméter van megadva, akkor ez a parancsmag a ComputerName vagy a CimSession paraméter által megadott CIM-kiszolgálóval működik.

Példák

1. példa: A CIM-példány eltávolítása

Ez a példa a Query paraméterrel távolítja el a CIM-példányokat a Win32_Environment nevű osztályból, amely a karaktersztring-tesztvarral kezdődik.

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

2. példa: A CIM-példány eltávolítása CIM-példányobjektum használatával

Ez a példa lekéri a Lekérdezés paraméter által szűrt CIM-példányobjektumokat, és a Get-CimInstance parancsmag használatával elnevezett $var változóban tárolja őket. Ezt követően a rendszer átadja a változó tartalmát a Remove-CimInstance parancsmagnak, amely eltávolítja a CIM-példányokat.

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

Paraméterek

-CimSession

A parancsot a megadott CIM-munkamenet használatával futtatja. Adjon meg egy változót, amely tartalmazza a CIM-munkamenetet, vagy egy parancsot, amely létrehozza vagy lekéri a CIM-munkamenetet, például a New-CimSession parancsmagokat.Get-CimSession További információ: about_CimSession.

Type:CimSession[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ComputerName

Megadja annak a számítógépnek a nevét, amelyen futtatni szeretné a CIM-műveletet. Megadhat teljes tartománynevet (FQDN) vagy NetBIOS-nevet.

Ha megadja ezt a paramétert, a parancsmag létrehoz egy ideiglenes munkamenetet a megadott számítógépen a WsMan protokoll használatával.

Ha nem adja meg ezt a paramétert, a parancsmag a helyi számítógépen hajtja végre a műveletet a Component Object Model (COM) használatával.

Ha ugyanazon a számítógépen több műveletet végeznek, a CIM-munkamenet használatával való csatlakozás jobb teljesítményt nyújt.

Type:String[]
Aliases:CN, ServerName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Megadja a CIM-kiszolgálóról eltávolítandó CIM-példányobjektumot. A parancsmagnak átadott objektum nem módosul, csak a CIM-kiszolgálón lévő példány lesz eltávolítva.

Az InputObject paraméter nem számba veszi a gyűjteményeket. Ha egy gyűjteményt ad át, hibaüzenet jelenik meg. A gyűjtemények használatakor a bemenetet a bemenetet az értékek számbavételéhez kell beszűkíteni.

Type:CimInstance
Aliases:CimInstance
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Namespace

Megadja a CIM-művelet névterét. Az alapértelmezett névtér a következő root/cimv2: . A tabulátorkiegészítéssel tallózhat a névterek listájában, mivel a PowerShell lekéri a névterek listáját a helyi WMI-kiszolgálóról a névterek listájának megadásához.

Type:String
Position:2
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-OperationTimeoutSec

Megadja, hogy a parancsmag mennyi időt vár a számítógép válaszára. Alapértelmezés szerint ennek a paraméternek az értéke, 0ami azt jelenti, hogy a parancsmag a kiszolgáló alapértelmezett időtúllépési értékét használja.

Ha az OperationTimeoutSec paraméter értéke kisebb, mint a robusztus kapcsolat újrapróbálkozási időtúllépése 3 perc, akkor az OperationTimeoutSec paraméter értékénél hosszabb hálózati hibák nem állíthatók helyre, mert a kiszolgálón végzett művelet túllépi az időkorlátot, mielőtt az ügyfél újracsatlakozhat.

Type:UInt32
Aliases:OT
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Query

A CIM-kiszolgálón futtatandó lekérdezést adja meg. A lekérdezés dialektusát a QueryDialect paraméterrel adhatja meg.

Ha a megadott érték dupla idézőjeleket (), egyszeri idézőjeleket ("') vagy fordított perjelet (\) tartalmaz, ezeket a karaktereket a fordított perjel (\) karakter előtagjával kell feloldani. Ha a megadott érték a WQL LIKE operátort használja, akkor a következő karaktereket szögletes zárójelek (): százalék ([]), aláhúzás (%_) vagy nyitó szögletes zárójel ([) közé kell foglalnia.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-QueryDialect

A Lekérdezés paraméterhez használt lekérdezési nyelvet adja meg. A paraméter elfogadható értékei a következők: WQL vagy CQL. Az alapértelmezett érték WQL.

Type:String
Position:Named
Default value:WQL
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceUri

Az erőforrásosztály vagy -példány erőforrás-egységes erőforrás-azonosítóját (URI) adja meg. Az URI egy adott típusú erőforrás, például lemezek vagy folyamatok azonosítására szolgál a számítógépen.

Az URI egy előtagból és egy erőforrás elérési útból áll. Példa:

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

Alapértelmezés szerint, ha nem adja meg ezt a paramétert, a rendszer a DMTF standard erőforrás-URI-t http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ használja, és hozzáfűzi az osztály nevét.

A ResourceURI csak a WSMan protokollal létrehozott CIM-munkamenetekkel használható, vagy a ComputerName paraméter megadásakor, amely a WSMan használatával hoz létre CIM-munkamenetet. Ha ezt a paramétert a ComputerName paraméter megadása nélkül adja meg, vagy ha egy DCOM protokoll használatával létrehozott CIM-munkamenetet ad meg, hibaüzenet jelenik meg, mert a DCOM protokoll nem támogatja a ResourceURI paramétert.

Ha a ResourceUri paraméter és a Szűrő paraméter is meg van adva, a szűrő paraméter figyelmen kívül lesz hagyva.

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Bevitelek

None

Ehhez a parancsmaghoz nem lehet objektumokat csövezni.

Kimenetek

None

Ez a parancsmag nem ad vissza kimenetet.

Jegyzetek

A PowerShell a következő aliasokat Remove-CimInstancetartalmazza:

  • Windows:
    • rcim

Ez a parancsmag csak Windows-platformokon érhető el.