Remove-WmiObject
Odstraní instanci existující třídy WMI (Windows Management Instrumentation).
Syntax
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>] Description
Rutina Remove-WmiObject odstraní instanci existující třídy WMI (Windows Management Instrumentation).
Příklady
Příklad 1: Zavření všech instancí procesu Win32
notepad
$np = Get-WmiObject -Query "select * from win32_process where name='notepad.exe'"
$np | Remove-WmiObjectTento příklad zavře všechny instance Poznámkový blok.exe.
První příkaz spustí instanci Poznámkový blok.
Druhý příkaz pomocí rutiny Get-WmiObject načte instance Win32_Process, které odpovídají Poznámkový blok.exe, a pak je uloží do $np proměnné.
Třetí příkaz předá objekt v proměnné $np Remove-WmiObject, která odstraní všechny instance Poznámkový blok.exe.
Příklad 2: Odstranění složky
Tento příkaz odstraní složku C:\Test.
$a = Get-WMIObject -Query "Select * From Win32_Directory Where Name ='C:\\Test'"
$a | Remove-WMIObjectPrvní příkaz použije Get-WMIObject k dotazování na C:\Test složku a pak uloží objekt do $a proměnné.
Druhý příkaz předá proměnnou $aRemove-WMIObject, která odstraní složku.
Parametry
-AsJob
Označuje, že tato rutina běží jako úloha na pozadí. Pomocí tohoto parametru můžete spouštět příkazy, které potrvá dlouhou dobu.
Nové rutiny CIM, zavedené prostředí Windows PowerShell 3.0, provádějí stejné úlohy jako rutiny rozhraní WMI. Rutiny CIM vyhovují standardům WS-Management (WSMan) a standardu CIM (Common Information Model), který umožňuje rutinám používat stejné techniky ke správě počítačů s operačním systémem Windows a těch, na kterých běží jiné operační systémy. Místo použití Remove-WmiObjectzvažte použití rutiny Remove-CimInstance.
Pokud použijete parametr AsJob , příkaz vrátí objekt, který představuje úlohu na pozadí a pak zobrazí příkazový řádek. Během dokončení úlohy můžete pokračovat v práci v relaci. Pokud Remove-WmiObject se používá proti vzdálenému počítači, úloha se vytvoří v místním počítači a výsledky ze vzdálených počítačů se automaticky vrátí do místního počítače. Ke správě úlohy použijte rutiny, které obsahují podstatné jméno úlohy (rutiny úlohy ). K získání výsledků úlohy použijte rutinu Receive-Job .
Chcete-li tento parametr použít pro vzdálené počítače, musí být místní a vzdálené počítače nakonfigurovány pro vzdálenou vzdálenou komunikace. Spusťte Windows PowerShell pomocí možnosti Spustit jako správce. Další informace najdete v tématu about_Remote_Requirements.
Další informace o úlohách na pozadí prostředí Windows PowerShell najdete v tématu about_Jobs a about_Remote_Jobs.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Authentication
Určuje úroveň ověřování, která se má použít pro připojení rozhraní WMI. Tento parametr přijímá tyto hodnoty:
-1:Nezměněn.0: Výchozí.1:Žádný. Neprovádělo se žádné ověřování.2: Připojení. Ověřování se provádí pouze v případech, kdy klient vytvoří relaci s aplikací.3:Volání. Ověřování se provádí pouze na začátku každého volání, když aplikace obdrží požadavek.4:Paket. Ověřování se provádí u všech dat přijatých z klienta.5: PacketIntegrity. Všechna data přenášená mezi klientem a aplikací se ověřují a ověřují.6: PacketPrivacy. Používají se vlastnosti ostatních úrovní ověřování a všechna data se šifrují.
| Type: | AuthenticationLevel |
| Accepted values: | Default, None, Connect, Call, Packet, PacketIntegrity, PacketPrivacy, Unchanged |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Authority
Určuje autoritu, která se má použít k ověření připojení rozhraní WMI. Můžete zadat standardní ověřování NTLM nebo Kerberos. Chcete-li použít protokol NTLM, nastavte nastavení autority na ntlmdomain:<DomainName, kde <DomainName>> identifikuje platný název domény NTLM. Pokud chcete použít Kerberos, zadejte kerberos:<DomainName>\<ServerName>. Nastavení autority nelze zahrnout při připojení k místnímu počítači.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Class
Určuje název třídy WMI, kterou tato rutina odstraní.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ComputerName
Určuje název počítače, na kterém se tato rutina spouští. Ve výchozím nastavení je to místní počítač.
Zadejte název NetBIOS, IP adresu nebo plně kvalifikovaný název domény jednoho nebo více počítačů. Chcete-li zadat místní počítač, zadejte název počítače, tečku (.) nebo localhost.
Tento parametr nespoléhá na vzdálené komunikace Windows PowerShellu. Parametr ComputerName můžete použít i v případě, že váš počítač není nakonfigurovaný tak, aby spouštět vzdálené příkazy.
| Type: | String[] |
| Aliases: | Cn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Před spuštěním rutiny zobrazí výzvu k potvrzení.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
Určuje uživatelský účet, který má oprávnění k provedení této akce. Ve výchozím nastavení je to aktuální uživatel.
Zadejte uživatelské jméno, například User01 nebo Domain01\User01, nebo zadejte objekt PSCredential , například objekt vygenerovaný rutinou Get-Credential . Pokud zadáte uživatelské jméno, tato rutina vás vyzve k zadání hesla.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableAllPrivileges
Označuje, že tato rutina povolí všechna oprávnění aktuálního uživatele před příkazem, který provede volání rozhraní WMI.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Impersonation
Určuje úroveň zosobnění, která se má použít. Tento parametr přijímá tyto hodnoty:
0: Výchozí. Přečte místní registr pro výchozí úroveň zosobnění, která je obvykle nastavená na 3: Zosobnění.1:Anonymní. Skryje přihlašovací údaje volajícího.2:Identifikovat. Umožňuje objektům dotazovat přihlašovací údaje volajícího.3:Zosobnit. Umožňuje objektům používat přihlašovací údaje volajícího.4:Delegát. Umožňuje objektům povolit, aby jiné objekty používaly přihlašovací údaje volajícího.
| Type: | ImpersonationLevel |
| Accepted values: | Default, Anonymous, Identify, Impersonate, Delegate |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
Určuje objekt ManagementObject , který se má použít jako vstup. Při použití tohoto parametru se ignorují všechny ostatní parametry.
| Type: | ManagementObject |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Locale
Určuje upřednostňované národní prostředí pro objekty WMI. Parametr národního prostředí je zadán jako pole ve formátu MS_<LCID> v upřednostňovaném pořadí.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Namespace
Určuje obor názvů úložiště rozhraní WMI, kde se při použití s parametrem Class nachází odkazovaná třída rozhraní WMI.
| Type: | String |
| Aliases: | NS |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Path
Určuje cestu objektu WMI třídy WMI nebo určuje cestu objektu WMI instance třídy WMI k odstranění.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ThrottleLimit
Určuje maximální počet souběžných připojení, která lze navázat pro spuštění tohoto příkazu. Tento parametr se používá společně s parametrem AsJob . Omezení se vztahuje pouze na aktuální příkaz, ne na relaci nebo na počítač.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Vstupy
Objekt pro správu můžete do této rutiny převést.
Výstupy
None, System.Management.Automation.RemotingJob
Tato rutina vrátí objekt úlohy, pokud zadáte parametr AsJob . Jinak nevygeneruje žádný výstup.
Poznámky
Windows PowerShell obsahuje následující aliasy pro Remove-WmiObject:
rwmi
Související odkazy
Váš názor
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu: https://aka.ms/ContentUserFeedback.
Odeslat a zobrazit názory pro