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

Tento příklad zavře všechny instance Notepad.exe.

První příkaz spustí instanci Poznámkového bloku.

Druhý příkaz pomocí rutiny Get-WmiObject načte instance Win32_Process, které odpovídají Notepad.exe, a pak je uloží do $np proměnné.

Třetí příkaz předá objekt v proměnné Remove-WmiObject$np , který odstraní všechny instance Notepad.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-WMIObject

První 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, představené Windows PowerShell 3.0, provádějí stejné úlohy jako rutiny 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.

Když 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á pro vzdálený počítač, ú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 ). Pokud chcete získat výsledky úlohy, použijte rutinu Receive-Job .

Chcete-li použít tento parametr pro vzdálené počítače, musí být místní a vzdálené počítače nakonfigurovány pro vzdálenou vzdálenou správu. 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 Windows PowerShell na pozadí najdete v tématu about_Jobs a about_Remote_Jobs.

Type:SwitchParameter
Position:Named
Default value:None
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: Beze změny.
  • 0: Výchozí.
  • 1: Žádný. Neprovádí se žádné ověřování.
  • 2: Připojit. Ověřování se provádí pouze v případech, kdy klient vytvoří relaci s aplikací.
  • 3: Zavolejte. 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 jsou zašifrovaná.
Type:AuthenticationLevel
Accepted values:Default, None, Connect, Call, Packet, PacketIntegrity, PacketPrivacy, Unchanged
Position:Named
Default value:None
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 Protokol Kerberos, zadejte kerberos:<DomainName\<ServerName>>. Nastavení autority nelze zahrnout při připojování k místnímu počítači.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Class

Určuje název třídy služby WMI, kterou tato rutina odstraní.

Type:String
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ComputerName

Určuje název počítače, na kterém se tato rutina spouští. Výchozí hodnotou je 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 Windows PowerShell vzdálené komunikace. Parametr ComputerName můžete použít i v případě, že počítač není nakonfigurovaný ke spouštění vzdálených příkazů.

Type:String[]
Aliases:Cn
Position:Named
Default value:None
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
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 jeden 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
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
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: Identifikace. Umožňuje objektům dotazovat přihlašovací údaje volajícího.
  • 3: Zosobnění. 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
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
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
Accept pipeline input:False
Accept wildcard characters:False

-Namespace

Určuje obor názvů úložiště služby WMI, kde se odkazovaná třída služby WMI nachází při použití s parametrem Class .

Type:String
Aliases:NS
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Path

Určuje cestu objektu WMI třídy služby WMI nebo určuje cestu objektu WMI instance třídy WMI k odstranění.

Type:String
Position:Named
Default value:None
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 . Limit omezení se vztahuje pouze na aktuální příkaz, ne na relaci nebo na počítač.

Type:Int32
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False

Vstupy

ManagementObject

Objekt správy můžete do této rutiny připojit.

Výstupy

None, System.Management.Automation.RemotingJob

Tato rutina vrátí objekt úlohy, pokud zadáte parametr AsJob . V opačném případě negeneruje žádný výstup.