Set-Item
Bir öğenin değerini komutta belirtilen değerle değiştirir.
Syntax
Set-Item
[-Path] <string[]>
[[-Value] <Object>]
[-Force]
[-PassThru]
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]
Set-Item
[[-Value] <Object>]
-LiteralPath <string[]>
[-Force]
[-PassThru]
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]
Set-Item
[-Path] <string[]>
[[-Value] <Object>]
[-Force]
[-PassThru]
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[-Options <ScopedItemOptions>]
[<CommonParameters>]
Set-Item
[[-Value] <Object>]
-LiteralPath <string[]>
[-Force]
[-PassThru]
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[-Options <ScopedItemOptions>]
[<CommonParameters>]
Set-Item
[-Path] <string[]>
[[-Value] <Object>]
[-Force]
[-PassThru]
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[-Type <RegistryValueKind>]
[<CommonParameters>]
Set-Item
[[-Value] <Object>]
-LiteralPath <string[]>
[-Force]
[-PassThru]
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[-Type <RegistryValueKind>]
[<CommonParameters>]
Description
Set-Item
Cmdlet, değişken veya kayıt defteri anahtarı gibi bir öğenin değerini komutta belirtilen değerle değiştirir.
Örnekler
Örnek 1: Diğer ad oluşturma
Bu komut, Not Defteri için bir np diğer adı oluşturur.
Set-Item -Path alias:np -Value "c:\windows\notepad.exe"
Örnek 2: Ortam değişkeninin değerini değiştirme
Bu komut UserRole ortam değişkeninin değerini Yönetici istrator olarak değiştirir.
Set-Item -Path env:UserRole -Value "Administrator"
Örnek 3: prompt işlevinizi değiştirme
Bu komut, prompt işlevini yoldan önceki zamanı görüntüleyebilecek şekilde değiştirir.
Set-Item -Path function:prompt -Value {'PS '+ (Get-Date -Format t) + " " + (Get-Location) + '> '}
Örnek 4: prompt işleviniz için seçenekleri ayarlama
Bu komut, prompt işlevi için AllScope ve ReadOnly seçeneklerini ayarlar.
Bu komut Options dinamik parametresini Set-Item
kullanır.
Options parametresi yalnızca Diğer Ad veya İşlev sağlayıcısıyla kullandığınızda kullanılabilirSet-Item
.
Set-Item -Path function:prompt -Options "AllScope,ReadOnly"
Parametreler
-Confirm
Cmdlet'i çalıştırmadan önce sizden onay ister.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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-Command kullanın.
Type: | PSCredential |
Position: | Named |
Default value: | Current user |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Exclude
Dize dizisi olarak, bu cmdlet'in işlemde hariç tutulduğu öğeyi veya öğeleri belirtir. Bu parametrenin değeri Path parametresini niteler. gibi *.txt
bir yol öğesi veya deseni girin. Joker karakterlere izin verilir. Exclude parametresi yalnızca komutu gibi C:\Windows\*
bir öğenin içeriğini içerdiğinde geçerlidir; burada joker karakter dizinin içeriğini C:\Windows
belirtir.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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_Wildcards bulabilirsiniz. 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Force
Cmdlet'i salt okunur diğer ad veya değişkenler gibi başka türlü değiştirilemeyen öğeleri ayarlamaya zorlar. Cmdlet sabit diğer adları veya değişkenleri değiştiremez. Uygulama sağlayıcıdan sağlayıcıya değişir. Daha fazla bilgi için bkz . about_Providers. Zorla parametresi kullanıldığında bile, cmdlet güvenlik kısıtlamalarını geçersiz kılamaz.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Include
Dize dizisi olarak, bu cmdlet'in işleme dahil olduğu öğeyi veya öğeleri belirtir. Bu parametrenin değeri Path parametresini niteler. gibi "*.txt"
bir yol öğesi veya deseni girin. Joker karakterlere izin verilir. Include parametresi yalnızca komutu gibi C:\Windows\*
bir öğenin içeriğini içerdiğinde geçerlidir; burada joker karakter dizinin içeriğini C:\Windows
belirtir.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-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.
Type: | String[] |
Aliases: | PSPath |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Options
Bu, Diğer Ad ve İşlev sağlayıcıları tarafından sağlanan dinamik bir parametredir. Daha fazla bilgi için bkz . about_Alias_Provider ve about_Function_Provider.
Diğer adın Options özelliğinin değerini belirtir.
Geçerli değerler:
None
: Diğer adın kısıtlaması yok (varsayılan değer)ReadOnly
: Diğer ad silinebilir ancak Zorla parametresi kullanılmadan değiştirilemezConstant
: Diğer ad silinemez veya değiştirilemezPrivate
: Diğer ad yalnızca geçerli kapsamda kullanılabilirAllScope
: Diğer ad, oluşturulan tüm yeni kapsamlara kopyalanırUnspecified
: Seçenek belirtilmemiş
Type: | ScopedItemOptions |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Öğeyi temsil eden bir nesneyi işlem hattına geçirir. Varsayılan olarak, bu cmdlet herhangi bir çıkış oluşturmaz.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Öğelerin konumunun yolunu belirtir. Joker karakterlere izin verilir.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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'da kullanılabilir.
Bu cmdlet'in eklediği özellik türünü belirtir. Bu parametrenin kabul edilebilir değerleri ş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 bir sayı belirtir. REG_DWORD değerleri için kullanılır.MultiString
: İki null karakterle sonlandırılan null sonlandırılmış dize dizisini belirtir. REG_MULTI_SZ değerler için kullanılır.Qword
: 64 bit ikili bir 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.
Type: | RegistryValueKind |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-UseTransaction
Komutunu etkin işleme ekler. Bu parametre yalnızca bir işlem devam ederken geçerlidir. Daha fazla bilgi için bkz . about_Transactions.
Type: | SwitchParameter |
Aliases: | usetx |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Value
Öğe için yeni bir değer belirtir.
Type: | Object |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Girişler
Öğenin yeni değerini temsil eden bir nesneyi bu cmdlet'e aktarabilirsiniz.
Çıkışlar
None
Varsayılan olarak, bu cmdlet çıkış döndürmez.
PassThru parametresini kullandığınızda, bu cmdlet öğeyi temsil eden bir nesne döndürür.
Notlar
Windows PowerShell için aşağıdaki diğer adları Set-Item
içerir:
si
Set-Item
, PowerShell FileSystem sağlayıcısı tarafından desteklenmez. Dosya sistemindeki öğelerin değerlerini değiştirmek için cmdlet'iniSet-Content
kullanın.ve kayıt defteri sürücülerinde,
HKLM:
HKCU:
Set-Item
kayıt defteri anahtarının (Varsayılan) değerindeki verileri değiştirir.- Kayıt defteri anahtarlarının adlarını oluşturmak ve değiştirmek için ve
Rename-Item
cmdlet'iniNew-Item
kullanın. - Kayıt defteri değerlerindeki adları ve verileri değiştirmek için ,
Set-ItemProperty
veRename-ItemProperty
cmdlet'lerini kullanınNew-ItemProperty
.
- Kayıt defteri anahtarlarının adlarını oluşturmak ve değiştirmek için ve
Set-Item
herhangi bir sağlayıcı tarafından kullanıma sunulan verilerle çalışacak şekilde tasarlanmıştır. Oturumunuzda kullanılabilen sağlayıcıları listelemek için yazınGet-PsProvider
. Daha fazla bilgi için bkz . about_Providers.
İlişkili Bağlantılar
PowerShell
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin