Remove-WmiObject

模組:

Microsoft.PowerShell.Management Module

刪除現有 Windows Management Instrumentation （WMI） 類別的實例。

語法

class (預設值)

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

object

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

path

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

WQLQuery

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

query

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

list

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

Description

Remove-WmiObject Cmdlet 會刪除現有 Windows Management Instrumentation （WMI） 類別的實例。

範例

範例 1：關閉 Win32 程式的所有實例

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

此範例會關閉 Notepad.exe的所有實例。

第一個命令會啟動記事本的實例。

第二個命令會使用 Get-WmiObject Cmdlet 來擷取對應至 Notepad.exe的Win32_Process實例，然後將它們儲存在 $np 變數中。

第三個命令會將 $np 變數中的 對象傳遞至 Remove-WmiObject，這會刪除 Notepad.exe的所有實例。

範例 2：刪除資料夾

此命令會刪除 C：\Test 資料夾。

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

第一個命令會使用 Get-WmiObject 來查詢 C:\Test 資料夾，然後將物件儲存在 $a 變數中。

第二個命令會使用管線將 $a 變數傳送至 Remove-WmiObject，這會刪除資料夾。

參數

-AsJob

表示此 Cmdlet 會以背景工作的形式執行。 使用此參數來執行需要很長的時間才能完成的命令。

新的 CIM Cmdlet 引進 Windows PowerShell 3.0，會執行與 WMI Cmdlet 相同的工作。 CIM Cmdlet 符合 WS-Management （WSMan） 標準和 Common Information Model （CIM） 標準，這可讓 Cmdlet 使用相同的技術來管理執行 Windows 操作系統的計算機，以及執行其他操作系統的計算機。 請考慮使用 Remove-CimInstance Cmdlet，而不是使用 Remove-WmiObject。

當您使用 AsJob 參數時，命令會傳回代表背景工作的物件，然後顯示命令提示字元。 您可以在作業完成時繼續在工作階段中工作。 如果 Remove-WmiObject 用於遠端電腦，則會在本機計算機上建立作業，而且遠端電腦的結果會自動傳回至本機計算機。 若要管理作業，請使用包含 Job 名詞的 Cmdlet（Job Cmdlet）。 若要取得作業結果，請使用 Receive-Job Cmdlet。

若要對遠端電腦使用此參數，必須設定本機和遠端計算機進行遠端處理。 使用 [以系統管理員身分執行] 選項啟動 Windows PowerShell。 如需詳細資訊，請參閱 about_Remote_Requirements。

如需 Windows PowerShell 背景工作的詳細資訊，請參閱 about_Jobs 和about_Remote_Jobs。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Authentication

指定要用於 WMI 連線的驗證層級。 此參數可接受的值為：

• -1：未變更。
• 0：預設值。
• 1：無。 中未執行驗證。
• 2：連線。 只有在用戶端與應用程式建立關聯性時，才會執行驗證。
• 3：呼叫。 只有在應用程式收到要求時，才會在每個呼叫開始時執行驗證。
• 4：封包。 驗證會在從用戶端接收的所有數據上執行。
• 5：PacketIntegrity。 用戶端與應用程式之間傳輸的所有數據都會經過驗證和驗證。
• 6：PacketPrivacy。 會使用其他驗證層級的屬性，並加密所有數據。

參數屬性

類型:	AuthenticationLevel
預設值:	None
接受的值:	Default, None, Connect, Call, Packet, PacketIntegrity, PacketPrivacy, Unchanged
支援萬用字元:	False
不要顯示:	False

參數集

class

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

path

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

WQLQuery

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

query

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

list

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Authority

指定要用來驗證 WMI 連線的授權單位。 您可以指定標準 NTLM 或 Kerberos 驗證。 若要使用 NTLM，請將授權單位設定設為 ntlmdomain：<DomainName>，其中 <DomainName> 識別有效的 NTLM 功能變數名稱。 若要使用 Kerberos，請指定 kerberos：<DomainName>\<ServerName>。 當您連線到本機計算機時，無法包含授權單位設定。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

