Remove-CimInstance

Syntaxis

CimInstanceComputerSet (Standaard)

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

CimInstanceSessionSet

Remove-CimInstance
    [-InputObject] <CimInstance>
    -CimSession <CimSession[]>
    [-ResourceUri <Uri>]
    [-OperationTimeoutSec <UInt32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

QuerySessionSet

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

QueryComputerSet

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

Description

Voorbeelden

Voorbeeld 1: Het CIM-exemplaar verwijderen

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

Voorbeeld 2: Het CIM-exemplaar verwijderen met behulp van het CIM-exemplaarobject

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

Parameters

-CimSession

Voert de opdracht uit met behulp van de opgegeven CIM-sessie. Voer een variabele in die de CIM-sessie bevat of een opdracht waarmee de CIM-sessie wordt gemaakt of ophaalt, zoals de New-CimSession of Get-CimSession cmdlets. Zie about_CimSessionvoor meer informatie.

Parametereigenschappen

Parametersets

-ComputerName

Hiermee geeft u de naam van de computer waarop u de CIM-bewerking wilt uitvoeren. U kunt een FQDN (Fully Qualified Domain Name) of een NetBIOS-naam opgeven.

Als u deze parameter opgeeft, maakt de cmdlet een tijdelijke sessie naar de opgegeven computer met behulp van het WsMan-protocol.

Als u deze parameter niet opgeeft, voert de cmdlet de bewerking uit op de lokale computer met behulp van Component Object Model (COM).

Als er meerdere bewerkingen op dezelfde computer worden uitgevoerd, kunt u beter verbinding maken met een CIM-sessie.

Parametereigenschappen

Parametersets

-Confirm

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Parametersets

-InputObject

Hiermee geeft u een CIM-exemplaarobject dat moet worden verwijderd van de CIM-server. Het object dat aan de cmdlet wordt doorgegeven, wordt niet gewijzigd, alleen het exemplaar op de CIM-server wordt verwijderd.

De parameter InputObject inventariseert geen verzamelingen. Als een verzameling wordt doorgegeven, treedt er een fout op. Wanneer u met verzamelingen werkt, kunt u de invoer doorsluisen om de waarden op te sommen.

Parametereigenschappen

Parametersets

-Namespace

Hiermee geeft u de naamruimte voor de CIM-bewerking. De standaardnaamruimte is root/CIMV2-. U kunt tabvoltooiing gebruiken om door de lijst met naamruimten te bladeren, omdat PowerShell een lijst met naamruimten ophaalt van de lokale WMI-server om de lijst met naamruimten op te geven.

Parametereigenschappen

Parametersets

-OperationTimeoutSec

Hiermee geeft u de hoeveelheid tijd op die de cmdlet wacht op een reactie van de computer. De waarde van deze parameter is standaard 0, wat betekent dat de cmdlet de standaardtime-outwaarde voor de server gebruikt.

Als de parameter OperationTimeoutSec is ingesteld op een waarde die kleiner is dan de robuuste time-out voor opnieuw proberen van de verbinding van 3 minuten, kunnen netwerkfouten die meer duren dan de waarde van de parameter OperationTimeoutSec niet herstellen, omdat de bewerking op de server een time-out optreedt voordat de client opnieuw verbinding kan maken.

Parametereigenschappen

Parametersets

-Query

Hiermee geeft u een query die moet worden uitgevoerd op de CIM-server. U kunt het querydialect opgeven met behulp van de parameter QueryDialect.

Als de opgegeven waarde dubbele aanhalingstekens ("), enkele aanhalingstekens (') of een backslash (\) bevat, moet u deze tekens escapen door deze met het backslashteken (\) te voorzien. Als de opgegeven waarde gebruikmaakt van de operator WQL-LIKE, moet u de volgende tekens escapen door deze tussen vierkante haken ([]): percent (%), onderstrepingsteken (_) of vierkante haken ([) te sluiten.

Parametereigenschappen

Parametersets

-QueryDialect

Hiermee geeft u de querytaal op die wordt gebruikt voor de queryparameter. De acceptabele waarden voor deze parameter zijn: WQL of CQL. De standaardwaarde is WQL.

Parametereigenschappen

Parametersets

-ResourceUri

Geeft de resource-uniform resource identifier (URI) van de resourceklasse of instantie op. De URI wordt gebruikt om een specifiek type resource, zoals schijven of processen, op een computer te identificeren.

Een URI bestaat uit een voorvoegsel en een pad naar een resource. Voorbeeld:

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

Als u deze parameter niet opgeeft, wordt standaard de DMTF-standaardresource-URI http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ gebruikt en wordt de klassenaam eraan toegevoegd.

ResourceUri- kan alleen worden gebruikt met CIM-sessies die zijn gemaakt met het WSMan-protocol, of wanneer u de parameter ComputerName opgeeft, waarmee een CIM-sessie wordt gemaakt met WSMan. Als u deze parameter opgeeft zonder de parameter ComputerName op te geven of als u een CIM-sessie opgeeft die is gemaakt met behulp van het DCOM-protocol, krijgt u een foutmelding omdat het DCOM-protocol de ResourceUri parameter niet ondersteunt.

Als zowel de parameter ResourceUri als de parameter Filter zijn opgegeven, wordt de parameter Filter genegeerd.

Parametereigenschappen

Parametersets

-WhatIf

Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Parametereigenschappen

Parametersets

CommonParameters

Invoerwaarden

None

Uitvoerwaarden

None

Notities

Verwante koppelingen

• New-CimInstance
• Get-CimInstance
• Set-CimInstance