Löscht die Eigenschaft und deren Wert aus einem Element.
Syntax
Remove-ItemProperty [-LiteralPath] <string[]> [-Name] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-Bestätigung] [-WhatIf] [-UseTransaction] [<CommonParameters>] Remove-ItemProperty [-Path] <string[]> [-Name] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-Bestätigung] [-WhatIf] [-UseTransaction] [<CommonParameters>]
Beschreibung
Mit dem Cmdlet "Remove-ItemProperty" werden eine Eigenschaft und ihr Wert aus einem Element gelöscht. Damit können Sie Registrierungswerte und in diesen gespeicherte Daten löschen.
Parameter
-Credential <PSCredential>
Gibt ein Benutzerkonto an, das über die Berechtigung zum Ausführen dieser Aktion verfügt. Der Standardwert ist der aktuelle Benutzer.
Geben Sie einen Benutzernamen ein, z. B. "User01" oder "Domain01\User01", oder geben Sie ein PSCredential-Objekt ein, z. B. ein vom Cmdlet "Get-Credential" generiertes Objekt. Wenn Sie einen Benutzernamen eingeben, werden Sie zur Eingabe eines Kennworts aufgefordert.
Dieser Parameter wird nicht von mit Windows PowerShell installierten Anbietern unterstützt.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
true (ByPropertyName) |
|
Platzhalterzeichen akzeptieren? |
false |
-Exclude <string[]>
Lässt die angegebenen Elemente aus. Der Path-Parameter wird durch den Wert dieses Parameters qualifiziert. Geben Sie ein Pfadelement oder -muster wie "*.txt" ein. Platzhalter sind zulässig.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Filter <string>
Gibt einen Filter im Format oder in der Sprache des Anbieters an. Der Path-Parameter wird durch den Wert dieses Parameters qualifiziert. Die Syntax des Filters einschließlich der Verwendung von Platzhaltern ist vom Anbieter abhängig. Filter sind effizienter als andere Parameter, da sie beim Abrufen der Objekte vom Anbieter angewendet werden und die Objekte nicht erst nach dem Abrufen von Windows PowerShell gefiltert werden.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Force
Hiermit kann das Cmdlet eine Eigenschaft eines Objekts entfernen, auf das der Benutzer anderweitig nicht zugreifen kann. Die Implementierung unterscheidet sich bei den einzelnen Anbietern. Weitere Informationen finden Sie unter "about_Providers".
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Include <string[]>
Löscht nur die angegebenen Elemente. Der Path-Parameter wird durch den Wert dieses Parameters qualifiziert. Geben Sie ein Pfadelement oder -muster wie "*.txt" ein. Platzhalter sind zulässig.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-LiteralPath <string[]>
Gibt den Pfad zur Elementeigenschaft an. Der Wert von "LiteralPath" wird genau so verwendet, wie er eingegeben wurde. Es werden keine Zeichen als Platzhalter interpretiert. Wenn der Pfad Escapezeichen enthält, müssen Sie ihn in einfache Anführungszeichen einschließen. Einfache Anführungszeichen veranlassen Windows PowerShell, Zeichen nicht als Escapesequenzen zu interpretieren.
|
Erforderlich? |
true |
|
Position? |
1 |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
true (ByPropertyName) |
|
Platzhalterzeichen akzeptieren? |
false |
-Name <string[]>
Gibt die Namen der abzurufenden Eigenschaften an.
|
Erforderlich? |
true |
|
Position? |
2 |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
true (ByPropertyName) |
|
Platzhalterzeichen akzeptieren? |
false |
-Path <string[]>
Gibt den Pfad zum Element an, dessen Eigenschaften entfernt werden. Platzhalter sind zulässig.
|
Erforderlich? |
true |
|
Position? |
1 |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
true (ByValue, ByPropertyName) |
|
Platzhalterzeichen akzeptieren? |
false |
-Bestätigung
Fordert Sie vor der Ausführung des Befehls zur Bestätigung auf.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-WhatIf
Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-UseTransaction
Schließt den Befehl in die aktive Transaktion ein. Dieser Parameter ist nur gültig, wenn eine Transaktion ausgeführt wird. Weitere Informationen finden Sie unter "about_Transactions".
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
<CommonParameters>
Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.
Eingaben und Ausgaben
Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.
|
Eingaben |
System.String Sie können eine Zeichenfolge, die einen Pfad (jedoch keinen literalen Pfad) enthält, über die Pipeline an Remove-ItemProperty übergeben. |
|
Ausgaben |
None Dieses Cmdlet gibt keine Ausgabe zurück. |
Hinweise
Sie können auch über den integrierten Alias "rp" auf Remove-ItemProperty verweisen. Weitere Informationen finden Sie unter "about_Alias".
Im Windows PowerShell-Registry-Anbieter werden Registrierungswerte als Eigenschaften eines Registrierungsschlüssels bzw. -unterschlüssels angesehen. Mit dem Cmdlet "ItemProperty" können Sie diese Werte verwalten.
Das Cmdlet "Remove-ItemProperty" ist für die Verwendung mit Daten konzipiert, die von beliebigen Anbietern verfügbar gemacht werden. Um die in der Sitzung verfügbaren Anbieter aufzuführen, geben Sie "Get-PSProvider" ein. Weitere Informationen finden Sie unter "about_Providers".
Beispiel 1
C:\PS>remove-itemproperty -path HKLM:\Software\SmpApplication -name SmpProperty
Beschreibung
-----------
Mit diesem Befehl werden der Registrierungswert "SmpProperty" und dessen Daten aus dem Unterschlüssel "SmpApplication" des Registrierungsschlüssels "HKEY_LOCAL_MACHINE\Software" gelöscht.
Da der Befehl von einem Laufwerk des Dateisystems ("C:\PS>") ausgegeben wird, enthält er den vollqualifizierten Pfad zum Unterschlüssel "SmpApplication", einschließlich des Laufwerks "HKLM:" und des Schlüssels "Software".
Mit dem Name-Parameter wird der Registrierungswert angegeben, der gelöscht wird.
Beispiel 2
C:\PS>set-location HKCU:\Software\MyCompany\MyApp
PS HKCU:\Software\MyCompany\MyApp> remove-itemproperty -path . -Name Options -confirm
Beschreibung
-----------
Mit diesen Befehlen werden der Registrierungswert "Options" und seine Daten aus dem Unterschlüssel "MyApp" von "HKEY_CURRENT_USER\Software\MyCompany" gelöscht.
Im ersten Befehl wird der aktuelle Speicherort mit dem Cmdlet "Set-Location" in das Laufwerk "HKEY_CURRENT_USER" ("HKCU:") und den Unterschlüssel "Software\MyCompany\MyApp" geändert.
Im zweiten Befehl werden der Registrierungswert "Options" und dessen Daten mit dem Cmdlet "Remove-Item" aus dem Unterschlüssel "MyApp" entfernt. Da der Path-Parameter erforderlich ist, wird der aktuelle Speicherort im Befehl mit einem Punkt (.) angegeben. Mit dem Name-Parameter wird angegeben, welcher Registrierungswert gelöscht werden soll. Mit dem Confirm-Parameter wird festgelegt, dass Benutzer vor dem Löschen des Werts zur Bestätigung aufgefordert werden.
Beispiel 3
C:\PS>get-item -path HKLM:\Software\MyCompany | remove-itemproperty -name NoOfEmployees Beschreibung ----------- Dieser Befehl löscht den Registrierungswert "NoOfEmployees" und seine Daten aus dem Registrierungsschlüssel "HKLM\Software\MyCompany". Der Befehl ruft mit dem Cmdlet "Get-Item" ein Element ab, das den Registrierungsschlüssel darstellt. Das Objekt wird mit einem Pipelineoperator (|) an das Cmdlet "Remove-ItemProperty" gesendet. Dann wird mit dem Name-Parameter von Remove-ItemProperty der Name des Registrierungswerts angegeben.
Siehe auch