Set-Item (Microsoft.PowerShell.Management)

Set-Item

Modül:

Microsoft.PowerShell.Management

Bir öğenin değerini komutta belirtilen değere 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>]

Tanım

Set-Item cmdlet'i, değişken veya kayıt defteri anahtarı gibi bir öğenin değerini komutta belirtilen değere değiştirir.

Örnekler

Örnek 1: Takma ad oluşturma

Bu komut, Not Defteri için np takma adını oluşturur.

Set-Item -Path alias:np -Value "c:\windows\notepad.exe"

Örnek 2: Bir ortam değişkeninin değerini değiştirme

Bu komut, UserRole ortam değişkeninin değerini Yönetici olarak değiştirir.

Set-Item -Path env:UserRole -Value "Administrator"

Örnek 3: İstem işlevinizi değiştirin

Bu komut, bilgi istemi işlevini yoldan önceki zamanı görüntüleyecek şekilde değiştirir.

Set-Item -Path function:prompt -Value {'PS '+ (Get-Date -Format t) + " " + (Get-Location) + '> '}

Örnek 4: Bilgi istemi işleviniz için seçenekleri ayarlayın

Bu komut, bilgi istemi işlevi için AllScope ve ReadOnly seçeneklerini ayarlar. Bu komut, Set-Item'ın Seçenekler dinamik parametresini kullanır. Seçenekler parametresi, Set-Item'de yalnızca onu Alias veya Function sağlayıcısıyla kullandığınızda kullanılabilir.

Set-Item -Path function:prompt -Options "AllScope,ReadOnly"

Parametreler

-Confirm

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

Tip :

SwitchParameter

Takma adlar:

cf

Konum:

Adlandırılmış

Varsayılan değer:

False

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-Credential

Tip :

PSC kimlik bilgisi

Konum:

Adlandırılmış

Varsayılan değer:

Geçerli kullanıcı

Gerekli:

False

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-Exclude

Bu cmdlet'in işlemde hariç tuttuğu bir öğeyi veya öğeleri dize dizisi olarak belirtir. Bu parametrenin değeri Yol parametresini nitelendirir. *.txt gibi bir yol öğesi veya modeli girin. Joker karakterlere izin verilir. Hariç Tut parametresi yalnızca komut, C:\Windows\* gibi bir öğenin içeriğini içerdiğinde etkilidir; burada joker karakter, C:\Windows dizini.

Tip :

String[]

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

True

-Filter

Yol parametresini nitelendirecek bir filtre belirtir. FileSystem sağlayıcısı, filtre kullanımını destekleyen tek yüklü PowerShell sağlayıcısıdır. FileSystem filtre dilinin söz dizimini about_Wildcards'da bulabilirsiniz. Filtreler diğer parametrelerden daha etkilidir çünkü sağlayıcı, PowerShell'in nesneleri alındıktan sonra filtrelemesini sağlamak yerine cmdlet nesneleri aldığında bunları uygular.

Tip :

String

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

True

-Force

Cmdlet'i salt okunur takma ad veya değişkenler gibi başka şekilde değiştirilemeyecek öğeleri ayarlamaya zorlar. Cmdlet sabit takma 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. Force parametresi kullanılsa bile cmdlet güvenlik kısıtlamalarını geçersiz kılamaz.

Tip :

SwitchParameter

Konum:

Adlandırılmış

Varsayılan değer:

False

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-Include

Bu cmdlet'in işleme dahil ettiği bir öğeyi veya öğeleri dize dizisi olarak belirtir. Bu parametrenin değeri Yol parametresini nitelendirir. "*.txt" gibi bir yol öğesi veya modeli girin. Joker karakterlere izin verilir. Dahil Et parametresi yalnızca komut, C:\Windows\* gibi bir öğenin içeriğini içerdiğinde etkilidir; burada joker karakter, C:\Windows dizini.

Tip :

String[]

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

True

-LiteralPath

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

Daha fazla bilgi için bkz. about_Quoting_Rules.

Tip :

String[]

Takma adlar:

PSPath, LP

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

True

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-Options

