Set-Item
Bir öğenin değerini komutta belirtilen değerle değiştirir.
Sözdizimi
Set-Item
[-Path] <String[]>
[[-Value] <Object>]
[-Force]
[-PassThru]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-Item
-LiteralPath <String[]>
[[-Value] <Object>]
[-Force]
[-PassThru]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-Item
[-Path] <string[]>
[[-Value] <Object>]
[-Force]
[-PassThru]
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-Options <ScopedItemOptions>]
[<CommonParameters>]
Set-Item
[[-Value] <Object>]
-LiteralPath <string[]>
[-Force]
[-PassThru]
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-Options <ScopedItemOptions>]
[<CommonParameters>]
Set-Item
[-Path] <string[]>
[[-Value] <Object>]
[-Force]
[-PassThru]
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-Type <RegistryValueKind>]
[<CommonParameters>]
Set-Item
[[-Value] <Object>]
-LiteralPath <string[]>
[-Force]
[-PassThru]
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-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 Administrator 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.
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-Command kullanı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. 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.
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_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.
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 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.
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. 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.
Tür: | String[] |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | 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.
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 |
-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ş
Tür: | ScopedItemOptions |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-PassThru
Öğeyi temsil eden bir nesneyi işlem hattına geçirir. Varsayılan olarak, bu cmdlet herhangi bir çıkış oluşturmaz.
Tür: | SwitchParameter |
Position: | Named |
Default value: | False |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Path
Öğelerin konumunun 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'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.
Tür: | RegistryValueKind |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-Value
Öğe için yeni bir değer belirtir.
Tür: | Object |
Position: | 1 |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-WhatIf
Cmdlet çalıştırılıyorsa 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
Öğ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
PowerShell için aşağıdaki diğer adları Set-Item
içerir:
Tüm platformlar:
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