Remove-CimInstance
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 ciągłej integracji z serwera MODELU 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 parametr InputObject nie zostanie określony, 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 ciągu 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ąpienia modelu CIM filtrowane według parametru 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 ciągłej integracji, takie jak 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 ten parametr nie zostanie określony, polecenie cmdlet wykona operację na komputerze lokalnym przy użyciu modelu obiektów składników (COM).
Jeśli na tym samym komputerze jest wykonywanych wiele operacji, nawiązywanie połączenia przy użyciu sesji modelu ciągłej integracji 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 modelu CIM. Obiekt przekazany do polecenia cmdlet nie jest zmieniany, tylko wystąpienie na serwerze CIM jest usuwane.
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
. Możesz użyć uzupełniania kart, aby 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 3 minuty, błędy sieci, które trwają dłużej niż wartość parametru OperationTimeoutSec , nie można odzyskać, 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 MODELU 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ć ucieczki tych znaków, poprzedzając je znakiem ukośnika odwrotnego (\
). Jeśli określona wartość używa operatora WQLLIKE
, 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
. Wartość domyślna 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, zostanie użyty standardowy identyfikator URI http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/
zasobu DMTF i nazwa klasy zostanie dołączona do niego.
Identyfikator ResourceURI może być używany tylko z sesjami ciM utworzonymi przy użyciu protokołu WSMan lub podczas określania parametru ComputerName, który tworzy sesję modelu wspólnych informacji przy użyciu narzędzia WSMan. Jeśli określisz ten parametr bez określenia parametru ComputerName lub jeśli określisz sesję modelu ciągłej integracji 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 Remove-CimInstance
programu :
- W systemie Windows:
rcim
To polecenie cmdlet jest dostępne tylko na platformach Windows.