Set-Item

Başvuru

Modül:: Microsoft.PowerShell.Management

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'i, 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 "np" adında bir takma 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 yolu göstermeden önce zamanı görüntülemesi için 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, komut istemi işlevi için AllScope ve ReadOnly seçeneklerini ayarlar. Bu komut, 'nin Set-Item dinamik parametresini kullanır. Seçenekleri parametresi yalnızca Set-Item veya İşlev 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.

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özdizimini about_Wildcards'de 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. Cmdlet, Force parametresini kullanarak bile 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. "*.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

-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şareti 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, Alias ve Fonksiyon sağlayıcıları tarafından sağlanan dinamik bir parametredir. Daha fazla bilgi için bkz. about_Alias_Provider ve about_Function_Provider.

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

Geçerli değerler şunlardır:

None: Takma adın herhangi bir kısıtlaması yok (varsayılan değer)
ReadOnly: Diğer ad silinebilir ancak Zorla parametresi kullanılmadıkça değiştirilemez.
Constant: Bu diğer ad silinemez ve değiştirilemez
Private: Diğer ad yalnızca mevcut kapsamda kullanılabilir
AllScope: Diğer ad, oluşturulan tüm yeni kapsamlara kopyalanır
Unspecified: 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'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: Her biri null karakterle sonlandırılmış ve iki null karakterle sona eren bir 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

Öğ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ı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

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.