Set-ItemProperty

Başvuru

Modül:: Microsoft.PowerShell.Management

Bir öğenin özelliğinin değerini oluşturur veya değiştirir.

Sözdizimi

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

Set-ItemProperty
   [-Path] <string[]>
   -InputObject <psobject>
   [-PassThru]
   [-Force]
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

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

Set-ItemProperty
   -LiteralPath <string[]>
   -InputObject <psobject>
   [-PassThru]
   [-Force]
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-ItemProperty
   [-Path] <string[]>
   [-Name] <string>
   [-Value] <Object>
   [-PassThru]
   [-Force]
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-Type <RegistryValueKind>]
   [<CommonParameters>]

Set-ItemProperty
   [-Path] <string[]>
   -InputObject <psobject>
   [-PassThru]
   [-Force]
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-Type <RegistryValueKind>]
   [<CommonParameters>]

Set-ItemProperty
   [-Name] <string>
   [-Value] <Object>
   -LiteralPath <string[]>
   [-PassThru]
   [-Force]
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-Type <RegistryValueKind>]
   [<CommonParameters>]

Set-ItemProperty
   -LiteralPath <string[]>
   -InputObject <psobject>
   [-PassThru]
   [-Force]
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-Type <RegistryValueKind>]
   [<CommonParameters>]

Description

Set-ItemProperty cmdlet'i, belirtilen öğenin özelliğinin değerini değiştirir. Cmdlet'ini kullanarak öğelerin özelliklerini oluşturabilir veya değiştirebilirsiniz. Örneğin, Set-ItemProperty kullanarak bir dosya nesnesinin IsReadOnly özelliğinin değerini $Trueolarak ayarlayabilirsiniz.

Kayıt defteri değerlerini ve verilerini oluşturmak ve değiştirmek için de Set-ItemProperty kullanırsınız. Örneğin, bir anahtara yeni bir kayıt defteri girdisi ekleyebilir ve değerini oluşturabilir veya değiştirebilirsiniz.

Örnekler

Örnek 1: Dosyanın özelliğini ayarlama

Bu komut, "final.doc" dosyasının IsReadOnly özelliğinin değerini "true" olarak ayarlar. Dosyayı belirtmek için Yol, özelliğin adını belirtmek için Ad ve yeni değeri belirtmek için Değer parametresini kullanır.

Dosya bir System.IO.FileInfo nesnesidir ve IsReadOnly yalnızca özelliklerinden biridir. Tüm özellikleri görmek için Get-Item C:\GroupFiles\final.doc | Get-Member -MemberType Propertyyazın.

$true otomatik değişkeni "TRUE" değerini temsil eder. Daha fazla bilgi için bkz. about_Automatic_Variables.

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

Örnek 2: Kayıt defteri girdisi ve değeri oluşturma

Bu örnekte, yeni bir kayıt defteri girdisi oluşturmak ve girdiye bir değer atamak için Set-ItemProperty nasıl kullanılacağı gösterilmektedir. HKLM\Software anahtarında "ContosoCompany" anahtarında "NoOfEmployees" girişini oluşturur ve değerini 823 olarak ayarlar.

Kayıt defteri girdileri, kayıt defteri anahtarlarının öğe olan özellikleri olarak kabul edildiğinden, kayıt defteri girdileri oluşturmak ve değerlerini oluşturmak ve değiştirmek için Set-ItemProperty kullanırsınız.

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

İlk komut kayıt defteri girdisini oluşturur. HKLM: sürücüsünün yolunu ve Software\MyCompany anahtarını belirtmek için Yol kullanır. Komut, girdi adını belirtmek için Ad ve değer belirtmek için Değer kullanır.

İkinci komut, yeni kayıt defteri girdisini görmek için Get-ItemProperty cmdlet'ini kullanır. Get-Item veya Get-ChildItem cmdlet'lerini kullanırsanız, girdiler öğeler veya alt öğeler değil, bir anahtarın özellikleri olduğundan görünmez.

Üçüncü komut, NoOfEmployees girişinin değerini 824 olarak değiştirir.

Ayrıca New-ItemProperty cmdlet'ini kullanarak kayıt defteri girdisini ve değerini oluşturabilir ve ardından değeri değiştirmek için Set-ItemProperty kullanabilirsiniz.

HKLM: sürücüsü hakkında daha fazla bilgi için Get-Help Get-PSDriveyazın. Kayıt defterini yönetmek için PowerShell'i kullanma hakkında daha fazla bilgi için Get-Help Registryyazın.

Örnek 3: İşlem hattını kullanarak bir öğeyi değiştirme

Örnek, weekly.txt dosyasını almak için Get-ChildItem kullanır. Dosya nesnesi, Set-ItemPropertyöğesine yöneltilir. Set-ItemProperty komutu, özelliği ve yeni değerini belirtmek için Name ve Value parametrelerini kullanır.

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

Parametreler

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Tür:	SwitchParameter
Diğer adlar:	cf
Position:	Named
Default value:	False
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Credential

Not

Bu parametre, PowerShell ile yüklenen hiçbir sağlayıcı tarafından desteklenmez. Başka bir kullanıcının kimliğine bürünmek veya bu cmdlet'i çalıştırırken kimlik bilgilerinizi yükseltmek için Invoke-Commandkullanın.

Tür:	PSCredential
Position:	Named
Default value:	Current user
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-Exclude