class

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

path

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

WQLQuery

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

query

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

list

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Class

指定此 Cmdlet 刪除的 WMI 類別名稱。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

class

Position:	0
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ComputerName

指定此 Cmdlet 執行所在的電腦名稱。 預設值為本機電腦。

輸入 NetBIOS 名稱、IP 位址或一或多部電腦的完整功能變數名稱。 若要指定本機計算機，請輸入計算機名稱、點（.），或localhost。

此參數不依賴 Windows PowerShell 遠端處理。 即使您的電腦未設定為執行遠端命令，您也可以使用 ComputerName 參數。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	Cn

參數集

class

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

path

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

WQLQuery

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

query

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

list

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

參數屬性

類型:	SwitchParameter
預設值:	False
支援萬用字元:	False
不要顯示:	False
別名:	cf

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Credential

指定具有執行此動作許可權的用戶帳戶。 預設值為目前的使用者。

輸入使用者名稱，例如User01或Domain01\User01，或輸入 PSCredential 物件，例如 Get-Credential Cmdlet 所產生的使用者名稱。 如果您輸入使用者名稱，此 Cmdlet 會提示您輸入密碼。

參數屬性

類型:	PSCredential
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

class

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

path

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

WQLQuery

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

query

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

list

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-EnableAllPrivileges

表示此 Cmdlet 會在發出 WMI 呼叫的命令之前，啟用目前使用者的所有許可權。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

class

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

path

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

WQLQuery

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

query

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

list

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Impersonation

指定要使用的模擬層級。 此參數可接受的值為：

• 0：預設值。 讀取預設模擬層級的本機登錄，通常設定為3：模擬。
• 1：匿名。 隱藏呼叫端的認證。
• 2：識別。 允許物件查詢呼叫端的認證。
• 3：模擬。 允許物件使用呼叫端的認證。
• 4：委派。 允許物件將呼叫者的認證交由其他物件使用。

參數屬性

類型:	ImpersonationLevel
預設值:	None
接受的值:	Default, Anonymous, Identify, Impersonate, Delegate
支援萬用字元:	False
不要顯示:	False

參數集

class

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

path

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

WQLQuery

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

query

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

list

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-InputObject

指定要作為輸入的 ManagementObject 物件。 使用此參數時，會忽略所有其他參數。

參數屬性

類型:	ManagementObject
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

object

Position:	Named
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Locale

指定 WMI 物件的慣用地區設定。 Locale 參數是以慣用順序指定為 MS_<LCID> 格式的陣列。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

class

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

path

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

WQLQuery

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

query

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

list

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Namespace

指定當參考的 WMI 類別與 Class 參數搭配使用時，所參考的 WMI 存放庫命名空間。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	NS

參數集

class

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

path

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

WQLQuery

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

query

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

list

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Path

指定 WMI 類別的 WMI 物件路徑，或指定要刪除之 WMI 類別實例的 WMI 物件路徑。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

path

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ThrottleLimit

指定可以建立以執行此命令的並行連線數目上限。 此參數會與 AsJob 參數搭配使用。 節流限制僅適用於目前的命令，不適用於會話或計算機。

參數屬性

類型:	Int32
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 指令未執行。

參數屬性

類型:	SwitchParameter
預設值:	False
支援萬用字元:	False
不要顯示:	False
別名:	無線

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CommonParameters

此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。

輸入

ManagementObject

您可以使用管線將管理物件傳送至此 Cmdlet。

輸出

None, System.Management.Automation.RemotingJob

如果您指定 AsJob 參數，此 Cmdlet 會傳回作業物件。 否則，它不會產生任何輸出。

備註

Windows PowerShell 包含下列 Remove-WmiObject的別名：

• rwmi

相關連結

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