Remove-WmiObject

Elimina un'istanza di una classe di Strumentazione gestione Windows (WMI) esistente.

Sintassi

Remove-WmiObject [-Classe] <string> [-Authentication {<Default> | <None> | <Connect> | <Call> | <Packet> | <PacketIntegrity> | <PacketPrivacy> | <Unchanged>}] [-Authority <string>] [-ComputerName <string[]>] [-Credential <PSCredential>] [-EnableAllPrivileges] [-Impersonation {<Default> | <Anonymous> | <Identify> | <Impersonate> | <Delegate>}] [-Locale <string>] [-Spazio dei nomi <string>] [-AsJob] [-ThrottleLimit <int>] [-Confirm] [-WhatIf] [<CommonParameters>]

Remove-WmiObject [-Authentication {<Default> | <None> | <Connect> | <Call> | <Packet> | <PacketIntegrity> | <PacketPrivacy> | <Unchanged>}] [-Authority <string>] [-ComputerName <string[]>] [-Credential <PSCredential>] [-EnableAllPrivileges] [-Impersonation {<Default> | <Anonymous> | <Identify> | <Impersonate> | <Delegate>}] [-Locale <string>] [-Spazio dei nomi <string>] [-AsJob] [-ThrottleLimit <int>] [-Confirm] [-WhatIf] [<CommonParameters>]

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

Remove-WmiObject -Path <string> [-Authentication {<Default> | <None> | <Connect> | <Call> | <Packet> | <PacketIntegrity> | <PacketPrivacy> | <Unchanged>}] [-Authority <string>] [-ComputerName <string[]>] [-Credential <PSCredential>] [-EnableAllPrivileges] [-Impersonation {<Default> | <Anonymous> | <Identify> | <Impersonate> | <Delegate>}] [-Locale <string>] [-Spazio dei nomi <string>] [-AsJob] [-ThrottleLimit <int>] [-Confirm] [-WhatIf] [<CommonParameters>]

Remove-WmiObject [-Authentication {<Default> | <None> | <Connect> | <Call> | <Packet> | <PacketIntegrity> | <PacketPrivacy> | <Unchanged>}] [-Authority <string>] [-ComputerName <string[]>] [-Credential <PSCredential>] [-EnableAllPrivileges] [-Impersonation {<Default> | <Anonymous> | <Identify> | <Impersonate> | <Delegate>}] [-Locale <string>] [-Spazio dei nomi <string>] [-AsJob] [-ThrottleLimit <int>] [-Confirm] [-WhatIf] [<CommonParameters>]

Remove-WmiObject [-Authentication {<Default> | <None> | <Connect> | <Call> | <Packet> | <PacketIntegrity> | <PacketPrivacy> | <Unchanged>}] [-Authority <string>] [-ComputerName <string[]>] [-Credential <PSCredential>] [-EnableAllPrivileges] [-Impersonation {<Default> | <Anonymous> | <Identify> | <Impersonate> | <Delegate>}] [-Locale <string>] [-Spazio dei nomi <string>] [-AsJob] [-ThrottleLimit <int>] [-Confirm] [-WhatIf] [<CommonParameters>]

Descrizione

Il cmdlet Remove-WmiObject consente di eliminare una classe WMI esistente.

Parametri

-AsJob

Esegue il comando come processo in background. Utilizzare questo parametro per eseguire comandi il cui completamento richiede molto tempo.

Esegue il comando come processo in background. Utilizzare questo parametro per eseguire comandi il cui completamento richiede molto tempo.

Quando si utilizza il parametro AsJob, il comando restituisce un oggetto che rappresenta il processo in background, quindi visualizza il prompt dei comandi. È possibile continuare a utilizzare la sessione fino al completamento del processo. Se Remove-WmiObject viene utilizzato per un computer remoto, il processo viene creato nel computer locale e i risultati dei computer remoti vengono automaticamente restituiti nel computer locale. Per gestire il processo, utilizzare i cmdlet che contengono il nome Job (cmdlet Job). Per ottenere i risultati del processo, utilizzare il cmdlet Receive-Job.

Nota: per utilizzare questo parametro con computer remoti, è necessario configurare i computer locale e remoto per la comunicazione remota. È inoltre necessario avviare Windows PowerShell utilizzando l'opzione "Esegui come amministratore" di Windows Vista e delle versioni successive di Windows. Per ulteriori informazioni, vedere about_Remote_Requirements.

Per ulteriori informazioni sui processi in background di Windows PowerShell, vedere about_Jobs e about_Remote_Jobs.

Obbligatorio?	false
Posizione?	named
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-Authentication <AuthenticationLevel>

Specifica il livello di autenticazione da utilizzare con la connessione WMI. I valori validi sono:

-1: Unchanged

0: Default

1: None (non viene eseguita alcuna autenticazione).

2: Connect (l'autenticazione viene eseguita solo quando il client stabilisce una relazione con l'applicazione).