Bu, Takma Ad ve İşlev sağlayıcıları tarafından kullanıma sunulan dinamik bir parametredir. Daha fazla bilgi için bkz. about_Alias_Provider ve about_Function_Provider.

Bir takma adın Seçenekler özelliğinin değerini belirtir.

Geçerli değerler şunlardır:

• Yok: Takma adın hiçbir kısıtlaması yoktur (varsayılan değer)
• ReadOnly: Takma ad silinebilir ancak Force parametresi kullanılmadan değiştirilemez
• Sabit: Takma ad silinemez veya değiştirilemez
• Özel: Takma ad yalnızca geçerli kapsamda kullanılabilir
• AllScope: Takma ad, oluşturulan tüm yeni kapsamlara kopyalanır
• Belirtilmemiş: Seçenek belirtilmedi

Tip :

Kapsamlı Öğe Seçenekleri

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-PassThru

Öğeyi temsil eden bir nesneyi ardışık düzene iletir. Varsayılan olarak bu cmdlet herhangi bir çıktı oluşturmaz.

Tip :

SwitchParameter

Konum:

Adlandırılmış

Varsayılan değer:

False

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-Path

Öğelerin konumunun yolunu belirtir. Joker karakterlere izin verilir.

Tip :

String[]

Konum:

0

Varsayılan değer:

None

Gerekli:

True

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

True

-Type

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

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

• Dize: Boş karakterle sonlandırılmış bir dizeyi belirtir. REG_SZ değerleri için kullanılır.
• ExpandString: Değer alındığında genişletilen ortam değişkenlerine genişletilmemiş başvurular içeren, boş karakterle sonlandırılmış bir dizeyi belirtir. REG_EXPAND_SZ değerleri için kullanılır.
• İkili: Herhangi bir biçimdeki ikili verileri belirtir. REG_BINARY değerleri için kullanılır.
• DWord: 32 bitlik ikili sayıyı belirtir. REG_DWORD değerleri için kullanılır.
• MultiString: İki boş karakterle sonlandırılmış, boş sonlandırılmış dizelerden oluşan bir diziyi belirtir. REG_MULTI_SZ değerleri için kullanılır.
• Qword: 64 bitlik ikili sayıyı belirtir. REG_QWORD değerleri için kullanılır.
• Bilinmiyor: REG_RESOURCE_LIST değerleri gibi desteklenmeyen bir kayıt defteri veri türünü belirtir.

Tip :

Kayıt Defteri Değeri Türü

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-Value

Öğe için yeni bir değer belirtir.

Tip :

Nesne

Konum:

1

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-WhatIf

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

Tip :

SwitchParameter

Takma adlar:

wi

Konum:

Adlandırılmış

Varsayılan değer:

False

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

Girişler

Nesne

Öğenin yeni değerini temsil eden bir nesneyi bu cmdlet'e yönlendirebilirsiniz.

Çıkışlar

Yok

Varsayılan olarak bu cmdlet hiçbir çıktı döndürmez.

Nesne

PassThru parametresini kullandığınızda bu cmdlet, öğeyi temsil eden bir nesne döndürür.

Notlar

PowerShell, Set-Item için aşağıdaki takma adları içerir:

• Tüm platformlar:

  si

• Set-Item, PowerShell Dosya Sistemi sağlayıcısı tarafından desteklenmiyor. Dosya sistemindeki öğelerin değerlerini değiştirmek için Set-Content cmdlet'ini kullanın.

• Kayıt defteri sürücülerinde, HKLM: ve HKCU:, Set-Item, bir 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 Yeni Öğe ve Öğeyi Yeniden Adlandır cmdlet'ini kullanın.
  • Kayıt defteri değerlerindeki adları ve verileri değiştirmek için New-ItemProperty, Set-ItemProperty ve Rename-ItemProperty cmdlet'lerini kullanın.

• Set-Item herhangi bir sağlayıcının açığa çıkardığı verilerle çalışacak şekilde tasarlanmıştır. Oturumunuzda mevcut olan sağlayıcıları listelemek için Get-PsProvider yazın. Daha fazla bilgi için bkz. about_Providers.