Freigeben über

Remove-CimInstance

  • Referenz
Modul:
CimCmdlets

Entfernt eine CIM-Instanz von einem Computer.

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>]

Beschreibung

Dieses Cmdlet ist nur auf der Windows-Plattform verfügbar.

Mit diesem Cmdlet wird eine CIM-Instanz von einem CIM-Server entfernt. Sie können die ZU entfernende CIM-Instanz angeben, indem Sie entweder ein VOM Cmdlet abgerufenes Get-CimInstance CIM-Instanzobjekt oder eine Abfrage angeben.

Wenn der InputObject-Parameter nicht angegeben ist, funktioniert das Cmdlet auf eine der folgenden Arten:

  • Wenn weder der Parameter ComputerName noch der CimSession-Parameter angegeben ist, funktioniert dieses Cmdlet unter Verwendung einer COM-Sitzung (Component Object Model) für die lokale Windows-Verwaltungsinstrumentation (Windows Management Instrumentation, WMI).
  • Wenn entweder der Parameter ComputerName oder der CimSession-Parameter angegeben ist, funktioniert dieses Cmdlet mit dem CIM-Server, der entweder durch den ComputerName-Parameter oder den CimSession-Parameter angegeben wird.

Beispiele

Beispiel 1: Entfernen der CIM-Instanz

In diesem Beispiel wird der Query-Parameter verwendet, um CIM-Instanzen aus der Klasse mit dem Namen Win32_Environment zu entfernen, die mit dem Zeichenfolgentestvar beginnen.

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

Beispiel 2: Entfernen der CIM-Instanz mithilfe des CIM-Instanzobjekts

In diesem Beispiel werden die CIM-Instanzobjekte abgerufen, die nach dem Query-Parameter gefiltert werden, und sie werden mithilfe des Get-CimInstance Cmdlets in variabler Namen $var gespeichert. Der Inhalt der Variablen wird dann an das Remove-CimInstance Cmdlet übergeben, wodurch die CIM-Instanzen entfernt werden.

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

Parameter

-CimSession

Führt den Befehl mithilfe der angegebenen CIM-Sitzung aus. Geben Sie eine Variable ein, die die CIM-Sitzung enthält, oder einen Befehl, der die CIM-Sitzung erstellt oder abruft, z. B. die New-CimSession Oder Get-CimSession Cmdlets. Weitere Informationen finden Sie unter about_CimSession.

Typ:CimSession[]
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ComputerName

Gibt den Namen des Computers an, auf dem Der CIM-Vorgang ausgeführt werden soll. Sie können einen vollqualifizierten Domänennamen (FQDN) oder einen NetBIOS-Namen angeben.

Wenn Sie diesen Parameter angeben, erstellt das Cmdlet mithilfe des WsMan-Protokolls eine temporäre Sitzung auf dem angegebenen Computer.

Wenn Sie diesen Parameter nicht angeben, führt das Cmdlet den Vorgang auf dem lokalen Computer mithilfe des Component Object Model (COM) aus.

Wenn mehrere Vorgänge auf demselben Computer ausgeführt werden, bietet die Verbindung mit einer CIM-Sitzung eine bessere Leistung.

Typ:String[]
Aliase:CN, ServerName
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Gibt ein CIM-Instanzobjekt an, das vom CIM-Server entfernt werden soll. Das an das Cmdlet übergebene Objekt wird nicht geändert, nur die Instanz auf dem CIM-Server wird entfernt.

Der InputObject-Parameter enumeriert keine Auflistungen. Wenn eine Auflistung übergeben wird, wird ein Fehler ausgelöst. Wenn Sie mit Sammlungen arbeiten, führen Sie die Eingabe weiter, um die Werte aufzählen zu können.

Typ:CimInstance
Aliase:CimInstance
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Namespace

Gibt den Namespace für den CIM-Vorgang an. Der Standardnamespace ist root/cimv2. Sie können die Registerkartenabschluss verwenden, um die Liste der Namespaces zu durchsuchen, da PowerShell eine Liste von Namespaces vom lokalen WMI-Server abruft, um die Liste der Namespaces bereitzustellen.

Typ:String
Position:2
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-OperationTimeoutSec

Gibt die Zeitspanne an, die das Cmdlet auf eine Antwort vom Computer wartet. Standardmäßig lautet 0der Wert dieses Parameters , was bedeutet, dass das Cmdlet den Standardtimeoutwert für den Server verwendet.

Wenn der Parameter OperationTimeoutSec auf einen Wert festgelegt ist, der kleiner als das robuste Verbindungsretrytimeout von 3 Minuten ist, können Netzwerkfehler, die mehr als der Wert des OperationTimeoutSec-Parameters dauern, nicht wiederhergestellt werden, da der Vorgang auf dem Server zu einem Timeout vor dem erneuten Herstellen der Verbindung führen kann.

Typ:UInt32
Aliase:OT
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Query

Gibt eine Abfrage an, die auf dem CIM-Server ausgeführt werden soll. Sie können den Abfragedialekt mithilfe des QueryDialect-Parameters angeben.

Wenn der angegebene Wert doppelte Anführungszeichen ("), einfache Anführungszeichen (') oder einen umgekehrten Schrägstrich (\) enthält, müssen Sie diese Zeichen escapen, indem Sie sie dem umgekehrten Schrägstrich (\) voranstellen. Wenn der angegebene Wert den WQL-Operator LIKE verwendet, müssen Sie die folgenden Zeichen escapen, indem Sie sie in eckige Klammern ([]): Prozent (%), Unterstrich (_) oder öffnende eckige Klammer ([) einschließen.

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-QueryDialect

Gibt die Abfragesprache an, die für den Abfrageparameter verwendet wird. Die zulässigen Werte für diesen Parameter sind: WQL oder CQL. Der Standardwert ist WQL.

Typ:String
Position:Named
Standardwert:WQL
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ResourceUri

Gibt den URI (Uniform Resource Identifier) der Ressourcenklasse oder -instanz an. Der URI wird verwendet, um einen bestimmten Ressourcentyp auf einem Computer zu identifizieren, z. B. Datenträger oder Prozesse.

Ein URI besteht aus einem Präfix und einem Pfad zu einer Ressource. Zum Beispiel:

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

Wenn Sie diesen Parameter nicht angeben, wird standardmäßig der DMTF-Standardressourcen-URI http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ verwendet, und der Klassenname wird an ihn angefügt.

ResourceURI kann nur mit CIM-Sitzungen verwendet werden, die mit dem WSMan-Protokoll erstellt wurden, oder beim Angeben des ComputerName-Parameters, der eine CIM-Sitzung mit WSMan erstellt. Wenn Sie diesen Parameter ohne Angabe des ComputersName-Parameters angeben oder eine MIT DCOM-Protokoll erstellte CIM-Sitzung angeben, wird ein Fehler angezeigt, da das DCOM-Protokoll den ResourceURI-Parameter nicht unterstützt.

Wenn sowohl der Parameter "ResourceUri" als auch der Parameter "Filter" angegeben werden, wird der Parameter "Filter" ignoriert.

Typ:Uri
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Sie können keine Objekte an dieses Cmdlet weiterleiten.

Ausgaben

None

Dieses Cmdlet gibt keine Ausgabe zurück.

Hinweise

PowerShell enthält die folgenden Aliase für Remove-CimInstance:

  • Windows:
    • rcim

Dieses Cmdlet ist nur auf Windows-Plattformen verfügbar.