Set-ItemProperty

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

Set-ItemProperty
    [-Path] <String[]>
    -InputObject <PSObject>
    [-PassThru]
    [-Force]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [-UseTransaction]
    [<CommonParameters>]

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

Set-ItemProperty
    -LiteralPath <String[]>
    -InputObject <PSObject>
    [-PassThru]
    [-Force]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [-UseTransaction]
    [<CommonParameters>]

Das cmdlet Set-ItemProperty ändert den Wert der Eigenschaft des angegebenen Elements. Mit dem Cmdlet können Sie die Eigenschaften von Elementen einrichten oder ändern. Sie können z. B. Set-ItemProperty verwenden, um den Wert der IsReadOnly-eigenschaft eines Dateiobjekts auf $Truefestzulegen.

Sie verwenden auch Set-ItemProperty, um Registrierungswerte und -daten zu erstellen und zu ändern. Sie können z. B. einem Schlüssel einen neuen Registrierungseintrag hinzufügen und dessen Wert einrichten oder ändern.

Mit diesem Befehl wird der Wert der IsReadOnly- eigenschaft der Datei "final.doc" auf "true" festgelegt. Es verwendet Path-, um die Datei anzugeben, Name, um den Namen der Eigenschaft anzugeben, und den Value Parameter, um den neuen Wert anzugeben.

Die Datei ist ein System.IO.FileInfo Objekt, und IsReadOnly ist nur eine seiner Eigenschaften. Geben Sie Get-Item C:\GroupFiles\final.doc | Get-Member -MemberType Propertyein, um alle Eigenschaften anzuzeigen.

Die $true automatische Variable stellt den Wert "TRUE" dar. Weitere Informationen finden Sie unter about_Automatic_Variables.

Set-ItemProperty -Path C:\GroupFiles\final.doc -Name IsReadOnly -Value $true

In diesem Beispiel wird gezeigt, wie Sie Set-ItemProperty verwenden, um einen neuen Registrierungseintrag zu erstellen und dem Eintrag einen Wert zuzuweisen. Es erstellt den Eintrag "NoOfEmployees" im Schlüssel "ContosoCompany" im Schlüssel "HKLM\Software" und legt dessen Wert auf 823 fest.

Da Registrierungseinträge als Eigenschaften der Registrierungsschlüssel gelten, bei denen es sich um Elemente handelt, verwenden Sie Set-ItemProperty zum Erstellen von Registrierungseinträgen und zum Einrichten und Ändern ihrer Werte.

Der erste Befehl erstellt den Registrierungseintrag. Er verwendet Pfad, um den Pfad des Laufwerks HKLM: und den Schlüssel "Software\MyCompany" anzugeben. Der Befehl verwendet Name, um den Eintragsnamen anzugeben, und Wert-, um einen Wert anzugeben.

Der zweite Befehl verwendet das cmdlet Get-ItemProperty, um den neuen Registrierungseintrag anzuzeigen. Wenn Sie die cmdlets Get-Item oder Get-ChildItem verwenden, werden die Einträge nicht angezeigt, da sie Eigenschaften eines Schlüssels sind, nicht elemente oder untergeordnete Elemente.

Der dritte Befehl ändert den Wert des NoOfEmployees Eintrag in 824.

Sie können auch das Cmdlet New-ItemProperty verwenden, um den Registrierungseintrag und dessen Wert zu erstellen, und dann Set-ItemProperty verwenden, um den Wert zu ändern.

Wenn Sie weitere Informationen zum HKLM: Laufwerk wünschen, geben Sie Get-Help Get-PSDriveein. Wenn Sie weitere Informationen zur Verwendung von PowerShell zum Verwalten der Registrierung verwenden möchten, geben Sie Get-Help Registryein.

Set-ItemProperty -Path "HKLM:\Software\ContosoCompany" -Name "NoOfEmployees" -Value 823
Get-ItemProperty -Path "HKLM:\Software\ContosoCompany"

PSPath        : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\software\contosocompany
PSParentPath  : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\software
PSChildName   : contosocompany
PSDrive       : HKLM
PSProvider    : Microsoft.PowerShell.Core\Registry
NoOfLocations : 2
NoOfEmployees : 823

Set-ItemProperty -Path "HKLM:\Software\ContosoCompany" -Name "NoOfEmployees" -Value 824
Get-ItemProperty -Path "HKLM:\Software\ContosoCompany"

PSPath        : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\software\contosocompany
PSParentPath  : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\software
PSChildName   : contosocompany
PSDrive       : HKLM
PSProvider    : Microsoft.PowerShell.Core\Registry
NoOfLocations : 2
NoOfEmployees : 824

Diese Befehle zeigen, wie ein Pipelineoperator (|) verwendet wird, um ein Element an Set-ItemPropertyzu senden.

Der erste Teil des Befehls dient Get-ChildItem zum Abrufen eines Objekts, das die Datei "Weekly.txt" darstellt. Der Befehl verwendet einen Pipelineoperator, um das Dateiobjekt an Set-ItemPropertyzu senden. Der befehl Set-ItemProperty verwendet den parameter Name und Value parameter, um die Eigenschaft und den neuen Wert anzugeben.

Dieser Befehl entspricht der Verwendung des InputObject-Parameters zum Angeben des Objekts, Get-ChildItem das abgerufen wird.

Get-ChildItem weekly.txt | Set-ItemProperty -Name IsReadOnly -Value $True

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Sie können Objekte an dieses Cmdlet weiterleiten.

Dieses Cmdlet generiert ein PSCustomObject-Objekt , das das geänderte Element und seinen neuen Eigenschaftswert darstellt, wenn Sie den PassThru-Parameter angeben. Andernfalls generiert dieses Cmdlet keine Ausgabe.

Set-ItemProperty ist für die Arbeit mit den daten konzipiert, die von jedem Anbieter verfügbar gemacht werden. Geben Sie Get-PSProviderein, um die in Ihrer Sitzung verfügbaren Anbieter auflisten zu können. Weitere Informationen finden Sie unter über_Anbieter.