Elimina la proprietà e il relativo valore da un elemento.

Sintassi

Remove-ItemProperty [-LiteralPath] <string[]> [-Name] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]

Remove-ItemProperty [-Path] <string[]> [-Name] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]

Descrizione

Il cmdlet Remove-ItemProperty elimina una proprietà e il relativo valore da un elemento. È possibile utilizzare questo cmdlet per eliminare i valori del Registro di sistema e i dati in essi archiviati.

Parametri

-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" o "Dominio01\Utente01", o immettere un oggetto PSCredential, ad esempio uno generato dal cmdlet Get-Credential. Se si digita un nome utente, viene richiesta una password.

Questo parametro non è supportato dai provider installati con Windows PowerShell.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

true (ByPropertyName)

Accettare caratteri jolly?

false

-Exclude <string[]>

Omette gli elementi specificati. Il valore di questo parametro qualifica il parametro Path. Immettere un criterio o un elemento del percorso, ad esempio "*.txt". È consentito l'utilizzo di caratteri jolly.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-Filter <string>

Specifica un filtro nel formato o nel linguaggio del provider. Il valore di questo parametro qualifica il parametro Path. La sintassi del filtro, incluso l'utilizzo dei caratteri jolly, dipende dal provider. I filtri sono più efficienti rispetto ad altri parametri, perché il provider li applica al momento del recupero degli oggetti, anziché utilizzare Windows PowerShell per filtrare gli oggetti dopo il recupero.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-Force

Consente al cmdlet di rimuovere una proprietà di un oggetto altrimenti inaccessibile dall'utente. L'implementazione varia a seconda del provider. Per ulteriori informazioni, vedere about_Providers.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-Include <string[]>

Elimina unicamente gli elementi specificati. Il valore di questo parametro qualifica il parametro Path. Immettere un criterio o un elemento del percorso, ad esempio "*.txt". È consentito l'utilizzo di caratteri jolly.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-LiteralPath <string[]>

Specifica un percorso della proprietà dell'elemento. Il valore di LiteralPath viene utilizzato così come viene digitato. Nessun carattere viene interpretato come carattere jolly. Se il percorso include caratteri di escape, è necessario racchiuderli tra virgolette singole tramite le quali si comunica a Windows PowerShell di non interpretare alcun carattere come sequenza di escape.

Obbligatorio?

true

Posizione?

1

Valore predefinito

Accettare input da pipeline?

true (ByPropertyName)

Accettare caratteri jolly?

false

-Name <string[]>

Specifica i nomi delle proprietà da recuperare.

Obbligatorio?

true

Posizione?

2

Valore predefinito

Accettare input da pipeline?

true (ByPropertyName)

Accettare caratteri jolly?

false

-Path <string[]>

Specifica il percorso dell'elemento di cui vengono rimosse le proprietà. È consentito l'utilizzo di caratteri jolly.

Obbligatorio?

true

Posizione?

1

Valore predefinito

Accettare input da pipeline?

true (ByValue, ByPropertyName)

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

-UseTransaction

Include il comando nella transazione attiva. Questo parametro è valido solo quando è in corso una transazione. Per ulteriori informazioni, vedere about_Transactions.

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.String

È possibile reindirizzare una stringa che contiene un percorso (ma non un percorso letterale) a Remove-ItemProperty.

Output

Nessuno

Questo cmdlet non restituisce alcun output.

Note

È inoltre possibile fare riferimento a Remove-ItemProperty tramite il relativo alias predefinito "rp". Per ulteriori informazioni, vedere about_Alias.

Nel provider Registry di Windows PowerShell, i valori del Registro di sistema sono considerati proprietà di una chiave o sottochiave del Registro di sistema. È possibile utilizzare i cmdlet ItemProperty per gestire tali valori.

Il cmdlet Remove-ItemProperty è progettato per l'utilizzo di dati esposti da qualsiasi provider. Per elencare i provider disponibili nella sessione, digitare "Get-PSProvider". Per ulteriori informazioni, vedere about_Providers.

Esempio 1

C:\PS>remove-itemproperty -path HKLM:\Software\SmpApplication -name SmpProperty

Descrizione
-----------
Con questo comando viene eliminato il valore del Registro di sistema SmpProperty con i relativi dati dalla sottochiave SmpApplication della chiave del Registro di sistema HKEY_LOCAL_MACHINE\Software. 

Poiché è stato generato da un'unità (C:\PS>) del file system, il comando include il percorso completo della sottochiave SmpApplication, contenente l'unità, HKLM: e la chiave Software.

Viene utilizzato il parametro Name per identificare il valore del Registro di sistema che viene eliminato.

Esempio 2

C:\PS>set-location HKCU:\Software\MyCompany\MyApp

PS HKCU:\Software\MyCompany\MyApp> remove-itemproperty -path . -Name Options -confirm

Descrizione
-----------
Con questi comandi viene eliminato il valore Options del Registro di sistema con i relativi dati dalla sottochiave MyApp di HKEY_CURRENT_USER\Software\MyCompany.

Con il primo comando viene utilizzato il cmdlet Set-Location per impostare come percorso corrente l'unità HKEY_CURRENT_USER (HKCU:) e la sottochiave Software\MyCompany\MyApp.

Il secondo comando utilizza il cmdlet Remove-Item per rimuovere il valore Options del Registro di sistema con i relativi dati dalla sottochiave MyApp. Poiché il parametro Path è obbligatorio, il comando utilizza un punto (.) per indicare il percorso corrente. Viene utilizzato il parametro Name per specificare quale valore del Registro di sistema eliminare. Viene utilizzato il parametro Confirm per richiedere la conferma prima di eliminare il valore.

Esempio 3

C:\PS>get-item -path HKLM:\Software\MyCompany | remove-itemproperty -name NoOfEmployees

Descrizione
-----------
Con questo comando vengono eliminati il valore del Registro di sistema NoOfEmployees e i relativi dati dalla chiave del Registro di sistema HKLM\Software\MyCompany. 

Viene utilizzato il cmdlet Get-Item per ottenere un elemento che rappresenta la chiave del Registro di sistema. Viene utilizzato un operatore pipeline (|) per inviare l'oggetto al cmdlet Remove-ItemProperty. Viene quindi utilizzato il parametro Name di Remove-ItemProperty per specificare il nome del valore del Registro di sistema.

Vedere anche



Argomenti della Guida