Condividi tramite

Remove-ItemProperty

  • Riferimento
Modulo:
Microsoft.PowerShell.Management

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>]
      [-InformationAction <ActionPreference>]
      [-InformationVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-ItemProperty
      -LiteralPath <String[]>
      [-Name] <String[]>
      [-Force]
      [-Filter <String>]
      [-Include <String[]>]
      [-Exclude <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Descrizione

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

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.

Remove-ItemProperty -Path "HKLM:\Software\SmpApplication" -Name "SmpProperty"

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

Esempio 2: Eliminare un valore del Registro di sistema dal percorso HKCU

Questi comandi eliminano il valore del Registro di sistema "Options" e i relativi dati dalla sottochiave "MyApp" di "HKEY_CURRENT_USER\Software\MyCompany".

PS C:\> Set-Location HKCU:\Software\MyCompany\MyApp
PS HKCU:\Software\MyCompany\MyApp> Remove-ItemProperty -Path . -Name "Options" -Confirm

Il primo comando usa il cmdlet Set-Location 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é è necessario percorso, il comando usa un punto (.) per indicare la posizione corrente. Il parametro Confirm richiede una richiesta dell'utente prima di eliminare il valore.

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

Get-Item -Path HKLM:\Software\MyCompany | Remove-ItemProperty -Name NoOfEmployees

Il comando usa il cmdlet Get-Item 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.

Parametri

-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 quando si esegue 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, come matrice di stringhe, un elemento o elementi esclusi dal cmdlet nell'operazione. Il valore di questo parametro qualifica il parametro Path. Immettere un elemento o un modello di percorso, ad esempio *.txt. Sono consentiti caratteri jolly. Il parametro Exclude è effettivo solo quando il comando include il contenuto di un elemento, ad esempio C:\Windows\*, in cui il carattere jolly specifica il contenuto della directory C:\Windows.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

-Filter

Specifica un filtro per qualificare il parametro Path. Il provider di FileSystem è l'unico provider di PowerShell installato che supporta l'uso dei filtri. È possibile trovare la sintassi per il linguaggio di filtro FileSystem in about_Wildcards. 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 da provider a 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 un modello di percorso, ad esempio "*.txt". Sono consentiti caratteri jolly. Il parametro Includi è effettivo solo quando il comando include il contenuto di un elemento, ad esempio C:\Windows\*, in cui il carattere jolly specifica il contenuto della directory C:\Windows.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

-LiteralPath

Specifica un percorso per una o più posizioni. Il valore di LiteralPath viene usato esattamente come viene tipizzato. Nessun carattere viene interpretato come caratteri 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.

Per altre informazioni, vedere about_Quoting_Rules.

Tipo:String[]
Alias:PSPath, LP
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. Sono consentiti caratteri jolly.

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. Sono consentiti caratteri jolly.

Tipo:String[]
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:True

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. 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

String

È possibile inviare tramite pipe una stringa contenente un percorso, ma non un percorso letterale, a questo cmdlet.

Output

None

Questo cmdlet non restituisce alcun output.

Note

PowerShell include gli alias seguenti per Remove-ItemProperty:

  • Tutte le piattaforme:

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