Remove-CimInstance

  • Odwołanie
Moduł:
CimCmdlets

Usuwa wystąpienie modelu CIM z komputera.

Składnia

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

Opis

To polecenie cmdlet jest dostępne tylko na platformie Windows.

To polecenie cmdlet usuwa wystąpienie modelu CIM z serwera CIM. Możesz określić wystąpienie modelu CIM do usunięcia przy użyciu obiektu wystąpienia modelu CIM pobranego Get-CimInstance przez polecenie cmdlet lub przez określenie zapytania.

Jeśli nie określono parametru InputObject , polecenie cmdlet działa w jeden z następujących sposobów:

  • Jeśli nie określono parametru ComputerName ani parametru CimSession , to polecenie cmdlet działa w lokalnej instrumentacji zarządzania Windows (WMI) przy użyciu sesji modelu obiektów składników (COM).
  • Jeśli określono parametr ComputerName lub parametr CimSession, to polecenie cmdlet działa względem serwera CIM określonego przez parametr ComputerName lub cimSession parametru.

Przykłady

Przykład 1. Usuwanie wystąpienia modelu CIM

W tym przykładzie użyto parametru Query , aby usunąć wystąpienia modelu CIM z klasy o nazwie Win32_Environment rozpoczynające się od ciągu znaków testvar .

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

Przykład 2. Usuwanie wystąpienia modelu CIM przy użyciu obiektu wystąpienia modelu CIM

W tym przykładzie są pobierane obiekty wystąpień modelu CIM filtrowane przez parametr Query i przechowują je w zmiennej o nazwie $var przy użyciu Get-CimInstance polecenia cmdlet . Zawartość zmiennej jest następnie przekazywana do Remove-CimInstance polecenia cmdlet, co powoduje usunięcie wystąpień modelu CIM.

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

Parametry

-CimSession

Uruchamia polecenie przy użyciu określonej sesji modelu CIM. Wprowadź zmienną zawierającą sesję modelu CIM lub polecenie, które tworzy lub pobiera sesję modelu CIM, na przykład New-CimSession polecenia cmdlet lub Get-CimSession . Aby uzyskać więcej informacji, zobacz about_CimSession.

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

-ComputerName

Określa nazwę komputera, na którym chcesz uruchomić operację CIM. Można określić w pełni kwalifikowaną nazwę domeny (FQDN) lub nazwę NetBIOS.

Jeśli określisz ten parametr, polecenie cmdlet utworzy sesję tymczasową na określonym komputerze przy użyciu protokołu WsMan.

Jeśli nie określisz tego parametru, polecenie cmdlet wykonuje operację na komputerze lokalnym przy użyciu modelu obiektów składników (COM).

Jeśli na tym samym komputerze jest wykonywanych wiele operacji, połączenie przy użyciu sesji modelu CIM zapewnia lepszą wydajność.

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

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

-InputObject

Określa obiekt wystąpienia modelu CIM, który ma zostać usunięty z serwera CIM. Obiekt przekazany do polecenia cmdlet nie jest zmieniany, tylko wystąpienie na serwerze CIM zostanie usunięte.

Parametr InputObject nie wylicza się w kolekcjach. Jeśli kolekcja zostanie przekazana, zostanie zgłoszony błąd. Podczas pracy z kolekcjami należy przekazać dane wejściowe w celu wyliczenia wartości.

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

-Namespace

Określa przestrzeń nazw dla operacji CIM. Domyślny obszar nazw jest root/cimv2. Za pomocą uzupełniania karty można przeglądać listę przestrzeni nazw, ponieważ program PowerShell pobiera listę przestrzeni nazw z lokalnego serwera WMI w celu udostępnienia listy przestrzeni nazw.

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

-OperationTimeoutSec

Określa czas oczekiwania polecenia cmdlet na odpowiedź z komputera. Domyślnie wartość tego parametru to 0, co oznacza, że polecenie cmdlet używa domyślnej wartości limitu czasu dla serwera.

Jeśli parametr OperationTimeoutSec jest ustawiony na wartość mniejszą niż limit czasu ponawiania próby niezawodnego połączenia przez 3 minuty, awarie sieci, które trwają dłużej niż wartość parametru OperationTimeoutSec, nie są możliwe do odzyskania, ponieważ operacja na serwerze przekracza limit czasu, zanim klient będzie mógł ponownie nawiązać połączenie.

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

-Query

Określa zapytanie do uruchomienia na serwerze CIM. Dialekt zapytania można określić przy użyciu parametru QueryDialect .

Jeśli określona wartość zawiera cudzysłowy podwójne ("), apostrofy (') lub ukośnik odwrotny (\), należy użyć tych znaków, prefiksując je znakiem ukośnika odwrotnego (\). Jeśli określona wartość używa operatora WQL LIKE , należy użyć następujących znaków, ujęcie ich w nawiasy kwadratowe ([]): procent (%), podkreślenie (_) lub otwierając nawias kwadratowy ([).

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

-QueryDialect

Określa język zapytań używany dla parametru Query. Dopuszczalne wartości tego parametru to: WQL lub CQL. Domyślna wartość to WQL.

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

-ResourceUri

Określa identyfikator URI (resource uniform resource identifier) klasy zasobów lub wystąpienia. Identyfikator URI służy do identyfikowania określonego typu zasobu, takiego jak dyski lub procesy, na komputerze.

Identyfikator URI składa się z prefiksu i ścieżki do zasobu. Na przykład:

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

Domyślnie, jeśli nie określisz tego parametru, jest używany standardowy identyfikator URI http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ zasobu DMTF, a nazwa klasy jest dołączana do niego.

Identyfikator ResourceURI może być używany tylko z sesjami modelu CIM utworzonymi przy użyciu protokołu WSMan lub podczas określania parametru ComputerName, który tworzy sesję modelu CIM przy użyciu narzędzia WSMan. Jeśli określisz ten parametr bez określenia parametru ComputerName lub jeśli określisz sesję modelu CIM utworzoną przy użyciu protokołu DCOM, wystąpi błąd, ponieważ protokół DCOM nie obsługuje parametru ResourceURI .

Jeśli określono zarówno parametr ResourceUri , jak i parametr Filter , parametr Filter zostanie zignorowany.

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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

Dane wejściowe

None

Nie można potokować obiektów do tego polecenia cmdlet.

Dane wyjściowe

None

To polecenie cmdlet nie zwraca żadnych danych wyjściowych.

Uwagi

Program PowerShell zawiera następujące aliasy dla programu Remove-CimInstance:

  • Windows:
    • rcim

To polecenie cmdlet jest dostępne tylko na platformach windows.