3: Call (l'autenticazione viene eseguita solo all'inizio di ogni chiamata quando l'applicazione riceve la richiesta).

4: Packet (l'autenticazione viene eseguita su tutti i dati ricevuti dal client).

5: PacketIntegrity (tutti i dati trasferiti tra il client e l'applicazione vengono autenticati e verificati).

6: PacketPrivacy (vengono utilizzate le proprietà degli altri livelli di autenticazione e tutti i dati vengono crittografati).

Obbligatorio?	false
Posizione?	named
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-Authority <string>

Specifica l'autorità da utilizzare per autenticare la connessione WMI. È possibile specificare l'autenticazione NTLM o Kerberos standard. Per utilizzare NTLM, impostare l'impostazione authority su "ntlmdomain:<NomeDominio>", dove <NomeDominio> identifica un nome di dominio NTLM valido. Per utilizzare Kerberos, specificare "kerberos:<NomeDominio>\<NomeServer>". Non è possibile includere l'impostazione authority quando ci si connette al computer locale.

Obbligatorio?	false
Posizione?	named
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-Classe <string>

Specifica il nome di una classe WMI che si desidera eliminare.

Obbligatorio?	true
Posizione?	1
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-ComputerName <string[]>

Specifica il computer in cui si desidera eseguire l'operazione di gestione. Il valore può essere un nome di dominio completo, un nome NetBIOS o un indirizzo IP. Utilizzare il nome del computer locale, localhost o un punto (.) per specificare il computer locale. Il valore predefinito è il computer locale. Quando il computer remoto si trova in un dominio diverso da quello dell'utente, è necessario utilizzare un nome di dominio completo. È possibile impostare il valore di questo parametro reindirizzando il valore al parametro.

Questo parametro non si basa sulla comunicazione remota di Windows PowerShell che utilizza WS-Management. È possibile utilizzare il parametro ComputerName di Get-WmiObject anche se il computer non è configurato per l'esecuzione di comandi remoti di WS-Management.

Obbligatorio?	false
Posizione?	named
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-Credential <PSCredential>

Specifica un account utente con autorizzazione per l'esecuzione di questa azione. Il valore predefinito è l'utente corrente. Digitare un nome utente, ad esempio "Utente01", "Dominio01\Utente01" o "Utente@Contoso.com". In alternativa, immettere un oggetto PSCredential, ad esempio quello restituito dal cmdlet Get-Credential. Quando si digita un nome utente, viene richiesta una password.

Obbligatorio?	false
Posizione?	named
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-EnableAllPrivileges

Abilita tutti i privilegi dell'utente corrente prima che il comando effettui la chiamata WMI.

Obbligatorio?	false
Posizione?	named
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-Impersonation <ImpersonationLevel>

Specifica il livello di rappresentazione da utilizzare. I valori validi sono:

0: Default (legge il Registro di sistema locale per il livello di rappresentazione predefinito, in genere impostato su "3: Impersonate").

1: Anonymous (nasconde le credenziali del chiamante).

2: Identify (consente agli oggetti di eseguire query delle credenziali del chiamante).

3: Impersonate (consente agli oggetti di utilizzare le credenziali del chiamante).

4: Delegate (consente agli oggetti di permettere ad altri oggetti di utilizzare le credenziali del chiamante).

Obbligatorio?	false
Posizione?	named
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-InputObject <ManagementObject>

Specifica un oggetto ManagementObject da utilizzare come input. Quando si utilizza questo parametro, tutti gli altri parametri vengono ignorati.

Obbligatorio?	true
Posizione?	named
Valore predefinito
Accettare input da pipeline?	true (ByValue)
Accettare caratteri jolly?	false

-Locale <string>

Specifica le impostazioni locali preferite per gli oggetti WMI. Il parametro Locale viene specificato come matrice nel formato MS_<LCID> nell'ordine preferito.

Obbligatorio?	false
Posizione?	named
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-Spazio dei nomi <string>

Quando viene utilizzato con il parametro Class, questo parametro specifica lo spazio dei nomi dell'archivio WMI in cui si trova la classe a cui si fa riferimento.

Obbligatorio?	false
Posizione?	named
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-Path <string>

Specifica il percorso dell'oggetto WMI di una classe o di un'istanza di una classe WMI da eliminare.

Obbligatorio?	true
Posizione?	named
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-ThrottleLimit <int>

Consente all'utente di specificare un valore di limitazione per il numero di operazioni WMI (Strumentazione gestione Windows) che è possibile eseguire contemporaneamente. Questo parametro viene utilizzato insieme al parametro AsJob. Il limite di velocità si applica solo al comando corrente, non alla sessione o al computer.

Obbligatorio?	false
Posizione?	named
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-Confirm

Chiede una conferma prima di eseguire il comando.

Obbligatorio?	false
Posizione?	named
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-WhatIf

Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.

Obbligatorio?	false
Posizione?	named
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

<CommonParameters>

Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.

Input e output

Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.

Input	System.Management.ManagementObject È possibile reindirizzare un oggetto di gestione a Remove-WmiObject.
Output	Nessuno o System.Management.Automation.RemotingJob Quando si utilizza il parametro AsJob, il cmdlet restituisce un oggetto processo. In caso contrario, non genera alcun output.

Esempio 1

C:\PS>notepad   
C:\PS> $np = get-wmiobject -query "select * from win32_process where name='notepad.exe'"
C:\PS> $np | remove-wmiobject

Descrizione
-----------
Con questo comando vengono chiuse tutte le istanze di Notepad.exe.

Con il primo comando viene avviata un'istanza del Blocco note. 

Con il secondo comando viene utilizzato il cmdlet Get-WmiObject per recuperare le istanze di Win32_Process che corrispondono a Notepad.exe e per archiviarle nella variabile di $np. 

Nel terzo comando viene passato l'oggetto della variabile $np al cmdlet Remove-WmiObject, che elimina tutte le istanze di Notepad.exe.

Esempio 2

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

Descrizione
-----------
Con questo comando viene eliminata la directory C:\Test.

Nel primo comando viene utilizzato il cmdlet Get-WMIObject per eseguire una query per la directory C:\Test, quindi viene archiviato l'oggetto nella variabile $a.

Nel secondo comando viene reindirizzata la variabile $a a Remove-WMIObject, che procede all'eliminazione della directory.

Vedere anche

Concetti

Get-WmiObject
Invoke-WmiMethod
Set-WmiInstance
Get-WSManInstance
Invoke-WSManAction
New-WSManInstance
Remove-WSManInstance