Remove-ItemProperty
Elimina la proprietà e il relativo valore da un elemento.
Sintassi
Remove-ItemProperty
[-Path] <String[]>
[-Name] <String[]>
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>] Remove-ItemProperty
-LiteralPath <String[]>
[-Name] <String[]>
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>] Descrizione
Il Remove-ItemProperty cmdlet elimina una proprietà e il relativo valore da un elemento.
È possibile usarlo per eliminare i valori del Registro di sistema e i dati archiviati al loro interno.
Esempio
Esempio 1: Eliminare un valore del Registro di sistema
Questo comando elimina il valore del Registro di sistema "SmpProperty" e i relativi dati dalla sottochiave "SmpApplication" della chiave del Registro di sistema "HKEY_LOCAL_MACHINE\Software".
Poiché il comando viene eseguito da un'unità del file system (PS C:\>), include il percorso completo della sottochiave "SmpApplication", inclusa l'unità, HKLM:e la chiave "Software".
Usa il parametro Name per identificare il valore del Registro di sistema da eliminare.
Remove-ItemProperty -Path "HKLM:\Software\SmpApplication" -Name "SmpProperty"Esempio 2: Eliminare un valore del Registro di sistema dal percorso HKCU
Questi comandi eliminano il valore del Registro di sistema "Opzioni" e i relativi dati dalla sottochiave "MyApp" di "HKEY_CURRENT_USER\Software\MyCompany".
Il primo comando usa il Set-Location cmdlet per modificare il percorso corrente nell'unità HKEY_CURRENT_USER (HKCU:) e nella sottochiave "Software\MyCompany\MyApp".
Il secondo comando usa Remove-ItemProperty per rimuovere il valore del Registro di sistema "Opzioni" e i relativi dati dalla sottochiave "MyApp".
Poiché Path è obbligatorio, il comando usa un punto ('.') per indicare la posizione corrente.
Usa Name per specificare il valore del Registro di sistema da eliminare.
Usa il parametro Confirm per richiedere una richiesta dell'utente prima di eliminare il valore.
PS C:\> Set-Location HKCU:\Software\MyCompany\MyApp
PS HKCU:\Software\MyCompany\MyApp> Remove-ItemProperty -Path . -Name "Options" -ConfirmEsempio 3: Rimuovere un valore del Registro di sistema usando la pipeline
Questo comando elimina il valore del Registro di sistema "NoOfEmployees" e i relativi dati dalla chiave del Registro di sistema "HKLM\Software\MyCompany".
Il comando usa il Get-Item cmdlet per ottenere un elemento che rappresenta la chiave del Registro di sistema.
Usa un operatore pipeline (|) per inviare l'oggetto a Remove-ItemProperty.
Usa quindi il parametro Name di Remove-ItemProperty per specificare il nome del valore del Registro di sistema.
Get-Item -Path HKLM:\Software\MyCompany | Remove-ItemProperty -Name NoOfEmployeesParametri
-Confirm
Richiede conferma prima di eseguire il cmdlet.
| Tipo: | SwitchParameter |
| Alias: | cf |
| Posizione: | Named |
| Valore predefinito: | False |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Credential
Nota
Questo parametro non è supportato da alcun provider installato con PowerShell. Per rappresentare un altro utente o elevare le credenziali durante l'esecuzione di questo cmdlet, usare Invoke-Command.
| Tipo: | PSCredential |
| Posizione: | Named |
| Valore predefinito: | Current user |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-Exclude
Specifica gli elementi omessi da questo cmdlet. Il valore di questo parametro qualifica il parametro Path . Immettere un elemento o modello di percorso, ad esempio "*.txt". I caratteri jolly sono consentiti.
| Tipo: | String[] |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | True |
-Filter
Specifica un filtro nel formato o nella lingua del provider. Il valore di questo parametro qualifica il parametro Path .
La sintassi del filtro, incluso l'uso di caratteri jolly, dipende dal provider. I filtri sono più efficienti rispetto ad altri parametri, perché il provider li applica quando il cmdlet ottiene gli oggetti anziché filtrare gli oggetti dopo il recupero.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | True |
-Force
Forza il cmdlet a rimuovere una proprietà di un oggetto a cui non è possibile accedere in altro modo dall'utente. L'implementazione varia a seconda del provider. Per altre informazioni, vedere about_Providers.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | False |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Include
Specifica, come matrice di stringhe, un elemento o elementi inclusi nel cmdlet nell'operazione. Il valore di questo parametro qualifica il parametro Path . Immettere un elemento o modello di percorso, ad esempio "*.txt". I caratteri jolly sono consentiti.
| Tipo: | String[] |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | True |
-LiteralPath
Specifica il percorso della posizione corrente della proprietà. A differenza del parametro Path , il valore di LiteralPath viene usato esattamente come viene tipizzato. Nessun carattere viene interpretato come carattere jolly. Se il percorso include caratteri di escape, racchiuderlo tra virgolette singole. Le virgolette singole indicano a PowerShell di non interpretare alcun carattere come sequenze di escape.
| Tipo: | String[] |
| Alias: | PSPath |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-Name
Specifica i nomi delle proprietà da rimuovere. I caratteri jolly sono consentiti.
| Tipo: | String[] |
| Alias: | PSProperty |
| Posizione: | 1 |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | True |
-Path
Specifica il percorso dell'elemento le cui proprietà vengono rimosse. I caratteri jolly sono consentiti.
| Tipo: | String[] |
| Posizione: | 0 |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | True |
-UseTransaction
Include il comando nella transazione attiva. Questo parametro è valido solo quando è in corso una transazione. Per altre informazioni, vedere about_Transactions.
| Tipo: | SwitchParameter |
| Alias: | usetx |
| Posizione: | Named |
| Valore predefinito: | False |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-WhatIf
Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.
| Tipo: | SwitchParameter |
| Alias: | wi |
| Posizione: | Named |
| Valore predefinito: | False |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
Input
È possibile inviare tramite pipe una stringa contenente un percorso, ma non un percorso letterale, a questo cmdlet.
Output
None
Questo cmdlet non restituisce output.
Note
Windows PowerShell include gli alias seguenti per Remove-ItemProperty:
rp
Nel provider del Registro di sistema di PowerShell i valori del Registro di sistema vengono considerati proprietà di una chiave del Registro di sistema o di una sottochiave. È possibile usare i cmdlet ItemProperty per gestire questi valori.
Remove-ItemProperty è progettato per lavorare con i dati esposti da qualsiasi provider. Per elencare i provider disponibili nella sessione, digitare Get-PSProvider. Per altre informazioni, vedere about_Providers.
