Set-Item

Ändert den Wert eines Elements in den Wert, der im Befehl angegeben wird.

Syntax

Set-Item [-LiteralPath] <string[]> [[-Value] <Object>] [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]

Set-Item [-Path] <string[]> [[-Value] <Object>] [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]

Beschreibung

Mit dem Cmdlet "Set-Item" wird der Wert eines Elements (beispielsweise einer Variablen oder eines Registrierungsschlüssels) in den Wert geändert, der im Befehl angegeben wird.

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

Ermöglicht dem Cmdlet das Festlegen von Elementen, die anderweitig nicht geändert werden können, z. B. schreibgeschützte Aliase oder Variablen. Mit diesem Cmdlet können keine konstanten Aliase oder Variablen geändert werden. Die Implementierung unterscheidet sich bei den einzelnen Anbietern. Weitere Informationen finden Sie unter "about_Providers". Auch bei Verwendung des Force-Parameters kann das Cmdlet keine Sicherheitseinschränkungen außer Kraft setzen.

Erforderlich?	false
Position?	named
Standardwert
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-Include <string[]>

Ändert 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 einen Pfad zum Speicherort der neuen Elemente an. Im Gegensatz zu "Path" wird der Wert von "LiteralPath" 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

-PassThru

Übergibt ein Objekt, das das Element darstellt, an die Pipeline. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.

Erforderlich?	false
Position?	named
Standardwert
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-Path <string[]>

Gibt einen Pfad zum Speicherort der neuen Elemente an. Platzhalter sind zulässig.

Erforderlich?	true
Position?	1
Standardwert
Pipelineeingaben akzeptieren?	true (ByPropertyName)
Platzhalterzeichen akzeptieren?	false

-Value <Object>

Gibt einen neuen Wert für das Element an.

Erforderlich?	false
Position?	2
Standardwert
Pipelineeingaben akzeptieren?	true (ByValue, ByPropertyName)
Platzhalterzeichen akzeptieren?	false

-Confirm

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.Object Sie können ein Objekt, das den neuen Wert des Elements darstellt, über die Pipeline an Set-Item übergeben.
Ausgaben	Keiner oder ein Objekt, das das neue oder geänderte Element darstellt. Wenn Sie den Passthru-Parameter verwenden, generiert Set-Item ein Objekt, das das Element darstellt. Andernfalls wird von diesem Cmdlet keine Ausgabe generiert.

Hinweise

Sie können auch über den integrierten Alias "si" auf Set-Item verweisen. Weitere Informationen finden Sie unter "about_Aliases".

Das Cmdlet "Set-Item" wird vom Windows PowerShell-FileSystem-Anbieter nicht unterstützt. Ändern Sie die Werte von Elementen im Dateisystem mit Set-Content.

Auf den Registrierungslaufwerken "HKLM:" und "HKCU:" werden mit "Set-Item" die Daten im Wert "(Default)" des Registrierungsschlüssels geändert. Verwenden Sie New-Item und Rename-Item, um die Namen von Registrierungsschlüsseln zu erstellen und zu ändern. Um die Namen und Daten in Registrierungswerten zu ändern, verwenden Sie New-ItemProperty, Set-ItemProperty und Rename-ItemProperty.

Das Cmdlet "Set-Item" 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>set-item -path alias:np -value c:\windows\notepad.exe

Beschreibung
-----------
Mit diesem Befehl wird der Alias "np" für Editor erstellt.

Beispiel 2

C:\PS>set-item -path env:UserRole -value Administrator

Beschreibung
-----------
Dieser Befehl ändert den Wert der Umgebungsvariablen "UserRole" mit dem Cmdlet "Set-Item" in "Administrator".

Beispiel 3

C:\PS>set-item -path function:prompt -value {'PS '+ $(Get-Date -format t) + " " + $(Get-Location) + '> '}

Beschreibung
-----------
Dieser Befehl ändert mit dem Cmdlet "Set-Item" die prompt-Funktion so, dass vor dem Pfad die Uhrzeit angezeigt wird.

Beispiel 4

C:\PS>set-item -path function:prompt -options "AllScope,ReadOnly"

Beschreibung
-----------
Mit diesem Befehl werden die Optionen "AllScope" und "ReadOnly" für die Funktion "prompt" festgelegt. Dieser Befehl verwendet den dynamischen Options-Parameter des Cmdlets "Set-Item". Der Options-Parameter ist nur dann in Set-Item verfügbar, wenn er mit dem Alias- oder dem Function-Anbieter verwendet wird.

Siehe auch

Konzepte

about_Providers
Get-Item
New-Item
Remove-Item
Clear-Item
Invoke-Item
Rename-Item
Move-Item
Copy-Item