Dize dizisi olarak, bu cmdlet'in işlemde hariç tutulduğu öğeyi veya öğeleri belirtir. Bu parametrenin değeri, Path parametresini niteler. *.txtgibi bir yol öğesi veya deseni girin. Joker karakterlere izin verilir. Exclude parametresi, yalnızca komut C:\Windows\*gibi bir öğenin içeriğini içerdiğinde geçerlidir; burada joker karakter C:\Windows dizininin içeriğini belirtir.

Tür:	String[]
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	True

-Filter

Path parametresini nitelemek için bir filtre belirtir. FileSystem sağlayıcısı, filtrelerin kullanımını destekleyen tek yüklü PowerShell sağlayıcısıdır. FileSystem filtre dilinin söz dizimini about_Wildcardsbulabilirsiniz. Filtreler diğer parametrelerden daha verimlidir, çünkü sağlayıcı, nesneleri aldıktan sonra PowerShell'in filtrelemesini yapmak yerine cmdlet nesneleri aldığında bunları uygular.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	True

-Force

Cmdlet'i, kullanıcı tarafından başka türlü erişilemeyen öğelerde bir özellik ayarlamaya zorlar. Uygulama sağlayıcıya göre değişir. Daha fazla bilgi için bkz. about_Providers.

Tür:	SwitchParameter
Position:	Named
Default value:	False
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Include

Dize dizisi olarak, bu cmdlet'in işleme dahil olduğu öğeyi veya öğeleri belirtir. Bu parametrenin değeri, Path parametresini niteler. "*.txt"gibi bir yol öğesi veya deseni girin. Joker karakterlere izin verilir. Include parametresi, yalnızca komut C:\Windows\*gibi bir öğenin içeriğini içerdiğinde ve joker karakteri C:\Windows dizininin içeriğini belirttiğinde etkilidir.

Tür:	String[]
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	True

-InputObject

Bu cmdlet'in değiştirdiği özelliklere sahip nesneyi belirtir. Nesneyi içeren bir değişken veya nesneyi alan bir komut girin.

Tür:	PSObject
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-LiteralPath

Bir veya daha fazla konumun yolunu belirtir. LiteralPath değeri tam olarak yazıldığı gibi kullanılır. Hiçbir karakter joker karakter olarak yorumlanmamıştır. Yol kaçış karakterleri içeriyorsa, tek tırnak içine alın. Tek tırnak işaretleri PowerShell'e hiçbir karakteri kaçış dizisi olarak yorumlamaması gerektiğini söyler.

Daha fazla bilgi için bkz. about_Quoting_Rules.

Tür:	String[]
Diğer adlar:	PSPath, LP
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-Name

Özelliğin adını belirtir.

Tür:	String
Diğer adlar:	PSProperty
Position:	1
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-PassThru

Item özelliğini temsil eden bir nesne döndürür. Varsayılan olarak, bu cmdlet herhangi bir çıkış oluşturmaz.

Tür:	SwitchParameter
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Path

Değiştirileceği özelliği olan öğelerin yolunu belirtir. Joker karakterlere izin verilir.

Tür:	String[]
Position:	0
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	True

-Type

Bu, Kayıt Defteri sağlayıcısı tarafından sağlanan dinamik bir parametredir. Kayıt Defteri sağlayıcısı ve bu parametre yalnızca Windows'ta kullanılabilir.

Bu cmdlet'in eklediği özellik türünü belirtir. Bu parametre için kabul edilebilir değerler şunlardır:

String: Null olarak sonlandırılan bir dize belirtir. REG_SZ değerler için kullanılır.
ExpandString: Değer alındığında genişletilen ortam değişkenlerine açıklanmamış başvurular içeren null olarak sonlandırılan bir dize belirtir. REG_EXPAND_SZ değerler için kullanılır.
Binary: İkili verileri herhangi bir biçimde belirtir. REG_BINARY değerler için kullanılır.
DWord: 32 bit ikili sayı belirtir. REG_DWORD değerleri için kullanılır.
MultiString: İki null karakterle sonlandırılan null olarak sonlandırılan dize dizisini belirtir. REG_MULTI_SZ değerleri için kullanılır.
Qword: 64 bit ikili sayı belirtir. REG_QWORD değerleri için kullanılır.
Unknown: REG_RESOURCE_LIST değerleri gibi desteklenmeyen bir kayıt defteri veri türünü gösterir.

Tür:	RegistryValueKind
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-Value

özelliğinin değerini belirtir.

Tür:	Object
Position:	2
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-WhatIf

Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Tür:	SwitchParameter
Diğer adlar:	wi
Position:	Named
Default value:	False
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

Girişler

PSObject

Nesneleri bu cmdlet'e yöneltebilirsiniz.

Çıkışlar

None

Varsayılan olarak, bu cmdlet çıkış döndürmez.

PSCustomObject

PassThru parametresini kullandığınızda, bu cmdlet değiştirilen öğeyi ve yeni özellik değerini temsil eden bir PSCustomObject nesnesi döndürür.

Notlar

PowerShell, Set-ItemPropertyiçin aşağıdaki diğer adları içerir:

Tüm platformlar:
- sp

Set-ItemProperty, herhangi bir sağlayıcı tarafından sunulan verilerle çalışacak şekilde tasarlanmıştır. Oturumunuzda kullanılabilen sağlayıcıları listelemek için Get-PSProvideryazın. Daha fazla bilgi için bkz. about_Providers.