Clear-ItemProperty
Löscht den Wert einer Eigenschaft, löscht die Eigenschaft jedoch nicht.
Syntax
Clear-ItemProperty
[-Path] <String[]>
[-Name] <String>
[-PassThru]
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Clear-ItemProperty
-LiteralPath <String[]>
[-Name] <String>
[-PassThru]
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Das Clear-ItemProperty
Cmdlet löscht den Wert einer Eigenschaft, löscht jedoch die Eigenschaft nicht.
Mit diesem Cmdlet können Sie die Daten aus einem Registrierungswert löschen.
Beispiele
Beispiel 1: Löschen des Werts des Registrierungsschlüssels
Dieser Befehl löscht die Daten im Registrierungswert "Optionen" im Unterschlüssel "MyApp" von HKEY_LOCAL_MACHINE\Software\MyCompany
.
Clear-ItemProperty -Path "HKLM:\Software\MyCompany\MyApp" -Name "Options"
Parameter
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Hinweis
Dieser Parameter wird von anbietern, die mit PowerShell installiert sind, nicht unterstützt. Um einen anderen Benutzer zu imitieren oder Ihre Anmeldeinformationen beim Ausführen dieses Cmdlets zu erhöhen, verwenden Sie "Invoke-Command".
Type: | PSCredential |
Position: | Named |
Default value: | Current user |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Exclude
Gibt als Zeichenfolgenarray ein Element oder Elemente an, die dieses Cmdlet im Vorgang ausschließen. Der Wert dieses Parameters qualifiziert den Path-Parameter. Geben Sie ein Pfadelement oder Muster ein, z. B *.txt
. . Platzhalterzeichen sind zulässig. Der Parameter "Ausschließen " ist nur wirksam, wenn der Befehl den Inhalt eines Elements enthält, z C:\Windows\*
. B. wo das Wildcardzeichen den Inhalt des C:\Windows
Verzeichnisses angibt.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Filter
Gibt einen Filter an, um den Pfadparameter zu qualifizieren. Der FileSystem-Anbieter ist der einzige installierte PowerShell-Anbieter, der die Verwendung von Filtern unterstützt. Sie können die Syntax für die Dateisystemfiltersprache in about_Wildcards finden. Filter sind effizienter als andere Parameter, da der Anbieter sie anwendet, wenn das Cmdlet die Objekte abruft, anstatt powerShell nach dem Abrufen der Objekte zu filtern.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Force
Gibt an, dass dieses Cmdlet Eigenschaften aus Elementen löscht, auf die der Benutzer andernfalls nicht zugegriffen werden kann. Die Implementierung unterscheidet sich bei den einzelnen Anbietern. Weitere Informationen finden Sie unter about_Providers.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Include
Gibt als Zeichenfolgenarray ein Element oder Elemente an, die dieses Cmdlet im Vorgang enthält. Der Wert dieses Parameters qualifiziert den Path-Parameter. Geben Sie ein Pfadelement oder Muster ein, z. B "*.txt"
. . Platzhalterzeichen sind zulässig. Der Parameter "Einschließen " ist nur wirksam, wenn der Befehl den Inhalt eines Elements enthält, z C:\Windows\*
. B. wo das Wildcardzeichen den Inhalt des C:\Windows
Verzeichnisses angibt.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-LiteralPath
Gibt einen Pfad zu einem oder mehreren Speicherorten an. Der Wert von LiteralPath wird genau wie eingegeben verwendet. Es werden keine Zeichen als Platzhalter interpretiert. Wenn der Pfad Escapezeichen enthält, müssen Sie ihn in einfache Anführungszeichen einschließen. Einzelne Anführungszeichen weisen PowerShell darauf hin, keine Zeichen als Escapesequenzen zu interpretieren.
Weitere Informationen finden Sie unter about_Quoting_Rules.
Type: | String[] |
Aliases: | PSPath, LP |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Gibt den Namen der zu löschenden Eigenschaft an, beispielsweise den Namen eines Registrierungswerts. Platzhalterzeichen sind zulässig.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-PassThru
Gibt ein Objekt zurück, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Gibt den Pfad zu der Eigenschaft an, die gelöscht wird. Platzhalterzeichen sind zulässig.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-WhatIf
Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Eingaben
Sie können eine Pfadzeichenfolge an dieses Cmdlet weiterleiten.
Ausgaben
None or System.Management.Automation.PSCustomObject
Wenn Sie den PassThru-Parameter verwenden, wird ein PSCustomObject-Objekt generiert, Clear-ItemProperty
das die gelöschte Elementeigenschaft darstellt. Andernfalls wird von diesem Cmdlet keine Ausgabe generiert.
Hinweise
- Sie können die
Clear-ItemProperty
Daten in Registrierungswerten löschen, ohne den Wert zu löschen. Wenn der Datentyp des Werts %%amp;quot;Binär%%amp;quot; oder %%amp;quot;DWORD%%amp;quot; ist, wird der Wert durch das Löschen der Daten auf %%amp;quot;0%%amp;quot; festgelegt. Andernfalls ist der Wert leer. - Das
Clear-ItemProperty
Cmdlet ist so konzipiert, dass die Von jedem Anbieter verfügbar gemachten Daten verwendet werden. Geben SieGet-PSProvider
zum Auflisten der in Ihrer Sitzung verfügbaren Anbieter ein. Weitere Informationen finden Sie unter about_Providers.