Aracılığıyla paylaş

Set-Item

  • Başvuru
Modül:
Microsoft.PowerShell.Management

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-Itemkullanı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 *.txtbir 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ştirilemez
  • Constant: Diğer ad silinemez veya değiştirilemez
  • Private: Diğer ad yalnızca geçerli kapsamda kullanılabilir
  • AllScope: Diğer ad, oluşturulan tüm yeni kapsamlara kopyalanır
  • Unspecified: 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

Object

Öğenin yeni değerini temsil eden bir nesneyi bu cmdlet'e aktarabilirsiniz.

Çıkışlar

None

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

Object

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-Itemiçerir:

  • si

  • Set-Item , PowerShell FileSystem sağlayıcısı tarafından desteklenmez. Dosya sistemindeki öğelerin değerlerini değiştirmek için cmdlet'ini Set-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'ini New-Item kullanın.
    • Kayıt defteri değerlerindeki adları ve verileri değiştirmek için , Set-ItemPropertyve Rename-ItemProperty cmdlet'lerini kullanınNew-ItemProperty.

  • 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ın Get-PsProvider. Daha fazla bilgi için bkz . about_Providers.