Remove-WmiObject

Moduł:

Microsoft.PowerShell.Management

Usuwa wystąpienie istniejącej klasy Instrumentacja zarządzania Windows (WMI).

Składnia

Remove-WmiObject
      [-Class] <String>
      [-AsJob]
      [-Impersonation <ImpersonationLevel>]
      [-Authentication <AuthenticationLevel>]
      [-Locale <String>]
      [-EnableAllPrivileges]
      [-Authority <String>]
      [-Credential <PSCredential>]
      [-ThrottleLimit <Int32>]
      [-ComputerName <String[]>]
      [-Namespace <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-WmiObject
      -InputObject <ManagementObject>
      [-AsJob]
      [-ThrottleLimit <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-WmiObject
      -Path <String>
      [-AsJob]
      [-Impersonation <ImpersonationLevel>]
      [-Authentication <AuthenticationLevel>]
      [-Locale <String>]
      [-EnableAllPrivileges]
      [-Authority <String>]
      [-Credential <PSCredential>]
      [-ThrottleLimit <Int32>]
      [-ComputerName <String[]>]
      [-Namespace <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-WmiObject
      [-AsJob]
      [-Impersonation <ImpersonationLevel>]
      [-Authentication <AuthenticationLevel>]
      [-Locale <String>]
      [-EnableAllPrivileges]
      [-Authority <String>]
      [-Credential <PSCredential>]
      [-ThrottleLimit <Int32>]
      [-ComputerName <String[]>]
      [-Namespace <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-WmiObject
      [-AsJob]
      [-Impersonation <ImpersonationLevel>]
      [-Authentication <AuthenticationLevel>]
      [-Locale <String>]
      [-EnableAllPrivileges]
      [-Authority <String>]
      [-Credential <PSCredential>]
      [-ThrottleLimit <Int32>]
      [-ComputerName <String[]>]
      [-Namespace <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-WmiObject
      [-AsJob]
      [-Impersonation <ImpersonationLevel>]
      [-Authentication <AuthenticationLevel>]
      [-Locale <String>]
      [-EnableAllPrivileges]
      [-Authority <String>]
      [-Credential <PSCredential>]
      [-ThrottleLimit <Int32>]
      [-ComputerName <String[]>]
      [-Namespace <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Opis

Polecenie Remove-WmiObject cmdlet usuwa wystąpienie istniejącej klasy Instrumentacja zarządzania Windows (WMI).

Przykłady

Przykład 1: Zamykanie wszystkich wystąpień procesu Win32

notepad
$np = Get-WmiObject -Query "select * from win32_process where name='notepad.exe'"
$np | Remove-WmiObject

Ten przykład zamyka wszystkie wystąpienia Notepad.exe.

Pierwsze polecenie uruchamia wystąpienie Notatnika.

Drugie polecenie używa polecenia cmdlet Get-WmiObject do pobierania wystąpień Win32_Process, które odpowiadają Notepad.exe, a następnie przechowuje je w zmiennej $np .

Trzecie polecenie przekazuje obiekt w zmiennej $np do Remove-WmiObject, która usuwa wszystkie wystąpienia Notepad.exe.

Przykład 2. Usuwanie folderu

To polecenie usuwa folder C:\Test.

$a = Get-WMIObject -Query "Select * From Win32_Directory Where Name ='C:\\Test'"
$a | Remove-WMIObject

Pierwsze polecenie używa Get-WMIObject polecenia do wykonywania zapytań dotyczących C:\Test folderu, a następnie przechowuje obiekt w zmiennej $a .

Drugie polecenie potokuje zmienną $a do Remove-WMIObject, która usuwa folder.

Parametry

-AsJob

Wskazuje, że to polecenie cmdlet jest uruchamiane jako zadanie w tle. Użyj tego parametru, aby uruchomić polecenia, które zajmują dużo czasu.

Nowe polecenia cmdlet ciM, wprowadzone w programie Windows PowerShell 3.0, wykonują te same zadania co polecenia cmdlet usługi WMI. Polecenia cmdlet modelu ciM są zgodne ze standardami WS-Management (WSMan) i standardem Common Information Model (CIM), co umożliwia poleceń cmdlet używanie tych samych technik do zarządzania komputerami z systemem operacyjnym Windows i innymi systemami operacyjnymi. Zamiast używać Remove-WmiObjectpolecenia , rozważ użycie polecenia cmdlet Remove-CimInstance.

Gdy używasz parametru AsJob , polecenie zwraca obiekt reprezentujący zadanie w tle, a następnie wyświetla wiersz polecenia. Możesz kontynuować pracę w sesji, gdy zadanie zostanie zakończone. Jeśli Remove-WmiObject jest używany na komputerze zdalnym, zadanie jest tworzone na komputerze lokalnym, a wyniki z komputerów zdalnych są automatycznie zwracane do komputera lokalnego. Aby zarządzać zadaniem, użyj poleceń cmdlet zawierających wartość noun zadania (polecenia cmdlet zadania). Aby uzyskać wyniki zadania, użyj Receive-Job polecenia cmdlet .

Aby użyć tego parametru dla komputerów zdalnych, należy skonfigurować komputery lokalne i zdalne na potrzeby komunikacji zdalnej. Uruchom program Windows PowerShell przy użyciu opcji Uruchom jako administrator. Aby uzyskać więcej informacji, zobacz about_Remote_Requirements.

Aby uzyskać więcej informacji na temat zadań w tle programu Windows PowerShell, zobacz about_Jobs i about_Remote_Jobs.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Authentication

Określa poziom uwierzytelniania, który ma być używany dla połączenia usługi WMI. Dopuszczalne wartości tego parametru to:

• -1:Niezmienione.
• 0: domyślnie
• 1:Żaden. Nie przeprowadzono uwierzytelniania.
• 2:Połączyć. Uwierzytelnianie jest wykonywane tylko wtedy, gdy klient ustanawia relację z aplikacją.
• 3:Nazwać. Uwierzytelnianie jest wykonywane tylko na początku każdego wywołania, gdy aplikacja odbiera żądanie.
• 4:Pakiet. Uwierzytelnianie jest wykonywane na wszystkich danych otrzymanych od klienta.
• 5: PacketIntegrity. Wszystkie dane przesyłane między klientem a aplikacją są uwierzytelniane i weryfikowane.
• 6: PacketPrivacy. Używane są właściwości innych poziomów uwierzytelniania, a wszystkie dane są szyfrowane.

Typ:	AuthenticationLevel
Dopuszczalne wartości:	Default, None, Connect, Call, Packet, PacketIntegrity, PacketPrivacy, Unchanged
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Authority

Określa urząd używany do uwierzytelniania połączenia usługi WMI. Można określić standardowe uwierzytelnianie NTLM lub Kerberos. Aby użyć protokołu NTLM, ustaw ustawienie urzędu na ntlmdomain:<DomainName, gdzie <DomainName>> identyfikuje prawidłową nazwę domeny NTLM. Aby użyć protokołu Kerberos, określ wartość kerberos:<DomainName\<ServerName>>. Nie można dołączyć ustawienia urzędu podczas nawiązywania połączenia z komputerem lokalnym.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Class

Określa nazwę klasy WMI, którą usuwa to polecenie cmdlet.

Typ:	String
Position:	0
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-ComputerName

Określa nazwę komputera, na którym jest uruchamiane to polecenie cmdlet. Wartość domyślna to komputer lokalny.

Wpisz nazwę NetBIOS, adres IP lub w pełni kwalifikowaną nazwę domeny jednego lub kilku komputerów. Aby określić komputer lokalny, wpisz nazwę komputera, kropkę (.) lub localhost.

Ten parametr nie opiera się na komunikacji zdalnej programu Windows PowerShell. Można użyć parametru ComputerName , nawet jeśli komputer nie jest skonfigurowany do uruchamiania poleceń zdalnych.

Typ:	String[]
Aliasy:	Cn
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:	SwitchParameter
Aliasy:	cf
Position:	Named
Domyślna wartość:	False
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Credential

Określa konto użytkownika, które ma uprawnienia do wykonania tej akcji. Wartość domyślna to użytkownik bieżący.

Wpisz nazwę użytkownika, taką jak User01 lub Domain01\User01, lub wprowadź obiekt PSCredential , taki jak jeden wygenerowany przez Get-Credential polecenie cmdlet. Jeśli wpiszesz nazwę użytkownika, to polecenie cmdlet wyświetli monit o podanie hasła.

Typ:	PSCredential
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-EnableAllPrivileges

Wskazuje, że to polecenie cmdlet włącza wszystkie uprawnienia bieżącego użytkownika przed wykonaniem wywołania usługi WMI.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Impersonation

Określa poziom personifikacji do użycia. Dopuszczalne wartości tego parametru to:

• 0: domyślnie Odczytuje rejestr lokalny dla domyślnego poziomu personifikacji, który jest zwykle ustawiony na 3: Personifikacja.
• 1:Anonimowy. Ukrywa poświadczenia obiektu wywołującego.
• 2:Identyfikować. Umożliwia obiektom wykonywanie zapytań dotyczących poświadczeń obiektu wywołującego.
• 3:Personifikować. Umożliwia obiektom używanie poświadczeń obiektu wywołującego.
• 4:Delegat. Umożliwia obiektom zezwolenie innym obiektom na używanie poświadczeń obiektu wywołującego.

Typ:	ImpersonationLevel
Dopuszczalne wartości:	Default, Anonymous, Identify, Impersonate, Delegate
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-InputObject

Określa obiekt ManagementObject , który ma być używany jako dane wejściowe. Gdy ten parametr jest używany, wszystkie inne parametry są ignorowane.

Typ:	ManagementObject
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-Locale

Określa preferowane ustawienia regionalne dla obiektów WMI. Parametr Ustawień regionalnych jest określany jako tablica w formacie MS_<LCID> w preferowanej kolejności.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Namespace

Określa przestrzeń nazw repozytorium WMI, w której znajduje się odwołana klasa WMI, gdy jest używana z parametrem Class .

Typ:	String
Aliasy:	NS
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Path

Określa ścieżkę obiektu WMI klasy WMI lub określa ścieżkę obiektu WMI wystąpienia klasy WMI do usunięcia.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-ThrottleLimit

Określa maksymalną liczbę połączeń współbieżnych, które można ustanowić w celu uruchomienia tego polecenia. Ten parametr jest używany razem z parametrem AsJob . Limit ograniczania ma zastosowanie tylko do bieżącego polecenia, a nie do sesji ani do komputera.

Typ:	Int32
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-WhatIf

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

Typ:	SwitchParameter
Aliasy:	wi
Position:	Named
Domyślna wartość:	False
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

Dane wejściowe

ManagementObject

Do tego polecenia cmdlet można przekazać obiekt zarządzania.

Dane wyjściowe

None, System.Management.Automation.RemotingJob

To polecenie cmdlet zwraca obiekt zadania, jeśli określisz parametr AsJob . W przeciwnym razie nie generuje żadnych danych wyjściowych.

Uwagi

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

• rwmi

Linki powiązane

• Get-WmiObject
• Invoke-WmiMethod
• Set-WmiInstance